Content
75%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, actionable research workflow with executable commands, a concrete output template, an evidence threshold, and fallback handling for blocked content. Weaknesses are modest: minor redundant framing, some high-level steps lacking concrete mechanics, and inline content (output template, worked example) that could be split into reference files for progressive disclosure.
Suggestions
Trim redundant framing — the opening line 'Research technical solutions and gather evidence before implementation' duplicates the frontmatter description, and 'Web Search First' can drop the 'Always start with' preamble since the heading already conveys ordering.
Make the search and comparison steps concrete: give example query patterns for the initial web search and specify what a comparison note in ./scratch/research/ should contain (criteria, tradeoffs, verdict per option).
Move the Output Format template and Example Usage into a references/ file (e.g., references/output-format.md) referenced one level deep, keeping SKILL.md as a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — no explanations of concepts Claude already knows, and lists ('Official documentation', 'README documentation, Code examples') carry real guidance. Minor trimmable padding: the intro line 'Research technical solutions and gather evidence before implementation' restates the frontmatter description, and 'Always start with web search' duplicates the section title's intent. Fits anchor 4 (efficient, minor over-explanation) rather than 5 (every token earns its place); well above 3. | 4 / 5 |
Actionability | Provides executable commands (`git clone https://github.com/owner/repo.git`, `mkdir -p ./scratch/research`), a copy-paste-ready output template, a concrete evidence threshold ('Minimum 2-3 datapoints required'), and a worked example. Not 5 because key steps remain high-level — no concrete command or approach for the web-search step itself or for summarizing cloned repos — leaving minor gaps per anchor 4. | 4 / 5 |
Workflow Clarity | A clear five-step numbered sequence with error recovery (section 3, 'Handle Blocked Content', gives a ready-made fallback prompt) and an evidence-count checkpoint with an escalation path ('If insufficient evidence, ask for guidance'). Not 5 because the evidence check is a threshold rather than an explicit validate-fix-retry loop, and steps like 'Compare approaches' lack a stated checkpoint. Not a destructive/batch operation, so no cap applies. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the ~100-line body is organized into well-signaled sections (Research Process, Output Format, Example Usage). Falls short of 5 because the skill exceeds the under-50-line simple-skill exception and inlines content that could live in a reference file — notably the ~20-line Output Format template and the Example Usage walkthrough. Comfortably above 3: structure is clear and nothing is buried. | 4 / 5 |
Total | 16 / 20 Passed |