Agent skill

Content Gap Analysis

by aaron-he-zhu in aaron-he-zhu/aaron-marketing-skills

A skill your agent uses when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar…

Apache-2.0Auto-check passedMarketing & SEO

Install Content Gap Analysis

skills CLI
$ npx skills add aaron-he-zhu/aaron-marketing-skills --skill content-gap-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aaron-he-zhu/aaron-marketing-skills content-gap-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aaron-he-zhu/aaron-marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/seo-geo/survey/content-gap-analysis .claude/skills/content-gap-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
content-gap-analysis
GitHub stars
2.9k
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
669 words
Files
4 (incl. references)
Skills in repo
119
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar…

  • Works in 2 steps: No competitor domains given and none… → Your own domain/content inventory is…
  • The user asks to find content gaps
  • SKILL.md covers Quick Start, Skill Contract, Data Sources and Decision Gates, plus 6 more sections
  • Calls python3

What it does

Content Gap Analysis is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar opportunities. Not for raw keyword demand discovery — use keyword-research. 内容缺口/选题规划

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/analysis-templates.md`, `references/example-report.md` and `references/gap-analysis-frameworks.md`). Compatibility notes: Claude Code and compatible agent-skill hosts

It sits in Marketing & SEO, covering Keyword research and Content strategy. The repository describes itself as: 120 marketing skills as an AI marketing staff — plugin, portable skills, or an 8-bot team across 7 disciplines (narrative, SEO/GEO, social, email, paid, influencer, launch) on… The licence is Apache-2.0.

When your agent uses it

  • The user asks to find content gaps
  • Builds a competitor-relative coverage map of missing topics
  • Editorial-calendar opportunities

Example prompts

  • “find content gaps”
  • “竞品写了什么”
  • “还应该写什么”
  • “/content-gap-analysis”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. No competitor domains given and none inferable from CLAUDE.md or prior research → ask the user to name 1-3 competitors, OR offer to switch…
  2. Your own domain/content inventory is unavailable and cannot be fetched → ask for the site URL or a content list, since "gap" requires…

What it can do on your machine

Read from SKILL.md and the folder at commit 0ab9024. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code and compatible agent-skill hosts

    From compatibility in the SKILL.md frontmatter.

Context cost

Content Gap Analysis loads about 1.8k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 669 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aaron-he-zhu/aaron-marketing-skills at commit 0ab9024, republished under its Apache-2.0 licence (© aaron-he-zhu). 669 words, ~1,801 tokens.

Download SKILL.mdSave it as .claude/skills/content-gap-analysis/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
content-gap-analysis
description
Use when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar opportunities. Not for raw keyword demand discovery — use keyword-research. 内容缺口/选题规划
compatibility
Claude Code and compatible agent-skill hosts
slug
content-gap-analysis
displayName
Content Gap Analysis · 内容缺口
summary
内容缺口/选题规划
version
20.1.0
license
Apache-2.0
homepage
https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use
Use when finding content gaps between two domains, discovering missing topics, or identifying coverage holes versus competitors.
argument-hint
<your domain> <competitor domain>
metadata.author
aaron-he-zhu
metadata.version
20.1.0

Content Gap Analysis

Identifies content opportunities by comparing your site against competitors and scoring the gaps worth closing first.

Quick Start

Find content gaps between my site [URL] and [competitor URLs]
What content am I missing compared to my top 3 competitors?

Skill Contract

Expected output: a prioritized gap brief plus the standard handoff summary for memory/research/.

  • Reads: your domain, competitor domains, topic/content-type focus, audience, business goals, and any user-provided or tool content inventory.
  • Writes: a user-facing analysis and reusable summary.
  • Promotes: durable keyword priorities, competitor facts, and pending strategy decisions to memory/hot-cache.md, memory/open-loops.md, and memory/research/.
  • Done when: each prioritized gap names the competitor(s) that cover it and you don't; gaps are bucketed into Quick Wins / Strategic Builds / Long-term; and the deliverable includes a dated content calendar entry per Quick Win.
  • Primary next skill: content-writer when the prioritized gap list is approved.
Handoff Summary

Emit the standard shape from skill-contract.md §Handoff Summary Format.

Data Sources

Optional integrations: ~~SEO tool, ~~search console, ~~analytics, ~~AI monitor. Without tools, ask for site URL, content inventory, competitor URLs, and business goals. See CONNECTORS.md.

Trend-scout as a gap-discovery input (keyless): feed the multi-source trend scout — Google Trends RSS plus Hacker News and Reddit, via scripts/connectors/rss_monitor.py — to surface rising topics your competitors and you may both miss. Treat each hit as a candidate gap, then check it against your and competitor coverage in steps 5-7. Mark these signals Estimated. See CONNECTORS.md ~~trend database.

Keyless competitor-coverage inventory: python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecrawl.py" map <competitor-domain> --search "<topic>" --limit 1000 lists a competitor's URLs ordered by relevance to the topic — a fast Measured coverage inventory for steps 5-7 — and firecrawl.py scrape <url> reads any candidate page as rendered markdown. robots.txt is pre-flighted locally; a Disallow is refused per SECURITY.md §Scraping Boundaries. Firecrawl keyless free tier (~1,000 credits/mo). See scripts/connectors/README.md.

Decision Gates

Stop and ask — gap analysis is competitor-relative and cannot run on demand alone:

  1. No competitor domains given and none inferable from CLAUDE.md or prior research → ask the user to name 1-3 competitors, OR offer to switch to keyword-research for demand-side discovery instead.
  2. Your own domain/content inventory is unavailable and cannot be fetched → ask for the site URL or a content list, since "gap" requires knowing current coverage.

Continue silently — do not stop for: which 3-5 named competitors to deep-dive (pick the closest); missing optional tool data (mark Estimated/N/A and proceed); ambiguous topic scope (analyze the full overlap and flag the broadest clusters).

Show full SKILL.md (287 more words)Show less

Instructions

When a user requests content gap analysis:

  1. Define Analysis Scope — confirm your site, competitors, topic focus, content types, audience, and business goals.
  2. Audit Your Existing Content — map indexed pages, content types, topic clusters, winners, and weaknesses.
  3. Analyze Competitor Content — compare content volume, traffic, type mix, topic coverage, and unique assets.
  4. Identify Keyword Gaps — group gaps into High Priority, Quick Wins, and Long-term based on volume, difficulty, and relevance.
  5. Map Topic Gaps — compare topic-cluster coverage and recommend pillar / cluster approaches for missing themes.
  6. Identify Content Format Gaps — compare guides, tutorials, comparisons, case studies, tools, templates, video, and research.
  7. Analyze GEO / AI Gaps — identify missing Q&A, definition, and comparison content that competitors get cited for.
  8. Map to Audience Journey — compare Awareness, Consideration, Decision, and Retention coverage.
  9. Prioritize and Create Action Plan — deliver an Executive Summary, Prioritized Gap List (Quick Wins / Strategic Builds / Long-term), Content Calendar, and Success Metrics.

Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.

Quality bar: every gap names the competitor that covers it, its volume or traffic estimate, and why it is worth closing — never list a bare topic without that evidence.

Reference: See Analysis Templates for the compact templates used in each step.

Example

See references/example-report.md for a full SaaS marketing sample.

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

Save Results

Write path: memory/research/content-gap-analysis/YYYY-MM-DD-<topic>.md; promote durable gap priorities and competitor facts to memory/hot-cache.md. See Skill Contract §Save Results Template.

Reference Materials

Next Best Skill

Primary: content-writer.

© aaron-he-zhu, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in seo-geo/survey/content-gap-analysis of aaron-he-zhu/aaron-marketing-skills.

  • SKILL.md
  • references/analysis-templates.md
  • references/example-report.md
  • references/gap-analysis-frameworks.md

Open the folder on GitHubat commit 0ab9024

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aaron-he-zhu/aaron-marketing-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Content Gap Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Content Gap Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Content Gap Analysis this skillaaron-he-zhu/aaron-marketing-skills2.9k1 repos~1.8kAutomated safety check: PassApache-2.0
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
Strategic SEO PlanningAgriciDaniel/claude-seo19k5 repos~1.1kAutomated safety check: PassMIT
Blog ClusterAgriciDaniel/claude-blog2.3k1 repos~4.9kAutomated safety check: PassMIT
SEO Keyword ResearchVarnan-Tech/opendirectory674—~1.8kAutomated safety check: PassMIT

Similar skills

  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Strategic SEO Planning

    AgriciDaniel/claude-seo

    Builds an SEO strategy for a new or existing site: discovery, competitor analysis, site architecture, content plan, technical foundation and a four-phase roadmap.

    19k GitHub starsUsed in 5 repos~1.1k tokens
    Marketing & SEOAuto-check passed
  • Blog Cluster

    AgriciDaniel/claude-blog

    Semantic topic cluster planning and automated execution engine for claude-blog.

    2.3k GitHub starsUsed in 1 repo~4.9k tokens
    Marketing & SEOAuto-check passed
  • SEO Keyword Research

    Varnan-Tech/opendirectory

    SEO keyword research workflow for blog generation using Google Trends data.

    674 GitHub stars~1.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Keyword Research

    ViryaZheng/recomby-geo

    Discover, analyze, and prioritize keywords for SEO and GEO content strategies.

    458 GitHub stars~2.6k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

More from aaron-he-zhu/aaron-marketing-skills

All 119 skills in this repo
  • Ad Account Auditor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Auto-check passed
  • Ad Creative Builder

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix…

    2.9k GitHub starsUsed in 2 repos~2.2k tokens
    Auto-check passed
  • Ad Test Designer

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"…

    2.9k GitHub starsUsed in 2 repos~2.8k tokens
    Auto-check passed
  • Bid Strategy Planner

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions /…

    2.9k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Conversion Signal QA

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "QA my conversion tracking before launch", "check my UTMs / pixel / event firing", "set up a tracking pre-flight", or "set the dedup rule so Meta and…

    2.9k GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check passed
  • Creator Registry

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks "what did we pay this creator last time" or to "update the creator roster"; curates creator identity, rate, rights, exclusivity, compliance-event, and…

    2.9k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Questions about Content Gap Analysis

What does Content Gap Analysis do?

A skill your agent uses when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar…. Content Gap Analysis is an agent skill from aaron-he-zhu/aaron-marketing-skills. Use when the user asks to "find content gaps", "竞品写了什么", or "还应该写什么"; builds a competitor-relative coverage map of missing topics, keyword gaps, and editorial-calendar opportunities.

When should I use Content Gap Analysis?

Content Gap Analysis fits situations like: the user asks to find content gaps; builds a competitor-relative coverage map of missing topics; editorial-calendar opportunities.

How do I install Content Gap Analysis in Claude Code?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill content-gap-analysis -a claude-code`. Or copy the skill folder (seo-geo/survey/content-gap-analysis in aaron-he-zhu/aaron-marketing-skills) into .claude/skills/content-gap-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Content Gap Analysis in Codex?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill content-gap-analysis -a codex`. Or copy the skill folder (seo-geo/survey/content-gap-analysis in aaron-he-zhu/aaron-marketing-skills) into .agents/skills/content-gap-analysis in your project. Codex loads it when a task matches its description.

Can I use Content Gap Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill content-gap-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/content-gap-analysis, .gemini/skills/content-gap-analysis, .github/skills/content-gap-analysis and .opencode/skills/content-gap-analysis in your project.

What does Content Gap Analysis need to run?

Going by SKILL.md and its folder, Content Gap Analysis needs the command-line tools its instructions call (python3). Our summary lists: Python 3. Compatibility (from SKILL.md): Claude Code and compatible agent-skill hosts.

Does Content Gap Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Content Gap Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Content Gap Analysis use?

Content Gap Analysis is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Content Gap Analysis use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Content Gap Analysis?

Skills that share tags, products or a category with Content Gap Analysis: SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars), Strategic SEO Planning (AgriciDaniel/claude-seo, 19k stars) and Blog Cluster (AgriciDaniel/claude-blog, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Content Gap Analysis?

aaron-he-zhu (a GitHub user) maintains it in aaron-he-zhu/aaron-marketing-skills, which has 2,894 GitHub stars. The repository holds 119 skills in this directory. The repository was last updated on October 10, 2026.

Source: aaron-he-zhu/aaron-marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.