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]