Content
100%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 skill body: concrete tool invocation with expected output, a sequenced workflow with edge-case and conflict-handling branches, WRONG/RIGHT anti-patterns, and a verification checklist. It adds only what Claude would not already know and keeps the sole external reference one level deep and clearly signaled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its tokens: a quick-start invocation with expected output, a 5-step workflow, terse anti-patterns, and a 4-item checklist, with no explanation of concepts Claude already knows ("Only surface what the tool returned. Never fabricate an observation, a session id, or an importance score"). Lean, assumes competence, nothing to trim. | 5 / 5 |
Actionability | Fully concrete guidance: the exact call `memory_smart_search { "query": …, "limit": 10 }` with sample output, specific thresholds (`importance >= 7`), enumerated provenance channels (`user`, `agent`, `tool`, `import`, `shared`), and a verbatim RIGHT response for the empty-results case. Copy-adaptable and covers the common cases. | 5 / 5 |
Workflow Clarity | Five numbered steps with explicit checkpoints: conflict resolution (prefer `user` over `agent` inference), the zero-results branch ("suggest 2-3 alternative search terms and stop. Do not guess"), and a closing checklist that verifies the outcome. Not a destructive or batch operation, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the ~56-line body is a self-contained overview where nothing inlined belongs in a separate file; sections are well-organized and easy to navigate. The only external pointer (`../_shared/TROUBLESHOOTING.md`) is one level deep and clearly signaled, and 'See also' names sibling skills for navigation. | 5 / 5 |
Total | 20 / 20 Passed |