Content
75%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.
A tight, well-structured procedural skill: clear step sequence, concrete commands, explicit decision branches, and no padding or concept-teaching. It misses the top band mainly on validation — no verification after the archive move or frontmatter edit — and a few operations are described rather than given as commands.
Suggestions
Make Step 4 fully executable: give the mv command (e.g. "mv docs/handoffs/<file>.md docs/handoffs/_archive/") and a snippet showing the restored/restored_at frontmatter fields.
Add a verification checkpoint after Step 4, e.g. confirm the file exists in _archive/ and no longer appears in the unrestored listing, before restoring context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes competence, and explains no general concepts — every step is operational. Minor trimmable redundancy keeps it below anchor 5: the "Core principle" line and the Overview paragraph both restate what Step 5 and the process already say. | 4 / 5 |
Actionability | Mostly executable: copy-paste commands ("ls docs/handoffs/*.md 2>/dev/null", "git status"), a decision table, and output templates cover the common cases. Gaps: the archive move ("Move the file to docs/handoffs/_archive/") and the frontmatter update are directions rather than a command or snippet, so it falls short of anchor 5's fully copy-paste-ready bar. | 4 / 5 |
Workflow Clarity | A clearly sequenced 5-step process with explicit branching for the one/multiple/none cases and a checkpoint ("run git status to see if the working tree matches expectations"). It lacks an explicit post-action verification (e.g. confirming the file landed in _archive/ or the frontmatter saved), which is exactly the minor validation gap that defines anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Well-organized sections with everything appropriately inline; no bundle files exist and none are needed. The under-50-line exception for a 5 does not strictly apply to this ~93-line body, but structure and navigation are clean, matching anchor 4 with only minor organization gaps (e.g. the Pairs With cross-references could state when to prefer the sibling skills). | 4 / 5 |
Total | 16 / 20 Passed |