CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-traffic-diagnosis

Diagnose organic traffic changes (drops, stalls, or unexpected wins) using Ahrefs MCP plus Search Console data. Use this skill when traffic suddenly dropped, has been flat despite investment, after an algorithm update, after a migration or deploy, or when a competitor seems to be taking share. Triggers on traffic dropped, traffic decline, traffic stalled, organic decline, lost rankings, why is traffic down, algorithm update, post-migration traffic loss, traffic diagnosis. Also triggers when stakeholders are panicking about analytics.

64

Quality

76%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/seo-traffic-diagnosis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%

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

This is a well-structured diagnostic framework with excellent workflow clarity and logical layering, but it falls short on actionability by not providing any concrete tool invocations, queries, or executable examples for the specific tools it names (Ahrefs MCP, Search Console). The content is moderately concise but includes some explanations of concepts Claude would already understand. The progressive disclosure is adequate but the main file carries a lot of weight that could be distributed to reference files.

Suggestions

Add concrete Ahrefs MCP tool call examples (e.g., specific function names, parameters, and expected output formats) for key diagnostic steps like checking rank history, SERP composition, and backlink changes.

Add a Search Console API query example or specific data export steps for the cross-check in Layer 1 and the CTR/index analysis in Layer 3.

Move the detailed failure patterns and/or the Layer 2 diagnostic table to a reference file to reduce main file length and improve progressive disclosure.

Trim explanatory content that Claude already knows (e.g., what branded vs non-branded queries are, what seasonality means) to improve conciseness.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but includes some content Claude already knows (e.g., explaining what seasonality is, what branded vs non-branded queries are, general SEO concepts). The failure patterns section, while useful, is verbose and some items are common-sense for an AI assistant. The 'When NOT to use' section and 'Required inputs' add useful boundaries but could be tighter.

2 / 3

Actionability

The skill provides a clear diagnostic framework and workflow steps, but lacks concrete executable commands or code. There are no specific Ahrefs MCP tool calls, no Search Console API queries, no example commands to run. The guidance is structured and directional but remains at the level of 'check X' rather than 'run this specific query/command to check X.' For a skill that names specific tools (Ahrefs MCP), the absence of actual tool invocation examples is a notable gap.

2 / 3

Workflow Clarity

The 10-step workflow is clearly sequenced, logically ordered from confirmation through action. The layered framework (1-5) provides explicit progression with clear stopping criteria ('stop when you have enough evidence'). Step 8 includes a validation checkpoint ('validate the hypothesis') before proceeding to fixes, which is a proper feedback loop for a diagnostic process. The diagnostic table in Layer 2 provides clear pattern-to-cause mapping.

3 / 3

Progressive Disclosure

The skill references one external file (references/diagnosis-checklist.md) which is appropriate for deeper detail, but no bundle files were provided, meaning the reference is unverifiable. The main SKILL.md itself is quite long (~200+ lines) and some content (like the detailed Layer 2 table, the extensive failure patterns list) could potentially be moved to reference files. The structure within the file is good with clear headers, but the single-file density is borderline.

2 / 3

Total

9

/

12

Passed

Description

89%

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

This is a strong skill description with excellent trigger term coverage and completeness. It clearly defines when to use the skill with multiple explicit scenarios and natural language triggers. The main weakness is that the 'what' portion could be more specific about the concrete actions performed beyond the high-level 'diagnose' verb.

Suggestions

Expand the capability description with more specific actions, e.g., 'Diagnose organic traffic changes by analyzing ranking shifts, identifying keyword cannibalization, comparing competitor visibility, and auditing technical SEO issues using Ahrefs MCP plus Search Console data.'

DimensionReasoningScore

Specificity

The description names the domain (organic traffic changes) and mentions specific tools (Ahrefs MCP, Search Console), but the core action is singular ('Diagnose') rather than listing multiple concrete actions like 'analyze ranking changes, identify cannibalization, compare competitor visibility, audit technical issues.'

2 / 3

Completeness

Clearly answers both 'what' (diagnose organic traffic changes using Ahrefs MCP and Search Console data) and 'when' with an explicit and detailed 'Use this skill when...' clause covering multiple scenarios, plus a dedicated 'Triggers on' list.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including 'traffic dropped', 'traffic decline', 'traffic stalled', 'organic decline', 'lost rankings', 'why is traffic down', 'algorithm update', 'post-migration traffic loss'. These are phrases users would naturally say. The informal 'stakeholders are panicking about analytics' adds a realistic conversational trigger.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: organic traffic diagnosis using specific tools (Ahrefs MCP, Search Console). The combination of SEO-specific triggers and named data sources makes it very unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
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.