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 instruction-only skill body: lean, fully actionable with concrete tool-call examples, and a clearly sequenced workflow with verification and a checklist. The one real defect is the broken TROUBLESHOOTING.md reference, which caps progressive disclosure.
Suggestions
Ship a TROUBLESHOOTING.md file in the bundle (or remove the reference and inline one line on what to do when memory_smart_search or memory_save is unavailable) so the only outbound link is not dead.
If the TROUBLESHOOTING.md reference is kept, place it under a references/ directory consistent with the skill bundle layout so the path resolves where the skill is installed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~60-line body is lean throughout: no explanation of concepts Claude already knows, punchy sections ("Save: settled decisions with reasons... Skip: anything readable from the repo"), and the two-sentence Why explains non-obvious design rationale rather than padding — every token earns its place. | 5 / 5 |
Actionability | Copy-paste-ready tool-call examples for both core operations (memory_smart_search with query/limit, memory_save with content/concepts/files) plus concrete parameter guidance ("2-5 specific concepts, real file paths") and a WRONG/RIGHT anti-pattern pair make the guidance fully executable for the common cases. | 5 / 5 |
Workflow Clarity | The five workflow steps are temporally sequenced (task start, decision settles, correction, before repeat, session end) with an explicit checkpoint ("Verify project or session provenance in the results"), a closing checklist, and a troubleshooting path — the operations are additive saves, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Sections are well organized, but the skill's single outbound reference — "See [TROUBLESHOOTING.md](TROUBLESHOOTING.md)" — is a dangling link: no such file exists in the bundle (references/, scripts/, assets/ are absent), so navigation fails when followed; against the actual bundle structure this sits at the some-structure-with-problematic-references anchor rather than a minor-gap level. | 3 / 5 |
Total | 18 / 20 Passed |