Content
78%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-built overview skill: lean, domain-specific guidance with an explicit scoring formula, banding thresholds, a sequenced workflow, and exemplary progressive disclosure to a single real reference file. Remaining gaps are minor: no inline worked example, no Ahrefs MCP tool specifics, and slight weight duplication between the table and formula.
Suggestions
Consolidate the scoring weights into one place — either the dimensions table or the formula block — to remove the duplicated 20%/30%/15%/20%/15% listing.
Add one short inline worked example of the opportunity formula applied to a single keyword (volume 1,200, relevance 80, etc.) so the scoring is executable without opening the reference file.
Name the specific Ahrefs MCP tools/endpoints to call in workflow step 2 (e.g., which MCP functions return organic keywords, top pages, and traffic estimates) to close the last actionability gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes SEO competence — the gap matrix, banding table, failure patterns, and output spec all earn their tokens with no generic SEO explanations. Minor trimmable redundancy remains: the scoring weights appear both in the dimensions table (20%/30%/15%/20%/15%) and again in the formula block, fitting anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Highly concrete for an instruction-only skill: an explicit 0-100 scoring formula, exact banding thresholds (80/60/40) with actions, a 10-step workflow with specifics (3-5 properties, top-10 cutoffs), and a 9-part output format with length guidance. It falls short of anchor 5 because there is no inline worked example of the formula applied and no Ahrefs MCP tool/endpoints named for the data pulls — minor gaps the reference file only partially bridges. | 4 / 5 |
Workflow Clarity | The 10-step workflow is clearly sequenced from competitor-set definition through hand-off, and includes validation steps ('Confirm they share intent and audience', 'Validate intent', unique-territory value audits). It is not 5 because there are no explicit feedback loops or checkpoints (e.g., what to do when SERP overlap is too low or keyword data is thin), though the analysis-only, non-destructive nature of the skill means the destructive-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview and the scoring detail (normalization rules, formula, three worked examples) is correctly split into a single one-level-deep reference, signaled both in workflow step 6 and in a 'Reference files' section with a one-line description. The referenced file exists, is 233 lines, and contains no nested references, matching anchor 5 ('clear overview with well-signaled one-level-deep references; content appropriately split'). | 5 / 5 |
Total | 17 / 20 Passed |