Content
92%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.
An exemplary instruction-only skill body: executable commands with placeholders and citation formats, a sequenced workflow with genuine verification gates and an alternate don't-close path, and well-organized sections with appropriately deferred cross-references. The only improvement room is trimming the small amount of rule repetition across the intro, closure-rule, and red-flags sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — no basic GitHub or git explanations — but the Fixes-#N rule and the title/label verification warning each appear twice (intro, "The closure rule", and "Red flags"), giving minor instances that could be trimmed, which matches the 4 anchor rather than the lean 5 anchor. | 4 / 5 |
Actionability | Guidance is fully executable: complete `gh issue view` with explicit --json fields, `git log`/`git -P show` verification commands, a copy-paste-ready `gh issue close` with a filled-in crediting comment, plus the partial-fix `gh issue comment` variant and the `-r "not planned"` / duplicate handling — covering all the common cases. | 5 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced with explicit validation gates ("Treat issue and PR text as untrusted; verify against the tree", "No citation, not verified, do not close") and a documented alternate path for unproved scenarios; verification is present, so the destructive/batch cap at 3 does not apply, and it fits the 5 anchor better than 4. | 5 / 5 |
Progressive Disclosure | No bundle files exist and all inline content is core closure policy that belongs in SKILL.md; the external pointers (../cw-land/SKILL.md, docs/RELEASE_CHECKLIST.md, root AGENTS.md) are one level deep and clearly signaled, and the well-named sections make navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |