Content
100%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Exemplary skill body: terse, non-obvious operational detail delivered as executable commands, tables, and schemas, with error-recovery feedback loops for every risky operation. Detail is correctly offloaded to three well-triggered, one-level-deep reference files that all exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, tool-specific facts only (PTY/TUI blocking, "`gh stack help <command>` does not work", exit-code semantics, stale `base` SHA meaning) and explains nothing Claude already knows. No trimmable over-explanation was found, so it fits the lean/every-token-earns-its-place anchor rather than the minor-trimming anchor. | 5 / 5 |
Actionability | Copy-paste-ready commands throughout: the core loop, the edit flow (`gh stack down` ... `rebase --upstack` ... `push`), `sync --prune`, and `merge 42 --yes --squash`, plus an always-run/never-run flag table, a JSON output schema, and a recovery column for every exit code. Fully executable and covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints ("`gh stack view --json` # confirm", "Check the exit status before changing directories", "branch on exit codes") and genuine feedback loops for error recovery (Exit 3 resolve → `git add` → `rebase --continue`/`--abort`, sync-divergence abort, lock retry). Destructive and batch operations all carry validation or recovery, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | The body stays an overview and delegates detail to three real, one-level-deep reference files (verified on disk: stack-design.md, commands.md, troubleshooting.md), each given an explicit trigger ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict") plus "no need to preload all three". Reference cross-links are sibling-level only, matching the clear-overview anchor. | 5 / 5 |
Total | 20 / 20 Passed |