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.
A tightly written operational reference: it covers only non-inferable gh-stack behavior, provides executable commands with an always/never table and a complete exit-code recovery matrix, and routes deeper detail to three well-triggered reference files. Validation checkpoints guard the batch merge and rebase workflows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding of general knowledge — every section covers tool-specific behavior Claude cannot infer (TTY vs piped behavior, the saved-SHA semantics of `base`, "`gh stack help <command>` does not work"), so every token earns its place per the level-5 anchor. | 5 / 5 |
Actionability | Commands are copy-paste ready throughout: the setup block, the full core loop (init → commit → add → submit --auto → view --json), scoped merge invocations with explicit flags ("gh stack merge 42 --yes --squash"), and the always-run/never-run-bare table, covering the common cases per the level-5 anchor. | 5 / 5 |
Workflow Clarity | Sequences are clear with explicit validation checkpoints and feedback loops: the core loop ends with `view --json` to confirm, branch placement verifies ownership via `git log --all -- <path>` before editing, the batch merge operation is gated on an explicit user request plus a `view --json` inspection and scoped target, and exit 3 has a full resolve→continue→abort recovery path. The destructive/batch cap does not apply because validation steps are present. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview that defers detail to three real, one-level-deep reference files, each well-signaled with an explicit trigger ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict, after a squash-merge..."), plus guidance to load only the matching one — matching the level-5 anchor; all three bundle files were verified to exist and be substantive. | 5 / 5 |
Total | 20 / 20 Passed |