Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an exceptionally lean, well-sequenced shipping checklist with explicit validation checkpoints and a completion gate. Its main weakness is actionability: it names what to verify but supplies no executable commands and defers the concrete checks to an external doc.
Suggestions
Inline one or two of the concrete pre-push checks or the merge/commit commands (or point to the specific quality-gates section) so the steps are directly executable without leaving the skill.
Add an explicit error-recovery loop after step 7, e.g. 'If conflict markers or generated drift are found, fix and re-inspect before declaring complete.'
Clarify what 'the required checks from docs/development/quality-gates.md' are at a high level so the skill remains actionable even if that doc is unavailable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is an 8-line numbered checklist plus a one-line completion gate with zero padding and no explanation of concepts Claude already knows, fitting the lean-and-efficient anchor where every token earns its place. | 3 / 3 |
Actionability | The checklist gives concrete things to verify (companion commits, public contracts, generated files, signed conventional commits) but provides no executable commands and defers "the required checks" to an external doc, matching the anchor for concrete-but-incomplete guidance missing key details. | 2 / 3 |
Workflow Clarity | A clearly sequenced 8-step process with explicit verification checkpoints (confirm scope match, verify pushes, inspect for conflict markers and drift) and a completion gate ("Do not call work complete while required merged-commit workflows are still running"), exceeding the anchor where checkpoints are merely implicit. | 3 / 3 |
Progressive Disclosure | Under 50 lines with a single clearly signaled one-level reference ("docs/development/quality-gates.md") and no nested references, fitting the well-organized concise-skill anchor that permits a top score without external bundle files. | 3 / 3 |
Total | 11 / 12 Passed |