Content
55%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 skill has excellent workflow structure — clear operation sequencing, per-operation validation checklists, and issue/solution feedback loops — but it is severely bloated: nearly a thousand lines that re-teach research basics Claude already knows and inline detailed content that duplicates the existing references/ files. The strongest fix is to collapse the body into a lean overview that points explicitly to each reference guide and the helper script.
Suggestions
Cut the body to a concise overview (roughly the 'Quick Reference' section plus one-paragraph summaries per operation) and move each operation's detailed steps, examples, and issue/solution pairs into the corresponding references/ file, which already covers the same ground.
Replace the repeated 'When to Use / Prerequisites / Expected Outcome / Common Issues / Tips' scaffolding and the twice-present source-credibility hierarchy with a single short section — Claude already knows how to run web searches, judge credibility, and read a README.
Signal each reference explicitly next to its operation (e.g. 'Web Search: see references/web-search-strategies.md') and document the concrete commands of scripts/research-helper.py (init/add-source/add-finding/synthesize/export) instead of the generic single-line mention at the end.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~930-line body extensively explains concepts Claude already knows (how to formulate a web search, evaluate source credibility, navigate documentation, read a README) and pads every operation with repeated 'When to Use / Prerequisites / Steps / Expected Outcome / Validation / Common Issues / Tips' scaffolding. The credibility hierarchy and search-query advice appear multiple times. This is noticeably below the midpoint — most of the per-operation prose could be cut without losing actionable content — though it stops short of anchor 1's purely elementary tutorial tone. | 2 / 5 |
Actionability | There is concrete material — example search queries ('"MCP server" database access', 'topic:claude-code language:markdown'), a copy-paste synthesis template, and example findings documents — but much of the step guidance restates what Claude trivially knows ('Use WebSearch tool with formulated query', 'Review README for relevance', 'Check stars, activity'). Compared to anchor 4, the guidance is incomplete: no executable code in the body, generic process directions where specific non-obvious instructions are needed, though it is not merely vague as in anchors 1-2. | 3 / 5 |
Workflow Clarity | The five operations are clearly introduced up front ('Task-based (5 independent research operations)'), each is sequenced with numbered steps, and every operation ends with an explicit validation checklist. 'Common Issues' with paired Solutions provide the error-recovery feedback loops anchor 5 requires (e.g. 'Search too broad → add specific technical terms', 'Conflicting information → prioritize official docs'), and the Research Quality Checklist closes the overall process. It clearly exceeds anchor 4's 'most checkpoints present'. | 5 / 5 |
Progressive Disclosure | The bundle is real and well-matched — four references/ guides (one per research type) plus scripts/research-helper.py, all one level deep — but the body only gestures at them generically at the very end ('see the references/ directory') rather than signaling them per section, and ~600 lines of per-operation detail that duplicates the reference files are fully inlined in SKILL.md itself. This matches anchor 3 ('references present but not clearly signaled; content that should be separate is inline'); the good section structure keeps it from anchor 2, while the duplication and weak signaling keep it from anchor 4. | 3 / 5 |
Total | 13 / 20 Passed |