Content
85%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 lean, well-structured informational skill: every section delivers concrete facts (paths, commands, timing, privacy boundaries) that directly answer the description's three questions, with no padding beyond a few trimmable benefit clauses. The only improvement space is slightly richer coverage of adjacent user questions and tighter phrasing.
Suggestions
Trim the benefit clause '— no re-explaining the codebase, no re-discovering decisions' and merge the repeated machine-locality statements into one sentence.
Add one or two adjacent facts users of this skill commonly ask for, such as how to inspect stored observations or how to disable auto-injection, to close the minor actionability gaps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~150-word body is dense with claude-mem-specific facts ('Every Read, Edit, and Bash that Claude makes turns into a compressed observation', 'Everything stays in ~/.claude-mem'), assuming Claude's competence throughout. It falls just short of anchor 5 because of minor trimmable flourishes — 'no re-explaining the codebase, no re-discovering decisions' — and slight redundancy between 'on this machine' and 'Nothing leaves your machine'. | 4 / 5 |
Actionability | Concrete, checkable facts throughout: the path '~/.claude-mem', the command 'Run /learn-codebase... (~5 minutes, optional)', the cleanup command 'npx claude-mem uninstall', and the timing rule 'Memory injection starts on your second session'. This fits 'Mostly executable guidance; concrete code or commands with minor gaps' — it stops short of anchor 5 only because some adjacent common cases (e.g., how to inspect what's stored, how to disable injection) are unaddressed. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose skill (answer 'how does claude-mem work'), and the single action is unambiguous: the three sections ('What it does', 'When it kicks in', 'Where data lives') mirror the description's three promises one-to-one. Per the simple-skill guideline this earns a 5; there are no destructive or batch operations, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, needs no external references (no references/, scripts/, or assets/ exist in the bundle, and none are cited), and is organized into clear sections that each answer one question. Per the under-50-lines guideline, well-organized sections alone earn a 5 here. | 5 / 5 |
Total | 18 / 20 Passed |