Content
71%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 skill with a clear 8-phase workflow, concrete scoring formulas, runnable connector commands, and exemplary progressive disclosure into a real, verifiable reference bundle. The main cost is token efficiency: the Data Sources prose, funnel-stage definitions, and attribution asides restate things Claude knows or that belong in the reference files.
Suggestions
Trim the Data Sources section to the two commands plus one-line caveats; move the striking-distance GSC recipe and API rowLimit details into references/instructions-detail.md.
Delete the attribution aside '(Impact×Confidence + funnel-stage scoring adapted from an external SEO-ops competitive analysis.)' and compress the BOFU/MOFU/TOFU pattern lists, which Claude can infer from a few examples.
Keep the evidence-labeling rules but merge the two overlapping sentences in the Instructions section (line 69) that both state the Unknown-with-reason rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient but includes unnecessary padding: a long prose Data Sources section ("~1,000 credits/mo, no key needed", the striking-distance paragraph), an attribution aside — "(Impact×Confidence + funnel-stage scoring adapted from an external SEO-ops competitive analysis.)" — and explanation of concepts Claude already knows (BOFU/MOFU/TOFU funnel definitions, the four standard intent categories). Not a 2 because nearly every sentence carries operational content; not a 4 because several of these passages could clearly be trimmed or moved to instructions-detail.md. | 3 / 5 |
Actionability | The body gives concrete, runnable commands (the suggest.py/firecrawl.py/pageviews.py invocations with flags), an explicit formula — "Opportunity = (Volume × Intent Value) / Difficulty, with Intent Value 1 / 1 / 2 / 3" — a defined save path, and an enforced quality bar ("every recommendation includes at least one specific number"). Not a 5 because the eight phases themselves are one-line directives whose executable detail is deferred to references, leaving minor gaps inline. | 4 / 5 |
Workflow Clarity | The eight phases are explicitly sequenced and announced ("run eight phases and announce each as [Phase X/8: Name]"), with a 'Done when' contract serving as an end-of-run checklist and evidence-labeling rules (Measured/Calculated/Unknown, NOT_SCORED on unknown decision-critical inputs) acting as per-field checkpoints. Not a 5 because there are no explicit per-phase validation or fix-and-retry loops; this is a read-only research workflow, so the destructive-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview: detail is split into five real bundle files (instructions-detail.md, example-report.md, keyword-intent-taxonomy.md, topic-cluster-templates.md, keyword-prioritization-framework.md — all present in references/), each linked one level deep with descriptive labels in the Reference Materials section, plus a dedicated example report. Cross-skill links (competitor-analysis, skill-contract.md) are clearly signaled and structural, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 16 / 20 Passed |