Content
96%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.
Excellent operational content: executable commands, validated multi-step workflows, and tool-specific error-recovery guidance with no filler. The only structural refinement available is splitting the exit-code/recovery and lifecycle detail into a small reference file to slim the main body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational throughout — preflight script, stack-model diagram, command list, and exit-code semantics — with no explanation of concepts Claude already knows and essentially no padding; even the exit-code and recovery details are tool-specific knowledge Claude could not infer. It is not a 4 because there is no trimmable over-explanation of substance. | 5 / 5 |
Actionability | Commands are copy-paste ready with sensible parameter placeholders: a complete preflight block, the full common-operations block (`gh stack init --base main <bottom-branch>`, `gh stack view --json`, etc.), and specific recovery commands per exit code (`gh stack rebase --continue`, `--abort`). It is not a 4 because the given commands cover the common cases without gaps; delegation of PR bodies to `gh-create-pr` is an explicit boundary, not a missing detail. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints: the 4-step PR creation flow ends with "Verify the resulting topology with `gh stack view --json`", the 5-step lower-layer change flow includes verification and re-running "only the checks invalidated by that rewritten scope", and post-sync guidance requires inspecting output and re-running `view --json` rather than trusting exit success. Feedback loops for risky operations (exit codes 2, 3, 9 with distinct recovery procedures) are present, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The single-file body (~100 lines) is well organized into clear sections, and cross-references to companion skills (`gh-create-pr`, `.agents/skills/agent-notes/SKILL.md`) are explicit and one level deep. It is not a 5 because the skill exceeds the under-50-line simple-skill threshold and inlines a dense block of exit-code/recovery semantics plus repo-specific lifecycle rules that could live in a short reference file; it is above 3 because nothing is buried and the structure is genuinely easy to navigate. | 4 / 5 |
Total | 19 / 20 Passed |