Content
77%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-structured, example-driven skill with a clear sequenced workflow and genuine validation checkpoints, held back by bundle integration issues. The missing template file and two orphaned bundle files (evaluation-criteria.md, evaluate.py) leave the progressive-disclosure layer incomplete.
Suggestions
Create `templates/evaluation-report.md` (or inline the template) — Step 3 currently directs the agent to a file that does not exist in the bundle.
Link `references/evaluation-criteria.md` from Step 2, where the agent is deciding whether a gap merits a 4 vs a 3 — that is exactly the content the file provides.
Mention `scripts/evaluate.py` in the body (e.g., a short 'Standalone use' note) so the script is discoverable without opening hook-integration.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight — a compact axes table, two fully worked scorecard examples, and short anti-pattern FAIL snippets, with no explanation of concepts Claude already knows. Minor trimming is possible: the Best Practices bullets ('Use tool outputs as evidence', 'If you can't find any gaps, try harder') partially restate the Evidence Rule and Step 2 guidance. | 4 / 5 |
Actionability | Guidance is largely executable: four numbered workflow steps, a required-elements list for the report, and two complete worked scorecards in the exact output format. The gap: Step 3 points to `templates/evaluation-report.md`, which does not exist in the bundle, so the copy-paste template it promises is missing. | 4 / 5 |
Workflow Clarity | The 4-step sequence (collect material → score each axis fresh → produce report → apply improvement) has explicit checkpoints: the Evidence Rule gates every sub-5 score, Step 4's fix-or-flag branch is a feedback loop, and the 'Would the user agree with this assessment?' self-check closes the process. Not 4: validation is explicit at each stage, not merely implied. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and one reference (`references/hook-integration.md`) is clearly signaled, but bundle navigation is broken or incomplete: `templates/evaluation-report.md` is referenced but missing, `references/evaluation-criteria.md` (the detailed 4-vs-3 anchors Step 2 needs) exists but is never linked from SKILL.md, and `scripts/evaluate.py` is never mentioned in the body. Two unlinked bundle files plus one dead path is more than the 'minor organization gaps' of the anchor above. | 3 / 5 |
Total | 16 / 20 Passed |