Content
61%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 concise, well-organized instruction-style skill with commendable anti-fabrication guardrails, but it is more mission statement than runbook: no concrete search command or example, no report format, an undelivered 'curated fallback data' resource, and an implicit rather than explicit search-to-fallback-to-report workflow.
Suggestions
Add an executable example of the DuckDuckGo search (command or code snippet) and a concrete template for the 'structured research report' (e.g. fields for finding, source URL, date retrieved).
Deliver the 'curated industry data' fallback — either bundle it as a references/fallback-data.md file with a clear pointer from SKILL.md, or remove the claim.
Make the workflow explicit and ordered: 1) attempt web search, 2) if unavailable, load curated fallback and label it, 3) summarize with cited URLs, 4) verify every statistic has a source before presenting.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes competence, and contains no tutorial filler — but the two-sentence intro restates the frontmatter description almost verbatim, and the first Skills bullet ('Search the web for market data, news, and competitor information') repeats the intro a third time. This is 'efficient; minor instances that could be trimmed' (anchor 4) rather than the every-token-earns-its-place level of anchor 5. | 4 / 5 |
Actionability | Guardrails are concrete ('Always cite sources with URLs', 'Limit results to the requested count (1-5)') and a specific source is named ('You scrape DuckDuckGo'), but no executable command, URL, or code example for the search is given, the 'curated industry data' fallback is never located or provided, and 'structured research reports' has no template or format. This matches anchor 3 (some concrete guidance but incomplete, missing key details) — above anchor 2 because guardrails and the named tool give real, if partial, direction. | 3 / 5 |
Workflow Clarity | The intended sequence (search web → fallback to curated data when offline → extract/summarize → produce cited report) is present but spread across the intro and Skills bullets with no explicit ordering, and the fallback condition is only implicit. There are no validation checkpoints (e.g. how to confirm a source URL resolves or that data is current), fitting anchor 3 (sequence present but checkpoints missing or implicit). | 3 / 5 |
Progressive Disclosure | For a sub-50-line skill the section structure (# role, ## Skills, ## Guardrails) is clean and flat with no nested references, which per the simple-skill note could merit a 5. However, the body promises a 'curated industry data' fallback resource that exists nowhere — not inline and not as a bundled reference file — so a claimed resource is undiscoverable, dropping it to anchor 4 (good structure, minor organization gaps). | 4 / 5 |
Total | 14 / 20 Passed |