Cursor plugin specification and official plugins
TypeScript
pstack: harden show-me-your-work log.sh (formula-injection + mkdir -p) and shorten skill descriptions (#79)
lauren11ecc12a3ffc
diff --git a/pstack/skills/figure-it-out/SKILL.md b/pstack/skills/figure-it-out/SKILL.mdindex b51ff34a..42f4d463 100644--- a/pstack/skills/figure-it-out/SKILL.md+++ b/pstack/skills/figure-it-out/SKILL.md@@ -1,6 +1,6 @@---name: figure-it-out-description: "Design a rigorous, auditable playbook for a task too large or cross-cutting for a single bundled playbook, or that no playbook fits: a migration across many call sites, an ambitious multi-part change, novel or ambiguous multi-phase work, or anything a human reviews after stepping away. Scales rigor to the task and biases toward more, runs a hypothesis-driven loop, and keeps a decision trail via show-me-your-work. Use for /figure-it-out, 'figure it out', a large migration, or when no narrower playbook is a good fit."+description: "Design an auditable playbook when no narrower one fits: a large migration, an ambitious multi-part change, or work a human reviews after stepping away. Scales rigor to the task, runs a hypothesis loop, and logs decisions via show-me-your-work. Use for /figure-it-out, 'figure it out', a large migration, or when no narrower playbook applies."disable-model-invocation: true---diff --git a/pstack/skills/show-me-your-work/SKILL.md b/pstack/skills/show-me-your-work/SKILL.mdindex 9f16f3e5..0b2f6c4f 100644--- a/pstack/skills/show-me-your-work/SKILL.md+++ b/pstack/skills/show-me-your-work/SKILL.md@@ -1,6 +1,6 @@---name: show-me-your-work-description: "Keep a reviewable decision trail for non-trivial, long-running, or unattended work. A TSV log with one row per decision (what, why, evidence, result). Kept local by default; commit it for ambitious, high-stakes work where a reviewer needs the trail to trust the result (a large port, a multi-week migration), where GitHub renders it as a table. Use for /show-me-your-work, autonomous or multi-phase runs, or work a human reviews after stepping away. Composed by figure-it-out, autonomous-run, and multi-phase plans."+description: "Keep a reviewable decision trail for long-running or unattended work: a TSV log with one row per decision (what, why, evidence, result). Local by default; commit it when a reviewer needs the trail to trust the result. Use for /show-me-your-work, autonomous or multi-phase runs, or work a human reviews after stepping away."disable-model-invocation: true---@@ -35,7 +35,7 @@ ts phase decision why evidence resultWrite each entry the way you'd tell a teammate what you did. Plain words, concrete actions, no AI speak or abstract jargon (the **unslop** skill applies to log text too). A reviewer should understand each row without decoding it.-Use the helper so rows stay well-formed: `scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>`. It stamps `ts`, writes the header on first use, and strips stray tabs. A bare `printf` appending a row works too.+Use the helper so rows stay well-formed: `scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>`. It stamps `ts`, writes the header on first use, strips stray tabs/newlines, and prefixes any cell starting with `=`, `+`, `-`, or `@` with a single quote so a reviewer opening the log in a spreadsheet doesn't trigger formula execution. A bare `printf` appending a row works too, but mind those same bytes if cells come from generated or user-supplied text.Log decision points and checkpoints, not every action: a fork chosen, a unit completed with its verification result, a pivot or revert with its trigger, a blocker surfaced, a gate fixed. For loop runs, one row per iteration. Skip the trivial and self-evident.diff --git a/pstack/skills/show-me-your-work/scripts/log.sh b/pstack/skills/show-me-your-work/scripts/log.shindex e0657b9e..523e2a74 100755--- a/pstack/skills/show-me-your-work/scripts/log.sh+++ b/pstack/skills/show-me-your-work/scripts/log.sh@@ -11,12 +11,30 @@ filogfile="$1"shift+logdir="$(dirname "$logfile")"+if [ -n "$logdir" ] && [ "$logdir" != "." ] && [ ! -d "$logdir" ]; then+ mkdir -p "$logdir"+fi+if [ ! -f "$logfile" ]; thenprintf 'ts\tphase\tdecision\twhy\tevidence\tresult\n' > "$logfile"fits="$(date -u +%Y-%m-%dT%H:%M:%SZ)"-clean() { printf '%s' "$1" | tr '\t\n' ' '; }+# Strip tabs/newlines/CR so cells stay on one line, and prefix any cell+# whose first char a spreadsheet would parse as a formula (=, +, -, @)+# with a single quote. The skill expects this log to be read in+# spreadsheets, so attacker-controlled evidence (PR titles, filenames,+# generated text) must not become formula execution when a reviewer+# opens the file.+clean() {+ local v+ v=$(printf '%s' "$1" | tr '\t\n\r' ' ')+ case "$v" in+ =*|+*|-*|@*) printf "'%s" "$v" ;;+ *) printf '%s' "$v" ;;+ esac+}printf '%s\t%s\t%s\t%s\t%s\t%s\n' \"$ts" "$(clean "$1")" "$(clean "$2")" "$(clean "$3")" "$(clean "$4")" "$(clean "$5")" \>> "$logfile"