Content
86%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 an efficient, well-structured guide for drafting handoff prompts with a clear ground-write-close workflow. Its main improvement opportunity is actionability: a concrete example handoff prompt would make the guidance copy-paste ready.
Suggestions
Add one short, complete example handoff prompt (with the mission, live state, paths, hazards, and done-criteria) so the guidance is copy-paste ready rather than described.
Optional: make the grounding-to-writing handoff explicit with a one-line checkpoint (e.g. 'after grounding, list which commands already passed before drafting') to nudge workflow_clarity toward a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and opinionated ("This skill is a transport fallback: it never launches Claude and never supervises execution"), with no padding of concepts Claude already knows; every paragraph carries skill-specific guidance that earns its place. | 5 / 5 |
Actionability | Provides an executable git grounding block and concrete specifics ("A small handoff is 12 to 20 dense lines", done-criteria examples), but never shows a complete example handoff prompt, leaving a minor gap for an instruction-only skill. | 4 / 5 |
Workflow Clarity | A clear sequenced workflow (Ground it first -> Write it -> posture -> close with verification) with grounding and done-criteria checkpoints, but lacks an explicit validate/retry feedback loop; the destructive-cap does not apply to this drafting skill. | 4 / 5 |
Progressive Disclosure | Self-contained single-purpose skill with no bundle files needed, organized into well-signaled sections (## Ground it first, ## Write it, ## The posture that makes it work); the only link is an appropriate cross-skill pointer to agent-goal. | 5 / 5 |
Total | 18 / 20 Passed |