Content
78%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 well-structured and actionable, with a concrete output template, explicit validation gates, and clean progressive disclosure to verified reference files. Main weaknesses are repeated stop-rule enumeration and a delegated rather than in-skill retry loop.
Suggestions
Deduplicate the stop-rule list: state the full enumeration once (e.g., in Execution Boundaries) and reference it from the Procedure step instead of repeating all eight actions.
Add a brief in-skill validate->fix->revalidate note in the Procedure or Validation Gates section rather than fully delegating the retry loop to he-work.
Tighten 'run the phase gate contract' in step 4 with a one-line summary of what the gate checks, so the core procedure is actionable without opening the reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with short, well-organized sections and no over-explanation of known concepts, but the eight-item stop-rule enumeration ('staging, commit, merge, review-thread resolution, Linear closure, deploy, or destructive cleanup') is repeated across the Procedure and Execution Boundaries sections and could be tightened. | 4 / 5 |
Actionability | A concrete copy-pasteable YAML output template with exact fields and example commands ('bash scripts/verify-work.sh --fast', 'slack_policy: blocked') plus a specific numbered procedure gives mostly executable guidance; steps like 'run the phase gate contract' defer detail to a reference file. | 4 / 5 |
Workflow Clarity | A clear six-step sequence with an explicit fail-fast rule and a Validation Gates checklist is present, but the validate->fix->retry feedback loop is delegated to he-work rather than spelled out in-skill, leaving a minor validation gap. | 4 / 5 |
Progressive Disclosure | SKILL.md serves as a clear overview with a well-signaled References section pointing one level deep to real bundle files (phase-gate-contract.md, contract.yaml, evals.yaml) and shared contracts, with content appropriately split out. | 5 / 5 |
Total | 17 / 20 Passed |