Content
88%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 thorough, executable procedural skill with strong validation checkpoints and feedback loops throughout. It is lean and assumes Claude's intelligence; the only weaknesses are mild cross-section repetition on authorization and a long single-file structure that could benefit from extracting a reference file.
Suggestions
Consolidate the repeated explicit-authorization guidance into the Authorization section and reference it once from Synchronize, Merge, and Manual Fallback to reduce repetition.
Consider extracting the Manual Fallback and/or exit-code reference into a separate reference file to shorten SKILL.md and improve progressive disclosure.
The Synchronize section already separates phases well; apply the same phased preflight/validate structure as a short checklist header to the Merge section for consistency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, task-oriented content that assumes Claude's competence (no explanations of what a PR or rebase is), but the explicit-authorization requirement is restated across several sections (Authorization, Synchronize, Merge, Manual Fallback), which could be trimmed slightly. | 4 / 5 |
Actionability | Fully executable copy-paste-ready `gh stack` commands cover every operation (init, add, submit, view, rebase, sync, modify, merge, unstack), plus real exit codes (3, 7, 8, 9, 10) and concrete `--force-with-lease` guidance. | 5 / 5 |
Workflow Clarity | Destructive and remote operations carry explicit validation checkpoints (Preflight, 'Inspect first', conflict-resolution feedback loops, 'Stop when...' failure rules, post-rebase reinspection), satisfying the validation requirement rather than triggering the cap. | 5 / 5 |
Progressive Disclosure | A single well-organized document with clear section headers and no nested references (appropriate since no bundle files exist), but the substantial length and sections like Manual Fallback could plausibly live in a separate reference file. | 4 / 5 |
Total | 18 / 20 Passed |