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.
An exemplary lean, agent-oriented skill body: a clear four-step workflow with explicit validation checkpoints, completion criteria, error-recovery feedback loops, and safety-minded Notes that prevent blind repetition of side effects. The only minor weakness is a few abstract directives and the absence of examples that would make the guidance fully copy-paste-ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~24-line body is lean and dense with non-obvious guidance ('Preserve Work Done as append-only history. It is a record of prior claims, not an authoritative statement of current state.'), explaining nothing Claude already knows and wasting no tokens. It does not fit anchor 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill: a specific fallback path ('list files in claudedocs/handoffs/'), an exact parse checklist ('Files involved (with line numbers)', 'Next steps (ordered)'), and explicit decision rules in step 4. It falls short of anchor 5 because a few directives remain abstract ('applicable decisions, and ownership') and no examples or templates are given for the common cases. | 4 / 5 |
Workflow Clarity | The four-step sequence includes explicit validation (step 3 reconciliation plus 'Revalidate checks needed for the next action when their evidence is stale'), feedback loops for error recovery ('If the path does not exist... ask the user which one to load'; 'If next steps conflict with live evidence, resolve the conflict before dependent changes'), explicit completion criteria ('Done when...'), and a literal checklist in step 2. This is not a destructive/batch operation skill, so the score-3 cap does not apply. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references, and is organized into clear '## Steps' and '## Notes' sections with no inlined content that belongs elsewhere. Per the rubric's simple-skill guideline, this earns a 5 on well-organized sections alone. | 5 / 5 |
Total | 19 / 20 Passed |