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.
The body is a well-structured, highly actionable playbook — named tools, exact save paths, a clear phased workflow with fallback stacks, and honest-data rules — with no tokens spent explaining concepts Claude already knows. It is held back from excellence by duplication (repeated task questions, re-listed SEO endpoints) and a slightly misleading pointer to templates.md. Tightening those would move it to the top band.
Suggestions
Merge 'Task-Specific Questions' into 'Initial Assessment' — its four questions duplicate the confirmations already listed there verbatim in substance.
Trim the Phase 2 per-endpoint bullet lists to which metrics each profile field needs, since tool documentation and execution order already live in references/tool-reference.md.
Fix the templates.md pointer to describe what the file actually contains (quick-scan template, comparison table, positioning map, SWOT, changelog) rather than 'the full profile and summary templates', since the full profile template is inline in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational throughout with no education of known concepts, but it could be tightened: the ~140-line full profile template is inlined in the body, the 'Task-Specific Questions' section ('What competitor URLs should I profile? Quick scan or deep profile?') duplicates the 'Initial Assessment' confirmations, and Phase 2 re-lists every DataForSEO endpoint ('backlinks_summary', 'dataforseo_labs_google_ranked_keywords', etc.) that references/tool-reference.md's Recommended Execution Order already covers. | 3 / 5 |
Actionability | Concrete, executable guidance covers the common cases: named tools ('firecrawl_map → competitor URL'), exact save paths ('competitor-profiles/raw/<competitor-slug>/<YYYY-MM-DD>/scrapes/<page-name>.md'), per-page extraction tables, depth-level defaults ('Default to quick scan unless the user requests deep profiling'), and explicit no-estimation rules ('mark those metrics unavailable (never estimate them)'). As an instruction-only skill, full MCP call syntax is one clearly-signaled reference away. | 5 / 5 |
Workflow Clarity | Clear phased sequence (map site → scrape key pages → reviews → SEO data → synthesis → summary) with real checkpoints: save-before-extract ('Save each result to ... before extracting fields'), layered tool-failure fallbacks ('If Firecrawl is unavailable, use WebFetch in place of all Firecrawl calls'), a never-overwrite rule for raw data, and Phase 3 cross-referencing of claims. It stays below 5 because per-step error-recovery loops are delegated to tool-reference.md rather than stated in the workflow itself. | 4 / 5 |
Progressive Disclosure | Bundle structure is solid: two real reference files, both clearly signaled with stated purpose ('For full tool documentation, execution order, and error handling for both stacks, see references/tool-reference.md'), one level deep with no nested references. The inline full-profile template is defensible core output content, but the pointer 'For the full profile and summary templates: See references/templates.md' overpromises — templates.md contains the quick-scan and summary templates, not the full profile template. | 4 / 5 |
Total | 16 / 20 Passed |