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.

63

Quality

75%

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

Discovery

100%

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 an excellent skill description that clearly communicates what the skill does (diagnose organic traffic changes), when to use it (multiple explicit scenarios), and includes a comprehensive set of natural trigger terms. It uses proper third-person voice, names specific tools, and covers a well-defined niche with minimal conflict risk.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and scenarios: diagnosing organic traffic changes including drops, stalls, and unexpected wins, using specific tools (Ahrefs MCP, Search Console data), and covers specific contexts like algorithm updates, migrations, and competitor analysis.

3 / 3

Completeness

Clearly answers both 'what' (diagnose organic traffic changes using Ahrefs MCP and Search Console data) and 'when' (explicit 'Use this skill when...' clause with multiple specific scenarios, plus a dedicated 'Triggers on' list). Both dimensions are thoroughly covered.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say: 'traffic dropped', 'traffic decline', 'why is traffic down', 'lost rankings', 'algorithm update', 'post-migration traffic loss', 'organic decline'. The inclusion of 'stakeholders are panicking about analytics' is a creative and realistic trigger. These are highly natural phrases.

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 terminology, named data sources, and specific scenarios (algorithm updates, migrations) makes it very unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

50%

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-organized diagnostic framework with a solid layered methodology and useful pattern-matching tables. Its main weaknesses are the lack of concrete, executable tool calls (especially for Ahrefs MCP, which is a key differentiator of this skill) and some verbosity in sections that explain reasoning Claude could derive on its own. The workflow would benefit from explicit decision trees and validation checkpoints.

Suggestions

Add concrete Ahrefs MCP tool call examples (e.g., specific function names, parameters, and expected output interpretation) for each diagnostic layer to make the skill truly actionable.

Add explicit decision points in the workflow: e.g., 'If hypothesis is refuted at step 8, return to step 3 with the new evidence to re-localize' — this creates the feedback loop needed for diagnostic workflows.

Move the detailed failure patterns and/or the layer-by-layer descriptions into a reference file to keep the main SKILL.md leaner and improve progressive disclosure.

Trim explanations of concepts Claude already knows (e.g., what branded vs non-branded queries are, what robots.txt does) and replace with specific tool commands or data interpretation heuristics.

DimensionReasoningScore

Conciseness

The content is well-structured but somewhat verbose for an LLM skill. The 'When to use' and 'When NOT to use' sections overlap with the YAML description. The failure patterns section, while useful, is lengthy and some items state things Claude would already reason about (e.g., 'comparing wrong date ranges'). The diagnostic tables and layer framework add genuine value, but the overall document could be tightened by ~30%.

2 / 3

Actionability

The skill provides a strong conceptual framework and diagnostic methodology, 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 'check robots.txt changes' rather than 'use ahrefs_mcp.get_robots_txt(domain)' or similar. It describes what to check but not how to check it with the available tools.

2 / 3

Workflow Clarity

The 10-step workflow is clearly sequenced and logically ordered. However, it lacks explicit validation checkpoints and feedback loops. Steps like 'Validate the hypothesis' mention finding confirming/refuting evidence but don't specify what to do if the hypothesis is refuted (loop back to which layer?). For a diagnostic process that could lead to incorrect conclusions and wrong fixes, the absence of explicit decision points and error-recovery loops is a gap.

2 / 3

Progressive Disclosure

The skill references one external file (references/diagnosis-checklist.md) which is appropriate for the detailed layer-by-layer checklist. However, no bundle files were provided, so this reference is unverifiable. The main document itself is quite long (~200+ lines) and some content (like the detailed failure patterns or the full layer descriptions) could be split into reference files to keep the main skill leaner.

2 / 3

Total

8

/

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.