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 index skill with concrete tool names and a clear selection workflow. Its main defects are the missing REFERENCE.md (the deferred parameter table the workflow depends on) and the absence of validation guidance around the destructive tools it indexes.
Suggestions
Ship REFERENCE.md in the bundle (e.g. under references/), or inline a compact parameter table for the core tools (memory_save, memory_smart_search) — the workflow's step 2 depends entirely on a file that is not present.
Add a pre-flight validation step for destructive/batch tools, e.g. run memory_audit or memory_verify and confirm the target ID before calling memory_governance_delete or memory_slot_delete.
Mark which quick-start parameters are required vs optional so the two most common calls are executable without consulting the missing reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body is lean: no concept explanations Claude already knows, and every sentence adds non-obvious information ("This runs hybrid BM25 plus vector plus graph-expanded search", "REST handlers whitelist fields and drop unknown ones"). The tool-family lists are dense indexes, not padded prose — every token earns its place. | 5 / 5 |
Actionability | The Quick start gives concrete tool calls with parameter names ("memory_save with content, concepts, files"; "memory_smart_search with query and limit"), and the Workflow picks specific tools per task — but exact/required parameters are deferred to REFERENCE.md, which is not present in the bundle, so guidance is not fully executable standalone. That is a minor-to-real gap placing it below the fully-executable 5 anchor and above the incomplete 3 anchor. | 4 / 5 |
Workflow Clarity | The Workflow section is a clear 3-step sequence (pick the narrowest tool → look up exact parameters in REFERENCE.md → pass only documented fields) with a pre-flight check in step 2 and a failure-mode warning (unknown fields are dropped). No explicit validation or feedback loop exists, and while the skill indexes destructive tools (memory_governance_delete, memory_heal), its own workflow is selection/lookup rather than executing them — so the destructive-cap doesn't strictly apply, but the missing error-recovery keeps it below 5. | 4 / 5 |
Progressive Disclosure | Structure is good — well-organized sections (Quick start, Tool families, Workflow, See also, Reference) with the bulky tool table correctly split out to a one-level-deep, clearly signaled REFERENCE.md. However, scored against the actual bundle: no references/, scripts/, or assets/ directories exist and REFERENCE.md is absent, so the skill's central deferred resource ("Full tool table with parameters... lives in REFERENCE.md") is unreachable. A dead primary reference is more than the 'minor organization gaps' of the 4 anchor, though the in-body structure is far better than the 2 anchor's inlined bulk. | 3 / 5 |
Total | 16 / 20 Passed |