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, actionable instruction-only skill: exact tool commands, a concrete scope model, and read-before-write discipline throughout. Its weaknesses are modest — a missing invocation example for the shared-scope `resources` write, some repetition between the Key Rules and earlier sections, and a trigger catalog that could be split into a reference file.
Suggestions
Add the exact invocation for the shared-scope write, e.g. a one-line example of the `resources` tool call with `scope: "shared"` and the `LEARNINGS.md` path, mirroring the `save-memory` examples.
Trim Key Rules 2 and 4 (scope-by-audience and read-before-update), which restate the 'How to Read & Write Memories' and 'When to Capture' sections, or fold those sections' detail into the rules to remove the duplication.
Consider moving the ~45-line 'When to Capture' example catalog (user preferences, feedback, project, reference bullets) into a one-level-deep reference file, keeping only the shared-scope guidance and Don't-Capture list inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — it teaches the tool-specific resource model and scope rules rather than general concepts, and the Memory Types table is dense information per token. There is minor redundancy that could be trimmed: Key Rules 2 and 4 restate guidance already given in 'How to Read & Write Memories' and 'When to Capture', and some example quotes in the capture lists are near-tautological. Not 'lean, every token earns its place' (5), but well above 'noticeably verbose' (2) or 'mostly efficient with unnecessary explanation' (3). | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands are given for personal memory operations ('save-memory --name <name> --type <type> --description "..." --content "..."', 'resource-read --path memory/<name>.md', 'delete-memory --name <name>', 'resource-list --prefix memory/') plus a concrete types table and scope rule. The one notable gap is the shared-scope write: 'write the full updated file with the `resources` tool using `scope: "shared"`' names the tool but never shows its invocation syntax, leaving that step executable only by inference — that keeps it below fully-executable level 5. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced with the important checkpoints present: read-first/merge-don't-overwrite before updating, 'Save only new, supported facts' as a gate, and scope selection by audience before writing. Memory writes are not batch/destructive operations requiring validate-fix-retry loops, so the level 3 cap does not apply. It stops short of level 5 because there is no post-write verification (e.g., re-reading to confirm the merge) and the shared LEARNINGS.md update path is described only in prose. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so this is scored on the body's own structure: clear section headers, a scannable types table, and well-organized capture guidance that is easy to navigate — matching 'good structure, most content appropriately placed'. It is not a level 5 because the 'When to Capture' subsections (team knowledge, preference examples, don't-capture list) run ~45 lines of trigger catalog that could plausibly live in a one-level-deep reference file, and the ~90-line body exceeds the simple-skill threshold where organization alone earns a 5. | 4 / 5 |
Total | 16 / 20 Passed |