Content
78%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.
The body is concise and well-structured with concrete install commands and named configuration flags, but it is more descriptive than instructional in places and its two cross-file references point to files that are not present in the bundle. Fixing the dangling references and sharpening the actionable guidance would raise the content score.
Suggestions
Provide the missing referenced files (REFERENCE.md and ../_shared/TROUBLESHOOTING.md) or remove the references, so the one-level-deep disclosure is actually navigable rather than dangling.
Add a short, explicit diagnostic workflow for the "observations are missing" case (e.g., check plugin enabled → check server running → check hook events in REFERENCE.md) so the guidance is instructional rather than only descriptive.
Optionally surface the key capture/injection flags with their default values inline so Claude can tune recording without leaving SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is lean and assumes Claude's competence — it never explains what hooks or memory are, and each section earns its tokens with concrete commands, flags, and pointers. | 5 / 5 |
Actionability | It gives executable install commands, a live URL, specific environment flags (AGENTMEMORY_AUTO_COMPRESS, AGENTMEMORY_INJECT_CONTEXT), and a concrete diagnostic step, but much of the "What the hooks do" section describes behavior rather than instructing Claude how to act, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The Quick start gives a clear two-step sequence (install, then watch observations land live as a lightweight checkpoint), and this is a simple informational skill rather than a destructive or batch operation, so no validation cap applies; it falls short of 5 only because the body is reference-style rather than a fully checkpointed workflow. | 4 / 5 |
Progressive Disclosure | The body is well-organized into clear sections and explicitly signals one-level-deep pointers (REFERENCE.md, ../_shared/TROUBLESHOOTING.md), but neither referenced file exists in any bundle directory, so the promised deeper content is unreachable and the cross-file navigation is effectively broken. | 3 / 5 |
Total | 16 / 20 Passed |