Content
96%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 instruction-plus-CLI skill body: lean, fully executable, with a validated workflow and clean progressive disclosure to real bundle files. The only defect found is a single referenced file (hooks/forensics_hint.py) missing from the bundle.
Suggestions
Ship hooks/forensics_hint.py in the bundle (or drop the hooks/ path from SKILL.md and describe the hook without a filename) so every referenced path resolves.
Consider listing hooks/ alongside references/ and assets/ in the 'References and assets' section with a one-line description, matching how the other bundle files are surfaced.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational: a four-command workflow, a compact recorded/inferred table, terse hard rules, an exit-code table, and one-line reference descriptions. The short opening paragraph states the skill's premise (memory drops critical details) rather than explaining concepts Claude already knows, so every section earns its place — anchor 5, not anchor 4 which requires trimmable over-explanation. | 5 / 5 |
Actionability | Commands are copy-paste ready with real flags and example values ('trace_finder.py --since 7d --touched config.yaml', 'trace_timeline.py --trace <path> --why 9', 'claim_checker.py --claim "passed:pytest"'), and the scripts table documents exit codes plus universal flags (--help, --sample, --output json). This fully matches anchor 5's 'fully executable, copy-paste ready' coverage of the common cases. | 5 / 5 |
Workflow Clarity | A clear four-step numbered sequence with a skip condition (hook supplies this session's path), per-step comments on what each yields, an explicit validation step (step 4 checks every summary claim before repeating it as fact), and feedback loops for error recovery (exit 2 -> 'not recorded here, do not reconstruct'; exit 4 contradiction -> 'correct the account first'). This matches anchor 5; anchor 4 would lack some of these checkpoints. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview with clearly signaled one-level-deep links to references/ and assets/, each with a one-line description and size hint, and all those files exist in the bundle. It falls short of anchor 5 because the body references hooks/forensics_hint.py, which is not present in the bundle (no hooks/ directory), leaving one dangling path a reader cannot resolve. | 4 / 5 |
Total | 19 / 20 Passed |