Content
50%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 highly actionable, with named tools, exact file paths, extraction tables, and a clearly sequenced research process, but it is noticeably padded: the full profile template is duplicated inline despite a templates reference, the question checklists are repeated, and general principles restate known behavior. Validation checkpoints for batch scraping and SEO pulls are missing.
Suggestions
Move the full profile template out of SKILL.md into references/templates.md and keep only a section outline plus the reference link inline.
Merge 'Task-Specific Questions' into 'Initial Assessment' (they ask nearly the same things) and trim 'Core Principles' to only non-obvious guidance such as the snapshot/dating rules.
Add validation checkpoints to the workflow: verify each scrape succeeded before extracting fields, and check DataForSEO responses are non-empty before synthesizing, with a retry/skip path for failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~420-line body has several padded or duplicated sections: a ~140-line full profile template is inlined even though the body itself points to references/templates.md for 'full profile and summary templates'; 'Task-Specific Questions' repeats the 'Initial Assessment' checklist almost verbatim; and 'Core Principles' explains behavior Claude already knows (e.g., 'Don't exaggerate competitor weaknesses... Accurate profiles are useful profiles'). This matches anchor 2 (noticeably verbose, several unnecessary sections) rather than anchor 3, though most operational content (extraction tables, save paths, tool names) does earn its place, keeping it above anchor 1. | 2 / 5 |
Actionability | The guidance is consistently concrete: named MCP tools (firecrawl_map, backlinks_summary, dataforseo_labs_google_ranked_keywords), exact save paths (competitor-profiles/raw/<competitor-slug>/<YYYY-MM-DD>/scrapes/<page-name>.md), per-page extraction tables, slug/date conventions, and an explicit quick-scan vs deep-profile scope. It falls just short of anchor 5 because example call payloads are deferred to references/tool-reference.md rather than shown inline. | 4 / 5 |
Workflow Clarity | The phased sequence (initial assessment, persist raw data, scrape, SEO, synthesis, output, summary) is explicit and well ordered, but this is a batch operation ('Parallelize scraping — scrape all competitors' homepages simultaneously') with no validation or feedback loops — nothing on verifying a scrape succeeded before extracting fields or handling empty/failed DataForSEO responses. Per the rubric's cap for batch operations without validation, workflow clarity cannot exceed 3. | 3 / 5 |
Progressive Disclosure | Both references (references/templates.md, references/tool-reference.md) exist, are one level deep, and are clearly signaled in the body. However, ~140 lines of the full profile template are inlined in SKILL.md where a templates reference already exists — content that clearly should be separate is inline — which matches anchor 3 rather than anchor 4. | 3 / 5 |
Total | 12 / 20 Passed |