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.
A concise, well-structured overview body with concrete install commands and exact flag names, appropriate for a simple informational skill. The main defects are a dangling REFERENCE.md pointer that fails to resolve within the bundle and a debugging step that lacks a concrete verification command.
Suggestions
Ship REFERENCE.md (the generated hook-event listing) in the skill bundle or remove the pointer, since the body's final section directs readers to a file that is not present.
Add a concrete check command for the "server is running" debugging step (e.g., the exact curl or status invocation against http://localhost:3113) so the failure path is executable rather than implied.
Clarify that ../_shared/TROUBLESHOOTING.md resolves at the plugin level, or inline the plugin-specific troubleshooting steps, so readers are not sent outside the bundle with no path context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~33-line body is lean with no padding and no explanation of concepts Claude already knows; every section (Quick start, What the hooks do, Important, See also, Reference) carries new information. It assumes competence ("You do not have to call memory_save for routine work") and every token earns its place. | 5 / 5 |
Actionability | Concrete, copy-paste install commands ("/plugin marketplace add rohitg00/agentmemory", "/plugin install agentmemory"), exact flag names (AGENTMEMORY_AUTO_COMPRESS, AGENTMEMORY_INJECT_CONTEXT), and a live URL. Not 5: the debugging step "confirm the plugin is enabled and the server is running" gives no concrete command to perform that check, leaving a minor gap. | 4 / 5 |
Workflow Clarity | For a simple single-purpose informational skill the sequence is clear: install via Quick start, observe at the localhost URL, and follow the Important section when observations are missing. Not 5: the debug path stops at an implicit checkpoint ("confirm the plugin is enabled and the server is running") without an explicit verification step or command. | 4 / 5 |
Progressive Disclosure | Sections are well organized and references are clearly signaled ("The exact registered hook events live in REFERENCE.md"), but neither referenced file — REFERENCE.md nor ../_shared/TROUBLESHOOTING.md — exists in the bundle (references/, scripts/, assets/ are absent), so navigation dead-ends. Anchor 3 (references present but ineffective/organization gap) fits better than 4, which requires minor gaps only, and better than 2, since the structure itself is good and no oversized content is inlined. | 3 / 5 |
Total | 16 / 20 Passed |