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.
The SKILL.md body is a lean, high-density operational guide: executable commands with non-interactive flags throughout, clearly sequenced workflows with confirm/recovery checkpoints, and a disciplined split into three trigger-indexed reference files. It teaches only what is non-obvious about this specific tool and omits everything Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries non-obvious, tool-specific knowledge Claude cannot already have (TTY/PTY branching, stack orientation semantics, the exit-code table, worktree catalog behavior), with no padding and no explanation of general git/GitHub concepts. Even dense passages like "parse only successful path-mode stdout, never status messages" earn their tokens, matching the level-5 'every token earns its place' anchor rather than level 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | The body is dominated by copy-paste-ready invocations with the exact safe flags: "gh stack submit --auto", "gh stack merge 42 --yes --squash", "gh stack rebase --upstack", a complete core loop, and an 'Always run / Never run bare' table with reasons. This exceeds the level-4 anchor (concrete commands with minor gaps) and matches level 5: specific examples cover the common cases, with only inherent placeholders like "git add ..." whose content is user work. | 5 / 5 |
Workflow Clarity | Sequences are explicit and validated: the core loop ends with "gh stack view --json # confirm", the edit workflow validates ownership first ("Run gh stack view --json; if ownership is unclear, inspect git log --all -- <path>"), and the exit-code table plus the Exit 3 recovery procedure (resolve → git add → rebase --continue, or --abort) form an explicit feedback loop and error-recovery checklist. This matches the level-5 anchor; level 4 ('minor validation gaps') would understate the recovery coverage. | 5 / 5 |
Progressive Disclosure | The body stays a focused overview and defers detail to three real, verified, one-level-deep reference files, each given an explicit trigger in 'More detail' ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict"), plus "Open the reference whose trigger matches the task; no need to preload all three." This is the level-5 anchor (clear overview, well-signaled one-level-deep references) exactly; no nested references exist in the bundle. | 5 / 5 |
Total | 20 / 20 Passed |