promptdeck

Installation
SKILL.md

promptdeck

Prompt-experiment bookkeeping. promptdeck renders text and ranks scores you supply; it calls no model and computes no scores. Samples in examples/, flag and schema tables in references/REFERENCE.md.

Get the binary

brew install itamaker/tap/promptdeck, a release binary from github.com/itamaker/promptdeck-skill, or go build -o promptdeck . in a clone of that repo.

Bare promptdeck opens an interactive TUI that hangs an agent shell; always pass a subcommand. Builds after v0.3.0 answer promptdeck -h and promptdeck --version (exit 0), and promptdeck matrix -h lists the flags. With v0.3.0 these exit 2, which is expected: run promptdeck x (an invalid subcommand) for usage.

Experiment loop

promptdeck render   -template t.tmpl -vars vars.json [-out f]        # one prompt (object) or several joined by ---
promptdeck matrix   -template t.tmpl -matrix matrix.json -out-dir prompts -manifest manifest.json
# score every prompts/<index>.txt yourself, write scores.json: [{"index":"001","score":0.72,"notes":"..."}]
promptdeck optimize -template t.tmpl -matrix matrix.json -scores scores.json [-top N] [-out best.txt] [-json]
Installs
4
Repository
itamaker/skills
First Seen
Sep 29, 2026