Find keywords competitors rank for that the target property does not, and prioritize them by opportunity. Uses Ahrefs MCP for keyword and competitor data. Use this skill when planning content investment, identifying quick wins, building a content calendar against a competitor set, or scoping a market entry. Triggers on keyword gap, content gap, competitor keywords, opportunity keywords, what should we target, where are competitors winning, keyword opportunity. Also triggers when planning content for a new market or after losing organic share to a specific competitor.
63
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/seo-keyword-gap-audit/SKILL.mdQuality
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 what the skill does (competitive keyword gap analysis using Ahrefs MCP), when to use it (content planning, quick wins, market entry, competitor analysis), and includes a comprehensive set of natural trigger terms. It uses proper third-person voice throughout and provides enough specificity to be easily distinguishable from other content or SEO-related skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: finding keywords competitors rank for that the target property does not, prioritizing by opportunity, using Ahrefs MCP for data. Clearly describes the analytical workflow rather than vague language. | 3 / 3 |
Completeness | Clearly answers both 'what' (find competitor keywords the target doesn't rank for, prioritize by opportunity using Ahrefs MCP) and 'when' (explicit 'Use this skill when...' clause plus detailed 'Triggers on...' list covering multiple scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'keyword gap', 'content gap', 'competitor keywords', 'opportunity keywords', 'what should we target', 'where are competitors winning', 'quick wins', 'content calendar', and scenario-based triggers like 'losing organic share'. These are phrases users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: competitive keyword gap analysis via Ahrefs MCP. The specific tool mention (Ahrefs), the focus on competitor keyword gaps, and the detailed trigger terms make it very unlikely to conflict with other SEO or content 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 SEO skill with a clear framework (gap matrix) and scoring methodology, but it falls short on actionability by not including any specific Ahrefs MCP tool calls, concrete data examples, or executable queries. The content is moderately verbose with some sections that could be trimmed or offloaded to reference files, and the workflow lacks explicit validation checkpoints despite involving multi-step data operations.
Suggestions
Add specific Ahrefs MCP tool call examples (e.g., exact function names, parameters, and sample responses) so Claude knows precisely how to pull keyword and competitor data.
Add validation checkpoints to the workflow, such as verifying SERP overlap after defining the competitor set (step 1) and confirming data completeness after pulling keyword data (step 2).
Move the detailed failure patterns and gap matrix explanation into a reference file to reduce the main skill's token footprint while preserving the information.
Include a worked example showing a small keyword gap analysis from raw Ahrefs data through scoring to final prioritized output.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably well-structured but includes some unnecessary content like the 'When to use' and 'When NOT to use' sections that are largely redundant with the description, and the gap matrix explanation is somewhat verbose for Claude. The failure patterns section, while useful, is lengthy and some items are common-sense SEO knowledge. | 2 / 3 |
Actionability | The workflow provides a clear sequence of steps and the scoring formula is concrete, but there are no executable code examples, no specific Ahrefs MCP tool calls or function signatures, and no concrete examples of actual keyword data or API queries. For a skill that depends on Ahrefs MCP, the absence of specific tool invocation patterns is a significant gap. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and logical, but lacks explicit validation checkpoints. There's no verification step after pulling data (e.g., confirming sufficient keyword overlap), no checkpoint after building the gap matrix, and no feedback loop for when the competitor set turns out to be wrong despite the failure pattern warning about it. | 2 / 3 |
Progressive Disclosure | The skill references `references/opportunity-scoring-rubric.md` and other skills appropriately, but no bundle files were provided, meaning the referenced file doesn't exist. The main document itself is quite long (~200 lines) with detailed sections like the gap matrix framework and failure patterns that could be split into reference files. The output format section is also quite detailed for inline content. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
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.