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.
A well-structured, highly actionable skill body with concrete tooling and a clear phased workflow. Its main weakness is redundancy: the complete profile template is inlined while also living in templates.md, which inflates the token budget without adding guidance value.
Suggestions
Replace the inlined profile template (lines 198-338) with a short structural sketch and point to references/templates.md, eliminating the duplication with the bundle file.
Trim the generic 'Core Principles' (Facts Over Opinions, Structured and Comparable, Current Data, Honest Assessment) to the one non-obvious item (Untrusted Input / anti-injection) that Claude would not already assume.
Add an explicit scrape-failure feedback loop (e.g., retry once, then skip and note the gap in Raw Data Sources) to give the batch operation a validation checkpoint for failed page fetches.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient procedural guidance, but the full profile template is inlined verbatim (roughly 140 lines) while an identical templates.md reference also exists, and the generic 'Core Principles' (e.g. 'Facts Over Opinions,' 'Honest Assessment') could be trimmed. | 3 / 5 |
Actionability | Highly executable: names exact MCP tools (firecrawl_map, backlinks_summary, dataforseo_labs_google_ranked_keywords), exact file paths, and a per-page extraction table specifying which fields to pull from homepage, pricing, features, etc. | 5 / 5 |
Workflow Clarity | Clear phased sequence (Map → Scrape → Reviews → SEO → Synthesis) with a cross-reference validation checkpoint in synthesis ('check if their traffic/backlink profile supports that scale'), but lacks explicit error-recovery feedback loops for the batch scraping operations. | 4 / 5 |
Progressive Disclosure | Two real, well-signaled one-level-deep references ([references/tool-reference.md], [references/templates.md]) with clear navigation cues, but the full profile template is inlined in the body despite templates.md already holding it — content that should be separate is inline. | 4 / 5 |
Total | 16 / 20 Passed |