Content
75%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-organized, appropriately concise, and largely actionable skill body: concrete steps, exact paths, complete output templates, and clean branching for a read-only query workflow. The consistent gaps are unspecified search/fuzzy-match mechanics under the Read/Glob tool constraint and Query Examples that describe filtering and recency behaviors the workflow never defines. It performs solidly across all dimensions without reaching the fully-executable, gap-free top anchors.
Suggestions
Reconcile the Query Examples with the workflow: '/recall decisions' (type filtering) and bare '/recall # Show recent memories' promise behavior the workflow doesn't define (the workflow says empty input shows the full summary) — either add these modes to the workflow or remove the examples.
Specify how to search given only Read and Glob are allowed — e.g., "match the topic against MEMORY.md entries already in context, then Glob memory file names for keyword matches" — since 'search file content' implies a Grep-style tool that isn't available.
Define the fuzzy-match and 'Suggest related' rules concretely (e.g., token/substring overlap on file names and descriptions, and linking memories that share [[links]] or topic tokens) so the Rules section is executable rather than aspirational.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: no explanations of concepts Claude already knows, a tight 3-step workflow, and functional output templates. Minor trimmable padding remains — ~30 lines of box-drawing output templates and a Query Examples block that partially duplicates the workflow branches — placing it at anchor 4 ("Efficient; minor instances... that could be trimmed") rather than the every-token-earns-its-place of anchor 5. | 4 / 5 |
Actionability | Mostly executable guidance: concrete memory directory path (`.claude/projects/<project-hash>/memory/`), explicit branch handling ("If 'all' or empty" / "If specific topic"), full output templates, and concrete examples. Minor gaps keep it from 5: the fuzzy-match mechanics are undefined ("Fuzzy match - 'state' matches 'state-management-decision'" gives one example but no rule), "Suggest related" has no mechanism, and "Search memory file names, descriptions, and content" is not directly executable with the skill's allowed tools (Read, Glob — no Grep). | 4 / 5 |
Workflow Clarity | Clear sequenced workflow (Load Memory Index → Process Query → Read Relevant Files) with explicit branching and graceful empty-state handling; it is read-only so no validation feedback loop is required. It falls short of anchor 5 because Step 2's search procedure is underspecified given the Read/Glob-only tool constraint, and the Query Examples promise behaviors ("Show only project-type memories", "Show recent memories" for bare /recall) the workflow never defines — a minor coherence gap consistent with anchor 4. | 4 / 5 |
Progressive Disclosure | No bundle files exist and none are referenced; the skill is self-contained with well-organized sections (Workflow, Output Formats, Query Examples, Rules). At ~105 body lines it exceeds the under-50-line simple-skill exception, and while nothing clearly belongs in a separate file, the inline output templates and example gallery could be split out, matching anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps") rather than the ideal split-and-referenced structure of anchor 5. | 4 / 5 |
Total | 16 / 20 Passed |