Content
82%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-executed MCP-tool skill body: concrete executable calls, a clearly sequenced decision workflow with confirmation checkpoints, and no token waste on concepts Claude already knows. The main improvement opportunities are moving the parameter lookup tables to a reference file and adding feedback-loop guidance for empty/missed lookups.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: every section documents Basic Memory-specific tool behavior Claude cannot know (memory:// URL syntax, timeframe syntax, tool parameters) with no filler or generic explanations. Falls short of anchor 5 because the timeframe table and URL wildcard examples partly restate what tool schemas could surface, and 'Present Context to the User'/'Guidelines' have minor phrasing that could be tightened. | 4 / 5 |
Actionability | All guidance is copy-paste-ready calls with realistic parameters — build_context(url="memory://topic-or-note-name", depth=2, timeframe="7d"), recent_activity(timeframe="3d"), search_notes(query=...), read_note(identifier=...) — plus three concrete scenario playbooks covering the common cases (resuming a spec, continuing general work, following up on a topic). Executable and complete for an MCP-tool skill. | 5 / 5 |
Workflow Clarity | The four-step 'Building Context' sequence is clear, with decision rules for choosing tools ('Known topic — use build_context', 'No clear starting point — use recent_activity') and explicit checkpoints: 'If it's unclear, ask' up front and 'Confirm understanding. Verify the reconstructed context is what the user actually needs before acting on it'. Not 5 because there are no error-recovery feedback loops (e.g., what to do when search returns nothing or a memory:// URL misses). | 4 / 5 |
Progressive Disclosure | With no bundle files provided, the single-file structure is well organized: 'When to Use', numbered 'Building Context' steps, compact reference tables, scenario playbooks, and guidelines are each load-bearing. Not 5 because the Memory URL and Timeframe reference sections (~30 lines of parameter documentation) are the kind of lookup material the rubric expects split into a separate reference file, and the memory-notes cross-reference is named but not linked. | 4 / 5 |
Total | 17 / 20 Passed |