Content Gap Analysis

This skill should be used when the user asks to "find content gaps", "what am I missing", "topics to cover", "content opportunities", "what do competitors wr...

Security Scan

The skill's claims, instructions, and requested credential (Ahrefs API key) are coherent for a content gap / SEO analysis tool; there is no install footprint or unexpected system access, though there are a few minor metadata inconsistencies and trust decisions around API keys to consider.

Purpose & Capability

Name and description match the behavior in SKILL.md and reference files: the skill performs keyword/topic/format gap analysis and explicitly describes using SEO tools, Search Console, and analytics. Requesting an Ahrefs API key is proportionate for competitor keyword data and is consistent with the stated purpose.

Instruction Scope

The instructions are an instruction-only workflow and stay within content-analysis scope (ask for site URL, competitor URLs, content inventory, or pull data from SEO tools/Search Console/Analytics). They do not instruct reading arbitrary local files or unrelated environment variables. Note: SKILL.md references multiple optional connectors (Search Console, Analytics, 'AI monitor') that could prompt the agent to request additional credentials or user data at runtime; those extra credential types are not declared in the metadata.

Install Mechanism

No install spec and no code files that execute on the host — lowest-risk posture. The skill is instruction-only so it does not download or write code to disk.

Credentials

The skill lists AHREFS_API_KEY as the primary credential which is appropriate for competitor keyword data. Minor inconsistency: metadata shows primaryEnv: AHREFS_API_KEY but requires.env is empty; the skill may therefore prompt for additional third-party credentials at runtime (Search Console, Google Analytics) even though they are not declared. Only provide API keys with appropriate (read-only/limited) scopes and via secure secret mechanisms.

Persistence & Privilege

always:false and user-invocable:true. The skill does not request permanent agent-wide privileges and does not attempt to modify other skills or system configuration. Autonomous invocation remains possible (platform default) but is not elevated here.

Assessment

This instruction-only skill appears to do what it says and doesn't install code. Before installing/providing credentials: (1) only supply an AHREFS_API_KEY if you want the agent to fetch competitor keyword data — prefer read-only/limited keys; (2) expect the agent to optionally ask for Search Console/Analytics access or CSV exports for richer analysis even though those env vars aren't declared—provide only necessary, least-privilege access or upload exports manually; (3) confirm how/where your API key will be stored by the platform and be ready to revoke it if unwanted access occurs. The main anomalies are a small metadata inconsistency (primaryEnv present but requires.env empty) and references to optional connectors; these are not malicious but worth clarifying with the skill author if you need tighter guarantees.

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

<details> <summary>Browse all 20 skills</summary>

Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis

Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator

Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher

Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager

Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management

</details>

Identifies content opportunities by analyzing gaps between a site's content and competitors'. Surfaces missing topics, untapped keywords, and content formats worth creating.

When to Use This Skill

• Planning content strategy and editorial calendar
• Finding quick-win content opportunities
• Understanding where competitors outperform you
• Identifying underserved topics in your niche
• Expanding into adjacent topic areas
• Prioritizing content creation efforts
• Finding GEO opportunities competitors miss

What This Skill Does

1. Keyword Gap Analysis: Finds keywords competitors rank for that you don't
2. Topic Coverage Mapping: Identifies topic areas needing more content
3. Content Format Gaps: Reveals missing content types (videos, tools, guides)
4. Audience Need Mapping: Matches gaps to audience journey stages
5. GEO Opportunity Detection: Finds AI-answerable topics you're missing
6. Priority Scoring: Ranks gaps by impact and effort
7. Content Calendar Creation: Plans gap-filling content schedule

How to Use

Basic Gap Analysis

Find content gaps between my site [URL] and [competitor URLs]

What content am I missing compared to my top 3 competitors?

Topic-Specific Analysis

Find content gaps in [topic area] compared to industry leaders

What [content type] do competitors have that I don't?

Audience-Focused

What content gaps exist for [audience segment] in my niche?

Data Sources

See CONNECTORS.md for tool category placeholders.

With ~~SEO tool + ~~search console + ~~analytics + ~~AI monitor connected: Automatically pull your site's content inventory from ~~search console and ~~analytics (indexed pages, traffic per page, keywords ranking), competitor content data from ~~SEO tool (ranking keywords, top pages, backlink counts), and AI citation patterns from ~~AI monitor. Keyword overlap analysis and gap identification can be automated.

With manual data only: Ask the user to provide:

