Content
63%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 thorough, actionable research playbook with a clear phased workflow and copy-paste templates. Its main weaknesses are verbosity from inlined reference-style content and the absence of validation feedback loops.
Suggestions
Move the full report-format template and the long search-pattern/tip lists into reference files (e.g. references/report-template.md, references/search-patterns.md) and link to them from SKILL.md to improve conciseness and progressive disclosure.
Add explicit validation/verification checkpoints in the workflow (e.g. cross-check facts across two independent sources before writing them, and re-run searches if a section returns no usable results) to strengthen feedback loops.
Trim sections that restate what Claude already knows about how web search works, keeping only the company-specific query patterns that add value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body mostly assumes Claude's competence but the ~75-line placeholder report template and exhaustive search-pattern/tips sections restate search behavior Claude already knows, adding padding that could be tightened. | 3 / 5 |
Actionability | Concrete search query strings, a copy-paste report template, named third-party sources (Crunchbase, BuiltWith, Wappalyzer), and explicit subagent delegation (web-researcher, people-finder) give mostly executable guidance with minor gaps. | 4 / 5 |
Workflow Clarity | A clear three-phase sequence with time budgets and a terminal Quality Checklist, but no validate→fix→retry feedback loops embedded in the flow; sits above 3 due to the explicit checklist checkpoint. | 4 / 5 |
Progressive Disclosure | Well-organized with clear section headers, but at ~310 lines the full report template and search-pattern vault are inlined with no external reference files, so content that could be split out remains in SKILL.md. | 3 / 5 |
Total | 14 / 20 Passed |