CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-ahrefs

Ahrefs API analyst (extension). Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server. Pairs with seo-backlinks for multi-source confidence weighting.

57

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./extensions/ahrefs/skills/seo-ahrefs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and actionable, with a clean routing table, concrete install and cost commands, and a good MCP pre-flight check. Its weaknesses are time-sensitive version/date detail in the body that penalizes conciseness, and a batch cost-guardrail workflow missing validation checkpoints, which caps workflow clarity at 3.

Suggestions

Move the pinned version and "Package check (2026-07-10)" date-sensitive lines out of the body (they already exist in the compatibility frontmatter field) or into a clearly labeled section, instead of repeating them in the intro.

Add a validation checkpoint to the batch cost workflow, e.g. compare the estimate against a budget threshold and abort/confirm with the user before running, then verify actual cost against the estimate afterwards.

Trim the redundant restatement of the tested version ("via the tested @ahrefs/mcp@0.0.11 server") and the seo-dataforseo comparison line to tighten token usage.

DimensionReasoningScore

Conciseness

The body is largely lean, but time-sensitive information penalizes conciseness per the guidelines: "Live Ahrefs data via the tested `@ahrefs/mcp@0.0.11` server" plus "Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version" repeat a pinned version and a specific date outside any 'old patterns'/'deprecated' section, and "This is the same workflow the seo-dataforseo skill uses" could be trimmed. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, which requires only minor trimmable instances and no misplaced time-sensitive data.

3 / 5

Actionability

Concrete, executable guidance dominates: install commands ("Run `extensions/ahrefs/install.sh` (Linux/macOS) or `install.ps1` (Windows)"), a specific cost-estimate command ("`${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo` run dataforseo_costs.py"), and a routing table mapping exact commands to outputs. As an instruction-only skill this matches 'Mostly executable guidance; concrete code or commands with minor gaps' — not 5 because actual Ahrefs MCP tool invocation details and the batch command forms are only implied.

4 / 5

Workflow Clarity

The MCP-availability pre-flight check is a good checkpoint, but the batch workflow ("Before running a batch (>= 50 URLs): 1. Estimate cost... 2. Surface the estimate... 3. Log actual cost") lacks any validation/verification step — no budget threshold to compare against, no abort/confirm decision point, and no actual-vs-estimate feedback loop. Per the guidelines, a batch operation without validation caps workflow clarity at 3, which takes precedence over the simple-skill exception; it stays at 3 rather than 2 because the sequence itself is clearly listed.

3 / 5

Progressive Disclosure

The body is under 50 lines with no content that belongs in separate files: five well-organized sections (Prerequisites, Routing, Output conventions, Cross-skill delegation, Cost guardrails) each stay lean, and the few external pointers (install scripts, cost-tracker script, sibling skills) are one level deep and clearly signaled. Per the guidelines, a sub-50-line skill with no need for external references scores 5 with well-organized sections; nothing here is buried or nested.

5 / 5

Total

15

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and domain-anchored, listing four concrete Ahrefs data capabilities in third person with minor coverage gaps. Its main weakness is the missing explicit 'Use when...' trigger clause, which caps completeness, and trigger-term coverage lacks common synonyms like "SEO" or "link building".

Suggestions

Add an explicit trigger clause, e.g. "Use when the user needs Ahrefs backlink, referring-domain, or organic keyword data, or mentions Ahrefs or a site's link profile."

Name the metrics capabilities (domain/URL rating, organic traffic estimates) so the 'what' covers all four routing commands.

Include a few natural synonyms ("SEO", "link building", "link profile", "rankings") to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Reads referring domains, backlinks, organic keywords, and content explorer data" plus "Pairs with seo-backlinks for multi-source confidence weighting" lists several concrete actions in third person, closely matching the anchor 'Lists several specific actions; minor gaps in coverage'. It is not a 5 because coverage has a minor gap — the domain/URL rating and organic traffic estimate metrics are not named — and not a 3 because it enumerates four concrete capabilities rather than only 1-2.

4 / 5

Completeness

The 'what' is clear ("Reads referring domains, backlinks, organic keywords, and content explorer data via the tested @ahrefs/mcp@0.0.11 server"), but there is no explicit 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. The seo-backlinks pairing only weakly implies when to use it, so it cannot reach 4.

3 / 5

Trigger Term Quality

Natural SEO terms like "backlinks", "referring domains", "organic keywords", and "content explorer" are present and users would plausibly say them, matching 'Good keyword coverage; a few natural terms missing'. It falls short of 5 because common variations such as "SEO", "link building", "link profile", "domain rating", and "rankings" are absent.

4 / 5

Distinctiveness Conflict Risk

"Ahrefs API analyst (extension)" carves out a clear niche anchored to a named tool, and the explicit seo-backlinks pairing clarifies routing, matching 'Mostly distinct; minor overlap risk with closely related skills'. It is not a 5 because sibling SEO skills (seo-backlinks, seo-dataforseo) overlap on generic terms like "backlinks" and "organic keywords", leaving minor conflict risk.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
AgriciDaniel/claude-seo
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.