CtrlK
BlogDocsLog inGet started
Tessl Logo

seo-content-gap-audit

Audit content gaps and decay using Ahrefs MCP data: missing topics, thin coverage, outdated content, and decaying pages. Use this skill when planning a content roadmap, refreshing a stale catalog, building topical authority, or identifying which existing pages need update versus replacement. Triggers on content gap, content audit, content refresh, content roadmap, decaying content, content decay, topical authority, what topics should we cover, where is competitor content stronger. Also triggers when organic traffic is flat despite consistent publishing.

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-content-gap-audit/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 articulates specific capabilities (auditing content gaps, decay, thin coverage, outdated pages), specifies the data source (Ahrefs MCP), and provides comprehensive trigger guidance with both use-case scenarios and explicit keyword triggers. The description is well-structured, uses third person voice appropriately, and includes a creative situational trigger ('organic traffic is flat despite consistent publishing') that captures a real user pain point.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: audit content gaps, identify missing topics, thin coverage, outdated content, decaying pages, and determine update versus replacement. Also specifies the data source (Ahrefs MCP data).

3 / 3

Completeness

Clearly answers both 'what' (audit content gaps and decay using Ahrefs MCP data across multiple dimensions) and 'when' (explicit 'Use this skill when...' clause plus a detailed 'Triggers on' list covering numerous scenarios).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'content gap', 'content audit', 'content refresh', 'content roadmap', 'decaying content', 'topical authority', 'what topics should we cover', 'where is competitor content stronger', and the situational trigger about flat organic traffic despite publishing.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: content gap/decay auditing specifically using Ahrefs MCP data. The combination of SEO content auditing, Ahrefs as the data source, and specific triggers like 'decaying content' and 'topical authority' make it 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 strategic skill with a clear framework (4 categories), a useful decision matrix, and comprehensive failure patterns. However, it falls short on actionability—it never shows actual Ahrefs MCP tool calls or concrete commands, making it more of a conceptual guide than an executable skill. The referenced bundle file doesn't exist, and the workflow lacks validation checkpoints for what is essentially a multi-step audit with consequential actions.

Suggestions

Add concrete Ahrefs MCP tool call examples (e.g., specific function names, parameters, and expected response structures) for each data-pull step in the workflow.

Add validation checkpoints to the workflow, such as 'Verify inventory completeness: confirm all URLs have organic click data before proceeding to classification' and 'Cross-check classification counts against total inventory to ensure no pages are unclassified.'

Create the referenced `references/content-decision-matrix.md` bundle file, or remove the reference and expand the inline decision matrix with worked examples.

Trim the failure patterns section to the 4-5 most critical anti-patterns and reduce the framework preamble about Similarweb/Semrush to a single sentence, since the skill is focused on Ahrefs MCP.

DimensionReasoningScore

Conciseness

The skill is reasonably well-structured but includes some unnecessary verbosity. The 'When to use' / 'When NOT to use' sections are helpful but could be tighter. The multi-paragraph explanation of Similarweb/Semrush in the framework section adds context Claude doesn't need for execution. The failure patterns section, while useful, is lengthy and some items are common-sense for Claude.

2 / 3

Actionability

The skill provides a clear framework and decision matrix, but lacks concrete executable guidance. There are no specific Ahrefs MCP tool calls, API commands, or code examples showing how to actually pull the data. It describes what to pull (e.g., 'Ahrefs Content Explorer', 'competitor top pages') but never shows the actual MCP function calls or parameters needed to execute the workflow.

2 / 3

Workflow Clarity

The 10-step workflow is clearly sequenced and logically ordered, but lacks validation checkpoints. There's no explicit verification step after pulling inventory data, no check that competitor data is complete before classification, and no feedback loop for when classification is ambiguous. For an audit involving potentially destructive actions (prune, redirect), the absence of validation gates is a notable gap.

2 / 3

Progressive Disclosure

The skill references one external file (references/content-decision-matrix.md) and cross-references other skills appropriately in the 'When NOT to use' section. However, the bundle has no files, so the referenced content-decision-matrix.md doesn't exist. The inline action decision matrix partially compensates, but the content is somewhat monolithic—the framework categories, failure patterns, and output format sections could benefit from being split or the main body trimmed with references to supporting files.

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.