Skip to content

aiskillstore/marketplace / skills/aaron-he-zhu/content-gap-analysis

content-gap-analysis

Verified

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. 内容缺口/选题规划

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-12T11:31:49.403Z",
    "slug": "aaron-he-zhu-content-gap-analysis",
    "source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/seo-geo/research/content-gap-analysis",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "1bf740121681aa2ca43302d1cf5bf97c17819a2348e94d454e5f9baa3a90a228",
    "tree_hash": "69c87aa89073e14bf48966ea76b1c2c9b3782fef1a3eeadba83d7ee762ac3b48",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "content-gap-analysis",
    "description": "Compares your content with competitors to identify missing keywords, topics, formats, journey stages, and prioritized editorial opportunities.",
    "summary": "Build an evidence-based content gap backlog and editorial calendar.",
    "icon": "📦",
    "version": "13.0.2",
    "author": "aaron-he-zhu",
    "license": "Apache-2.0",
    "category": "research",
    "tags": [
      "content-gap-analysis",
      "competitive-research",
      "seo",
      "editorial-planning",
      "geo"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "filesystem"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Most static alerts are false positives caused by Markdown fences, metadata URLs, relative documentation links, and ordinary scoring language. The command at SKILL.md:50 is a genuine medium-risk external command because a user-derived domain placeholder is passed without explicit validation or shell-safe argument handling.",
    "remediation": [
      {
        "issue": "The competitor-domain placeholder is unquoted in the connector command.",
        "suggestion": "Validate the domain against a strict hostname pattern and pass arguments without shell interpolation. Document private-network and option-injection rejection.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 28
          },
          {
            "file": "SKILL.md",
            "line_start": 28,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 36
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 36
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 50
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 91
          },
          {
            "file": "SKILL.md",
            "line_start": 91,
            "line_end": 95
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 97
          },
          {
            "file": "SKILL.md",
            "line_start": 97,
            "line_end": 101
          },
          {
            "file": "SKILL.md",
            "line_start": 101,
            "line_end": 103
          },
          {
            "file": "SKILL.md",
            "line_start": 103,
            "line_end": 107
          },
          {
            "file": "SKILL.md",
            "line_start": 107,
            "line_end": 107
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 38,
            "line_end": 38
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 46,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 50
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 56
          },
          {
            "file": "SKILL.md",
            "line_start": 107,
            "line_end": 107
          },
          {
            "file": "SKILL.md",
            "line_start": 117,
            "line_end": 117
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "blocker:references/gap-analysis-frameworks.md:95:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/gap-analysis-frameworks.md",
        "line_start": 95,
        "line_end": 96,
        "snippet": "4+ = strong | 2-3 = moderate | 0-1 = weak | negative = avoid"
      },
      {
        "id": "blocker:references/gap-analysis-frameworks.md:66:network-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "Network reconnaissance",
        "file": "references/gap-analysis-frameworks.md",
        "line_start": 66,
        "line_end": 66,
        "snippet": "| Awareness -> Interest | Bounce >70% | Missing next-step content |"
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 24,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 26,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 28,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 28,
        "line_end": 32,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 36,
        "snippet": "**Expected output**: a prioritized gap brief plus the standard handoff summary for `memory/research/"
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 36,
        "snippet": "- **Promotes**: durable keyword priorities, competitor facts, and pending strategy decisions to `mem"
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "**Trend-scout as a gap-discovery input (keyless)**: feed the multi-source trend scout — Google Trend"
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 50,
        "line_end": 50,
        "snippet": "**Keyless competitor-coverage inventory**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecr"
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 89,
        "snippet": "1. No competitor domains given and none inferable from `CLAUDE.md` or prior research → ask the user "
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 91,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 91,
        "line_end": 95,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 97,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 97,
        "line_end": 101,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 101,
        "line_end": 103,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 103,
        "line_end": 107,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 107,
        "line_end": 107,
        "snippet": "Write path: `memory/research/content-gap-analysis/YYYY-MM-DD-<topic>.md`; promote durable gap priori"
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "homepage: \"https://github.com/aaron-he-zhu/aaron-marketing-skills\""
      },
      {
        "id": "network:SKILL.md:13:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "metadata: {\"author\": \"aaron-he-zhu\", \"version\": \"17.0.0\", \"discipline\": \"seo-geo\", \"phase\": \"researc"
      },
      {
        "id": "filesystem:SKILL.md:38:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 38,
        "line_end": 38,
        "snippet": "- **Primary next skill**: [content-writer](../../build/content-writer/SKILL.md) when the prioritized"
      },
      {
        "id": "filesystem:SKILL.md:42:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 42,
        "line_end": 42,
        "snippet": "> Emit the standard shape from [skill-contract.md §Handoff Summary Format](../../../references/skill"
      },
      {
        "id": "filesystem:SKILL.md:46:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 46,
        "line_end": 46,
        "snippet": "Optional integrations: ~~SEO tool, ~~search console, ~~analytics, ~~AI monitor. Without tools, ask f"
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "**Trend-scout as a gap-discovery input (keyless)**: feed the multi-source trend scout — Google Trend"
      },
      {
        "id": "filesystem:SKILL.md:50:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 50,
        "line_end": 50,
        "snippet": "**Keyless competitor-coverage inventory**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecr"
      },
      {
        "id": "filesystem:SKILL.md:56:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 56,
        "snippet": "1. No competitor domains given and none inferable from `CLAUDE.md` or prior research → ask the user "
      },
      {
        "id": "filesystem:SKILL.md:107:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 107,
        "line_end": 107,
        "snippet": "Write path: `memory/research/content-gap-analysis/YYYY-MM-DD-<topic>.md`; promote durable gap priori"
      },
      {
        "id": "filesystem:SKILL.md:117:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 117,
        "line_end": 117,
        "snippet": "Primary: [content-writer](../../build/content-writer/SKILL.md)."
      }
    ],
    "finding_verdicts": [
      {
        "id": "blocker:references/gap-analysis-frameworks.md:95:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The text is an opportunity-score interpretation scale inside a content planning framework. It does not perform or instruct system reconnaissance."
      },
      {
        "id": "blocker:references/gap-analysis-frameworks.md:66:network-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line maps a website bounce-rate threshold to a funnel content gap. It contains no network discovery or reconnaissance instruction."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks open a Markdown example block containing a natural-language prompt. They do not invoke Ruby or a shell."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected text closes one Markdown prompt block and precedes another example. No executable command is present."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a Markdown fence around a natural-language request. It is formatting rather than shell backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks close a prompt example before the skill contract. There is no command interpreter or executable statement."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Inline backticks format the memory/research path in prose. The line describes expected output and does not execute a command."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Inline backticks identify documented memory file paths. They are not Ruby or shell command substitutions."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks format a linked script path and connector name in documentation. This line does not provide an executable shell command."
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.9,
        "reason": "The line explicitly instructs execution of a Python connector and leaves the user-derived competitor domain unquoted. Without strict validation and argument-safe invocation, crafted input could alter command arguments.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The detected range contains prose, relative skill links, and a Markdown fence. It does not contain Ruby backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks open a Markdown block containing a natural-language analysis request. No external command is invoked."
      },
      {
        "id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line closes a Markdown prompt block. It is documentation formatting with no executable content."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The backticks open another natural-language prompt example. They do not represent shell command substitution."
      },
      {
        "id": "external_commands:SKILL.md:97:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This closes a Markdown example and introduces a heading. No external process is started."
      },
      {
        "id": "external_commands:SKILL.md:101:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The fence contains a natural-language request for intent analysis. It is not executable shell or Ruby code."
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks close a Markdown prompt example. There is no command execution behavior."
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "Inline backticks format designated output paths in the save instructions. They do not execute those paths as commands."
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is repository homepage metadata. It is not used for a network request or data transfer."
      },
      {
        "id": "network:SKILL.md:13:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL appears in OpenClaw metadata as the public project homepage. No request or exfiltration behavior is attached."
      },
      {
        "id": "filesystem:SKILL.md:38:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The traversal sequence is a static relative Markdown link to another documented skill. It is not constructed from input or used for file access."
      },
      {
        "id": "filesystem:SKILL.md:42:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The sequence is a repository-relative documentation link to the handoff format. It does not read or write arbitrary files."
      },
      {
        "id": "filesystem:SKILL.md:46:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The parent-directory notation appears only in a static CONNECTORS.md link. There is no dynamic path resolution or filesystem operation."
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The parent-directory notation links to a known connector script and documentation. It is a fixed repository path, not user-controlled traversal."
      },
      {
        "id": "filesystem:SKILL.md:50:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The detected traversal text belongs to fixed repository documentation links on this line. The command uses CLAUDE_PLUGIN_ROOT rather than a parent-directory path."
      },
      {
        "id": "filesystem:SKILL.md:56:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The sequence is a static relative link to the keyword-research skill. It does not expose arbitrary file access."
      },
      {
        "id": "filesystem:SKILL.md:107:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The output is constrained to a documented memory directory, while the traversal sequence is only a fixed documentation link. No user-controlled traversal is specified."
      },
      {
        "id": "filesystem:SKILL.md:117:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a fixed relative Markdown link to the content-writer skill. It is not a filesystem traversal operation."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "**Keyless competitor-coverage inventory**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/connectors/firecr",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 50
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.9,
        "confidence_reasoning": "The line explicitly instructs execution of a Python connector and leaves the user-derived competitor domain unquoted. Without strict validation and argument-safe invocation, crafted input could alter command arguments."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 4,
    "total_lines": 384,
    "audit_model": "codex",
    "audited_at": "2026-07-12T11:31:49.403Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Find and Prioritize Content Gaps",
    "value_statement": "Content teams often lack evidence for what to publish next. This skill compares competitor coverage and turns missing opportunities into a prioritized editorial plan.",
    "seo_keywords": [
      "content gap analysis",
      "competitor content research",
      "SEO content planning",
      "keyword gap analysis",
      "editorial calendar",
      "GEO content analysis",
      "Claude",
      "Codex",
      "Claude Code"
    ],
    "actual_capabilities": [
      "Compares your site coverage with named competitor domains.",
      "Identifies missing keywords, topic clusters, content formats, and journey stages.",
      "Separates quick wins, strategic builds, and long-term opportunities.",
      "Labels evidence as measured, user-provided, estimated, or unavailable.",
      "Creates a prioritized backlog, editorial calendar, and success metrics.",
      "Assesses SEO and generative engine optimization content gaps."
    ],
    "limitations": [
      "Requires your site inventory and at least one competitor for a true gap analysis.",
      "Cannot verify search volume, traffic, or rankings without supplied data or connected tools.",
      "Estimated findings require validation before budget or publishing decisions.",
      "Does not replace raw keyword demand research or content production."
    ],
    "use_cases": [
      {
        "title": "Plan an SEO Backlog",
        "description": "Compare competitor coverage and rank missing topics by demand, relevance, effort, and competitive density.",
        "target_user": "SEO manager"
      },
      {
        "title": "Build an Editorial Calendar",
        "description": "Turn validated content gaps into a sequenced calendar with formats, owners, dependencies, and success measures.",
        "target_user": "Content strategist"
      },
      {
        "title": "Assess Market Coverage",
        "description": "Find journey, format, and evidence gaps that limit product education and conversion support.",
        "target_user": "Product marketing lead"
      }
    ],
    "prompt_templates": [
      {
        "title": "Basic Competitor Comparison",
        "prompt": "Find content gaps between [my domain] and [competitor domain]. Focus on [topic] for [audience]. Label every metric by evidence type.",
        "scenario": "Start with one competitor and a defined topic."
      },
      {
        "title": "Prioritized Opportunity List",
        "prompt": "Compare [my domain] with [competitor domains]. Rank missing keywords and topics as quick wins, strategic builds, or long-term opportunities.",
        "scenario": "Create a prioritized content backlog."
      },
      {
        "title": "Format and Journey Audit",
        "prompt": "Analyze content format and audience journey gaps across [domains]. Include guides, comparisons, tools, proof, retention content, and GEO opportunities.",
        "scenario": "Find gaps beyond keyword coverage."
      },
      {
        "title": "Advanced Calendar Plan",
        "prompt": "Use these inventories and performance exports: [inputs]. Score gaps, cite competitor evidence, and build a 12-week calendar with owners and success metrics.",
        "scenario": "Convert measured evidence into an execution plan."
      }
    ],
    "output_examples": [
      {
        "input": "Compare our payroll software blog with two named competitors.",
        "output": "Quick win: publish a payroll compliance checklist supported by competitor coverage and supplied demand data. Strategic build: create a state-by-state compliance cluster."
      },
      {
        "input": "Find missing decision-stage content for our analytics platform.",
        "output": [
          "Priority 1: comparison pages for the three most evaluated alternatives.",
          "Priority 2: a documented migration guide with technical requirements.",
          "Priority 3: customer proof organized by industry and use case."
        ]
      },
      {
        "input": "Create a four-week calendar from validated content gaps.",
        "output": "Week one addresses the strongest quick win. Weeks two and three build supporting cluster pages. Week four publishes a comparison asset."
      }
    ],
    "best_practices": [
      "Provide current site inventories, named competitors, audience details, and business goals.",
      "Attach a source and evidence label to every metric and recommendation.",
      "Validate estimated demand and competitor performance before assigning budget."
    ],
    "anti_patterns": [
      "Do not request a competitor-relative gap analysis without competitor or site coverage data.",
      "Do not treat model estimates as measured search or traffic data.",
      "Do not prioritize bare topics without competitor evidence and business relevance."
    ],
    "faq": [
      {
        "question": "What inputs are required?",
        "answer": "Provide your domain or content inventory, one to three competitor domains, the audience, topic scope, and business goals."
      },
      {
        "question": "Does this skill discover raw keyword demand?",
        "answer": "No. Use keyword research for demand discovery, then use this skill to compare coverage against competitors."
      },
      {
        "question": "Can it work without SEO tools?",
        "answer": "Yes, but metrics may remain user-provided, estimated, or unavailable. Supply exports when measured ranking and traffic data are important."
      },
      {
        "question": "How are opportunities prioritized?",
        "answer": "The framework considers demand, competitive coverage, business relevance, creation effort, and conversion potential."
      },
      {
        "question": "What does the final deliverable include?",
        "answer": "It includes key findings, a prioritized backlog, an editorial calendar, evidence labels, and success metrics."
      },
      {
        "question": "Does it include GEO analysis?",
        "answer": "Yes. It can identify missing definitions, questions, comparisons, evidence, and structures that support AI citation visibility."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "analysis-templates.md",
          "type": "file",
          "path": "references/analysis-templates.md",
          "lines": 88
        },
        {
          "name": "example-report.md",
          "type": "file",
          "path": "references/example-report.md",
          "lines": 48
        },
        {
          "name": "gap-analysis-frameworks.md",
          "type": "file",
          "path": "references/gap-analysis-frameworks.md",
          "lines": 130
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 118
    }
  ]
}
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall