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 skill body is well-structured, actionable, and clearly sequenced across scraping, SEO, and synthesis phases, with appropriate offloading of detail to reference files. It could improve by adding explicit error-recovery feedback loops and moving the large inlined output template into the templates reference.
Suggestions
Add an explicit validate→fix→retry feedback loop for batch scraping (e.g., what to do when a Firecrawl or DataForSEO call fails or returns empty data).
Move the full profile markdown template out of SKILL.md into references/templates.md and link to it, keeping only a condensed skeleton inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with actionable tables, tool calls, and a directory layout, though the 'Core Principles' section and a few explanatory lines ('Accurate profiles are useful profiles') state things Claude could infer and could be trimmed. | 4 / 5 |
Actionability | Provides concrete MCP tool names (firecrawl_map, backlinks_summary, dataforseo_labs_*), per-page extraction tables, a file layout, and a full output template; the `tool → input` notation is pseudo-call rather than real signatures, which are deferred to tool-reference.md. | 4 / 5 |
Workflow Clarity | Clear three-phase sequence (scrape → SEO → synthesize) with numbered steps and a cross-reference verification step in synthesis, plus a never-overwrite-prior-data safety rule; it lacks an explicit validate→fix→retry feedback loop for the batch scraping operation, which keeps it below 5. | 4 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level-deep references to real files (references/tool-reference.md, references/templates.md); the full profile template is inlined in the body rather than fully delegated to templates.md, a minor organization gap. | 4 / 5 |
Total | 16 / 20 Passed |