Content
53%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 well-structured and token-efficient but functions as marketing documentation rather than operational instructions: beyond the install command, it never tells the agent how to actually invoke injection, summarization, compression, or verification. The 'How It Works' steps describe internal features, not an executable workflow with validation checkpoints.
Suggestions
Add concrete usage guidance: the actual commands, API calls, or file formats for invoking context injection, summarization, compression, and fact verification — currently only the install command is executable.
Reframe 'How It Works' as an executable sequence with explicit checkpoints (e.g. 'run X, verify output, then Y') instead of describing internal mechanisms.
Remove promotional sections ('Free forever', 'Related Skills' marketplace plugs, 'Links') or collapse them into frontmatter metadata to save context tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body uses lean bullet sections without explaining concepts Claude already knows, but marketing padding ('dramatically', 'Free forever. Built by the Genesis Agent Marketplace.', 'God-Tier') and the promotional 'Related Skills'/'Links' sections could be trimmed, matching the 'efficient with minor over-explanation' anchor. | 4 / 5 |
Actionability | The only executable guidance is the install command 'npx skills add christopherlhammer11-ai/recallmax'; the four 'How It Works' steps describe what the tool does internally with no usage commands, API, or invocation examples, matching the 'high-level hints but missing the specific steps to execute' anchor rather than anchor 3, which requires at least some concrete guidance toward execution. | 2 / 5 |
Workflow Clarity | Steps 1-4 (injection, summarization, compression, verification) are listed in a coherent order, but they describe the tool's internal mechanisms rather than an agent-executable sequence, and no validation checkpoints or error-recovery loops appear anywhere, matching the 'steps listed but checkpoints missing' anchor. | 3 / 5 |
Progressive Disclosure | The body is well-organized with clear section headers (Overview, Install, When to Use, How It Works, Best Practices) and no bundle files exist to reference, but the 'Related Skills' and 'Links' sections are promotional rather than navigational content, keeping it at the 'good structure with minor organization gaps' anchor rather than 5. | 4 / 5 |
Total | 13 / 20 Passed |