Content
77%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 highly actionable with an executable detection preamble, complete code templates, and a well-sequenced interactive methodology with explicit validation gates. Its weaknesses are repetition (several key points restated multiple times), an off-task Enterprise Outreach section, and a monolithic single-file structure that inlines ~200 lines of product reference material that belongs in a separate file.
Suggestions
Move the "Your Expertise: Hindsight Product Knowledge" section (Retain/Recall/Reflect/Banks/Tags/Mental Models, ~200 lines) into a references/ file (e.g. references/hindsight-product.md), keeping a short summary plus one-level-deep links in SKILL.md.
Deduplicate recurring points — the "tags are identity scopes, not content classification" point appears three times and the mental-model retrieval-strategy point twice; state each once and cross-reference.
Trim or externalize the "Enterprise Outreach" section (~20 lines with a booking link); it does not advance the skill's core planning function and competes with the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is genuinely non-obvious product knowledge (retain/recall/reflect parameters, tags_match semantics, mental model design) that earns its place, but there is noticeable tightening potential: the "tags filter whose memories, not content classification" point is explained at least three times ("Tags" section, "Connecting Opportunities to Tags", "Challenge assumptions"), the mental-model-retrieval-strategy point is repeated nearly verbatim twice (lines ~285 and ~675), and the ~20-line "Enterprise Outreach" section with a Calendly link is off-task for the skill's core function. This matches anchor 3 ("includes some unnecessary explanation or could be tightened") rather than 2, since the padding is a minority of the document and there is no explaining of concepts Claude already knows. | 3 / 5 |
Actionability | The body provides a fully executable 140-line bash preamble for environment detection, copy-paste-ready Python and Node.js templates for every operation (create_bank, retain, recall, create/get_mental_model, client setup), exact env-var blocks, install commands per deployment mode, and a concrete output format with a checklist. Placeholders like {tags} are explicitly template variables for the generated plan ("Replace {placeholders} with values from the design"), which is justified rather than pseudocode. This matches anchor 5 ("copy-paste ready code or commands; specific examples cover the common cases"). | 5 / 5 |
Workflow Clarity | The methodology is a clearly sequenced four-phase process with explicit checkpoints: preamble detection branches (configured vs. not, Path A/B/C), one-question-at-a-time AskUserQuestion gates, a defined gate before Phase 3 ("What You Need Before Moving On... Don't move to Phase 3 until you can make the three decisions"), a user confirmation loop ("Confirm: 'Does this design work?' Adjust if needed"), and a checklist in the generated plan. This matches anchor 5 (explicit validation steps, feedback loops, checklists); the skill is a planning skill so no destructive-operation cap applies. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned and navigable (not anchors 1-2's monolithic/buried-reference cases), but there are no bundle files at all — the ~200-line "Your Expertise: Hindsight Product Knowledge" section (Retain/Recall/Reflect parameter tables, mental model semantics) is exactly the API-reference-style content that belongs in a separate references/ file, inlined here in an ~855-line SKILL.md. This matches anchor 3's example ("[200 lines of API reference that could be in a separate file]" under organized headers); it is not 4 because no one-level-deep references exist and the main file carries all the detail. | 3 / 5 |
Total | 16 / 20 Passed |