Content
73%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 delivers a well-sequenced, validated search-before-answer protocol with concrete tool selection and honest error handling — genuinely actionable for an instruction-only skill. Its weaknesses are redundancy (duplicated supersede guidance, repeated mottos, an unnecessary persona section) and inline density that a reference file could relieve.
Suggestions
Deduplicate: state the kg_supersede / kg_invalidate / kg_add selection rule once (Protocol step 6) and have the 'Stale or conflicting facts' unhappy path point back to it instead of repeating it verbatim.
Trim the 'Identity' persona section and the second occurrences of 'wrong is worse than slow' and 'do not silently fall back' to reclaim tokens without losing guidance.
Add one or two example mempalace_search queries (e.g. 'Tommy's employer' vs. a pasted-conversation anti-example) so the 'short, keyword-driven query' rule is concretely demonstrated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but with noticeable tightening opportunities: the kg_supersede/kg_invalidate/kg_add selection guidance appears verbatim in both "Protocol" step 6 and "Unhappy paths"; "wrong is worse than slow" and "do not silently fall back to model memory" each appear twice; and the "Identity" persona section ("Act as a senior AI-memory systems engineer with decades of experience...") is padding Claude does not need. This fits 'includes some unnecessary explanation or could be tightened' rather than the 'minor instances' of a 4. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: named MCP tools (mempalace_search, mempalace_kg_query, mempalace_diary_read...), a tool-selection table, specific commands (mempalace --version, mempalace status), and concrete query-shape guidance ("short natural-language query (keywords or a question — not a system prompt)"). Falls short of a 5 because there is no worked example of an actual query, and detail is deferred to external URLs the agent may not fetch. | 4 / 5 |
Workflow Clarity | Clear sequenced protocol (Step 0 availability check → injected memory → pre-response search → verify when unsure → return verbatim → diary write → supersede on change) with explicit validation up front and a dedicated "Unhappy paths" section providing error-recovery feedback loops (empty results → widen scope per the query guide; MCP errors → surface and suggest mempalace status). This matches the top anchor's explicit validation plus feedback loops. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ absent), and the body is well sectioned with clearly signaled, one-level-deep external pointers (the canonical recall-protocol URL and query guide). Minor gap: the body runs ~120 lines with the full protocol, tool table, and anti-patterns all inline — some detail could be split out — keeping it below the 'clear overview with appropriately split content' anchor. | 4 / 5 |
Total | 16 / 20 Passed |