Content
86%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 strong instruction-style skill body: every section is domain-specific and actionable rather than explanatory, with concrete thresholds, copy-paste output templates, and explicit sequencing across the three research modes. The only real costs are a slightly redundant double introduction of Mode 3, a generic role-preamble, and one textbook JTBD explanation Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific material (confidence table, sample-bias checks, ICP source table, templates) with only minor trimmable parts: the 'You are an expert customer researcher...' preamble, Mode 3 being described twice (in 'Three Modes of Research' and again in its own section), and a standard JTBD functional/emotional/social breakdown Claude already knows. It is efficient on the whole, so it sits above anchor 3 ('some unnecessary explanation') but short of anchor 5 ('every token earns its place') because of that duplication. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: 'Extract: pains, triggers, desired outcomes, language used, objections, alternatives considered', a copy-paste synthesis template and persona template, and concrete numbers throughout ('$50/call, $5/survey; aim for 10 calls', '40% "very disappointed" benchmark', 'fewer than 5 independent data points per segment'). Not 4: there are no material gaps — templates and criteria cover the common cases. | 5 / 5 |
Workflow Clarity | The sequence is explicit — 'Establish which mode(s) apply before proceeding', 'Mine what's already public (Mode 2) before you ask (Mode 3)', 'lead with #1 and #2' for questions, 'Ask the user which deliverable(s) they need before generating output' — with quality checkpoints ('Label every insight with a confidence level before presenting it', 'Flag contradictions'). Not 5: the checkpoints are quality guardrails rather than explicit validate→fix→retry loops, and the persona-generation stage is only loosely tied into the deliverable-selection flow; not 3 because sequence and checkpoints are both present and explicit. | 4 / 5 |
Progressive Disclosure | The body keeps the overview and pushes detail to two well-signaled, one-level-deep references — 'read `references/interviews-and-surveys.md`' (with a bulleted summary of its contents) and 'read `references/source-guides.md` for detailed playbooks, search operators, and per-platform extraction tips' — and both files exist in the bundle and cover exactly what is claimed (verified against their headings). Not 4: the references are clearly signaled with content summaries and the split is appropriate, matching anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |