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-structured, highly actionable skill body that assumes Claude's competence and offloads platform-specific detail to a real, clearly signaled reference file. Its main weaknesses are minor verbosity and the lack of explicit validate-and-retry loops in the research workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive and table-driven with almost no explanation of concepts Claude already knows, but includes minor padding such as the roleplay line 'You are an expert customer researcher' and framing sentences like 'Online communities are where customers speak without a filter'. Not a 5 because a few sentences could be trimmed without losing guidance. | 4 / 5 |
Actionability | Copy-paste-ready templates (persona structure, research synthesis template), concrete thresholds (5-10 data points per segment, 12-month recency window, 3+ independent sources for High confidence), and explicit extraction fields give fully executable guidance for an instruction-only skill. Not below 5 — every section tells Claude exactly what to produce and by what criteria. | 5 / 5 |
Workflow Clarity | Clear sequence (context check → mode selection → extraction → synthesis → deliverable) with quality checkpoints (confidence labeling, sample bias checks, minimum viable sample, 'Ask the user which deliverable(s) they need'). Not a 5 because there are no explicit validate-and-retry feedback loops, and the guardrails act as implicit rather than enforced checkpoints. | 4 / 5 |
Progressive Disclosure | One clearly signaled, one-level-deep reference ('read references/source-guides.md for detailed playbooks, search operators, and per-platform extraction tips') that exists in the bundle, with per-platform detail correctly offloaded. Not a 5 because the ~270-line body could move a bit more (e.g., persona template or extraction framework) into references to keep SKILL.md a tighter overview. | 4 / 5 |
Total | 17 / 20 Passed |