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.
The body is a dense, highly actionable, well-sequenced workflow with explicit validation checkpoints and feedback loops, and no filler. Its only weaknesses are minor duplication between the Workflow, Constraints, and Command Pattern sections, and the inlining of a sizable rulebook that could be split into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains no padding or explanations of concepts Claude already knows — every line carries repo-specific rules — but the hotfix title grammar is repeated in Workflow steps 7/10 and again in Constraints, and the Command Pattern section restates steps 8-11 nearly verbatim, which is trimmable duplication. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste gh/gh-extension preflight block, `pnpm change:scope --base <verified-base-ref>`, a concrete temp-file heredoc pattern, exact `gh pr create` invocations, exact title grammars, and the exact bilingual release-note fence structure cover the common cases. | 5 / 5 |
Workflow Clarity | The 12-step workflow is clearly sequenced with explicit validation checkpoints and feedback loops: "Stop if authentication, installation, or the final verification fails", inspecting the temp body before creation, and verifying the classifier added the `hotfix` label after creation with a defined fix path. | 5 / 5 |
Progressive Disclosure | Sections are well organized (Stack tooling / Workflow / Constraints / Command Pattern) and references to repo files like `.agents/skills/gh-stack/SKILL.md` and `.agents/notes/README.md` are clearly signaled, but the ~125-line body inlines the entire hotfix/backport/release-note rulebook that could plausibly live in a separate reference file. | 4 / 5 |
Total | 18 / 20 Passed |