Content
64%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid reference skill that provides clear, actionable tool invocations with good parameter documentation. Its main weaknesses are the lack of error handling/validation guidance (what to do when searches fail or return unexpected results) and some verbosity in sections like 'When to Activate' that Claude could infer. The content is well-organized but could benefit from being slightly more concise.
Suggestions
Add brief error handling guidance: what to do if MCP server isn't available, if searches return no results, or if deep_researcher_check shows incomplete status
Remove or significantly trim the 'When to Activate' section—Claude can infer when web search is appropriate from context
Consider adding a note about rate limits or API usage constraints if applicable
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content like the 'When to Activate' section (Claude can infer when to search) and the tips section restates somewhat obvious guidance. The parameter tables are useful but could be slightly more compact. | 2 / 3 |
Actionability | Every tool has concrete, copy-paste-ready invocation examples with specific parameters. The MCP configuration is fully specified with exact JSON. Usage patterns show real-world combinations with actual queries. | 3 / 3 |
Workflow Clarity | The deep_researcher_start/check pattern shows a clear two-step async workflow, and the 'Company Due Diligence' pattern shows multi-tool sequencing. However, there are no validation checkpoints or error handling guidance—what happens if the MCP server isn't configured, if a search returns no results, or if deep_researcher_check shows incomplete status? | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and a logical flow from setup to tools to patterns to tips. However, at ~130 lines it's somewhat long for a single file—the detailed parameter tables could potentially be in a reference file. The 'Related Skills' section provides good navigation but there are no bundle files to offload detail to. | 2 / 3 |
Total | 9 / 12 Passed |