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.
A well-engineered instruction-only skill body: every workflow step is executable, validation is built into both writing and pickup with explicit feedback loops, and detail is cleanly pushed to real, one-level-deep bundle files that deliver what the body promises. The only flaw is redundancy — the snapshot-not-living-document rule and the typology boundary are each restated two to three times across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is instruction-dense with no explanations of concepts Claude already knows, but it repeats itself: the snapshot-vs-in-place-edit rule appears three times (naming convention section, Relationship section, and the second anti-pattern), the pointer to references/typology-and-lifecycle.md is given twice in near-identical words, and the validator is described in both the Assets section and the References table. These are minor instances that could be trimmed, matching the 4 anchor rather than the lean 5. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact commands (git status, git log -1, git stash list, git stash push -u -m "<unique-tag>"), a copy-paste validator invocation (bash <skill-dir>/scripts/validate-handover.sh .context/handovers/), a commit message format (docs(handover): <short description>), a complete frontmatter YAML example, and a concrete filename pattern. The BAD/GOOD anti-pattern pairs are also concrete. | 5 / 5 |
Workflow Clarity | Both workflows (writing and picking up) are numbered with explicit validation checkpoints and feedback loops: "Run the validator before considering the handover done... Fix anything it flags" and "Re-run the validator to confirm the frontmatter edit didn't break the schema". Conditional handling (partially resolved outstanding work) is specified, matching the 5 anchor's explicit validation with error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview with detail split appropriately: section-by-section detail in references/document-structure.md, typology/lifecycle in references/typology-and-lifecycle.md, the contract in assets/schemas/handover-frontmatter.schema.json, and structure in assets/templates/handover.yaml — all verified to exist and to contain what the body claims. References are one level deep and clearly signaled both inline and via the References table's 'When to Use' column. | 5 / 5 |
Total | 19 / 20 Passed |