Content
86%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-engineered skill body: executable commands, explicit decision gates and done-when criteria, provenance labeling, and a clean one-level reference bundle. Remaining gains are small — deduplicate the content-gap-analysis handoff, move connector-tier details to the README, and add a brief recovery path for failed or conflicting data fetches.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanations of concepts Claude already knows, but the zero-dependency firecrawl paragraph (keyless tier, ~1,000 credits/mo, robots.txt pre-flight detail) duplicates the connector README it cites, and the content-gap-analysis handoff is stated three times (Skill Contract, Advanced Analysis Types, Next Best Skill). These are minor trimmable instances rather than the padding of the 3 anchor. | 4 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: copy-paste ready commands ("python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py\" scrape <competitor-url>", map with --limit 500, search with --tbs qdr:m), an exact write path (memory/research/competitor-analysis/YYYY-MM-DD-<topic>.md), worked example prompts, and per-step data-capture lists that cover the common cases. | 5 / 5 |
Workflow Clarity | The 8-step Instructions are clearly sequenced and bracketed by strong checkpoints: Decision Gates ("Stop and ask" vs "Continue silently" with enumerated conditions), a concrete "Done when" completion contract, and the Measured/User-provided/Estimated labeling rule. It misses the 5 anchor because there are no error-recovery feedback loops (e.g., what to do when a fetch is refused or tool data conflicts). | 4 / 5 |
Progressive Disclosure | The SKILL.md is a lean overview and all four bundle references (analysis-templates.md, battlecard-template.md, positioning-frameworks.md, example-report.md) exist, are one level deep (no nested links inside them), and are clearly signaled with one-line descriptions in a dedicated Reference Materials section. External cross-skill pointers are labeled with their purpose, making navigation easy. | 5 / 5 |
Total | 18 / 20 Passed |