1. Your site URL and content inventory (list of published content with topics)
2. Competitor URLs (3-5 sites)
3. Your current traffic and keyword performance (if available)
4. Known content strengths and weaknesses
5. Industry context and business goals

Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.

Instructions

When a user requests content gap analysis:

1. Define Analysis Scope

   Clarify parameters:

   ### Analysis Parameters
   
   **Your Site**: [URL]
   **Competitors to Analyze**: [URLs or "identify for me"]
   **Topic Focus**: [specific area or "all"]
   **Content Types**: [blogs, guides, tools, videos, or "all"]
   **Audience**: [target audience]
   **Business Goals**: [traffic, leads, authority, etc.]
   

2. Audit Your Existing Content

   Document total indexed pages, content by type and topic cluster, top performing content, and content strengths/weaknesses.

3. Analyze Competitor Content

   For each competitor: document content volume, monthly traffic, content distribution by type, topic coverage vs. yours, and unique content they have.

4. Identify Keyword Gaps

   Find keywords competitors rank for that you do not. Categorize into High Priority (high volume, achievable difficulty), Quick Wins (lower volume, low difficulty), and Long-term (high volume, high difficulty). Include keyword overlap analysis.

5. Map Topic Gaps

   Create a topic coverage comparison matrix across all competitors. For each missing topic cluster, document business relevance, competitor coverage, opportunity size, sub-topics, and recommended pillar/cluster approach.

6. Identify Content Format Gaps

   Compare format distribution (guides, tutorials, comparisons, case studies, tools, templates, video, infographics, research) against competitors and industry averages. For each gap, assess effort and expected impact.

7. Analyze GEO/AI Gaps

   Identify topics where competitors get AI citations but you do not. Document missing Q&A content, definition/explanation content, and comparison content. Score each by traditional SEO value and GEO value.

8. Map to Audience Journey

   Compare funnel stage coverage (Awareness, Consideration, Decision, Retention) against competitor averages. Detail specific gaps at each stage.

9. Prioritize and Create Action Plan

   Produce a final report with: Executive Summary, Prioritized Gap List (Tier 1 Quick Wins, Tier 2 Strategic Builds, Tier 3 Long-term), Content Calendar, and Success Metrics.

   Reference: See references/analysis-templates.md for detailed templates for each step.

Validation Checkpoints

Input Validation

• Your content inventory is complete or representative sample provided
• Competitor URLs identified (minimum 2-3 competitors)
• Analysis scope defined (specific topics or comprehensive)
• Business goals and priorities clarified

Output Validation

• Every recommendation cites specific data points (not generic advice)
• Gap analysis compares like-to-like content (topic clusters to topic clusters)
• Priority scoring based on measurable criteria (volume, difficulty, business fit)
• Content calendar maps gaps to realistic timeframes
• Source of each data point clearly stated (~~SEO tool data, ~~analytics data, ~~AI monitor data, user-provided, or estimated)

Example

Reference: See references/example-report.md for a complete example analyzing SaaS marketing blog gaps vs. HubSpot and Drift.

Advanced Analysis

Competitive Cluster Comparison

Compare our topic cluster coverage for [topic] vs top 5 competitors

Temporal Gap Analysis

What content have competitors published in the last 6 months that we haven't covered?

Intent-Based Gaps

Find gaps in our [commercial/informational] intent content

Tips for Success

1. Focus on actionable gaps - Not all gaps are worth filling
2. Consider your resources - Prioritize based on ability to execute
3. Quality over quantity - Better to fill 5 gaps well than 20 poorly
4. Track what works - Measure gap-filling success
5. Update regularly - Gaps change as competitors publish
6. Include GEO opportunities - Don't just optimize for traditional search

Reference Materials

• Analysis Templates — Detailed templates for each analysis step (inventory, competitor content, keyword gaps, topic gaps, format gaps, GEO gaps, journey, prioritized report)
• Gap Analysis Frameworks — Content audit matrices, funnel mapping, and gap prioritization scoring methodologies
• Example Report — Complete example analyzing SaaS marketing blog gaps vs. HubSpot and Drift

Related Skills

• keyword-research — Deep-dive on gap keywords
• competitor-analysis — Understand competitor strategies
• seo-content-writer — Create gap-filling content
• content-refresher — Refresh existing content to fill identified gaps
• internal-linking-optimizer — Identify and fix internal linking gaps
• backlink-analyzer — Analyze link gap opportunities
• memory-management — Track content gaps over time