competitor-research — Claude Code skill: what it does, install
Guides competitor research for SEO, content, backlinks, and positioning. It identifies keyword gaps and analyzes top-ranking articles before publishing.
npx skills add kostja94/marketing-skills --skill competitor-research -a claude-codeWhat competitor-research does
The skill outlines a structured workflow for auditing competitors across organic search and content. It checks keyword overlap in SERPs, inspects competitor title and heading tags, and identifies backlink gaps where rivals earn links. For broader audits, it parses export files from tools like Ahrefs, SEMrush, or SimilarWeb.
When auditing a specific article, the agent fetches two or three top-ranking competitor pages. To do this, it depends on web fetching tools like mcp_web_fetch or WebSearch; without them, live page comparison fails. The audit highlights average word count, missing H2 sections, schema usage, and keyword placement in the opening copy.
Reports follow a modular format covering executive takeaways, a feature-by-feature matrix, and a SWOT breakdown. If your goal is strictly building a publication calendar, the repository directs you to the content-strategy skill instead.
What it helps with
- Identify keyword gaps and missing topics across competitor sites
- Compare H2 structure and word counts against top 10 search results
- Detect backlink opportunities where competitors earn links but you do not
- Generate structured competitor audit reports with SWOT and prioritized actions
Example prompts for the agent
- Audit our draft article against the top 3 ranking URLs for target keywords
- Analyze the pricing and positioning data in competitors.csv
- Find content gaps and missing H2 topics compared to competitor.com
How to install competitor-research
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill competitor-research -a claude-code2Manually: put the files in place
~/.claude/skills/competitor-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/competitor-research/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill competitor-research -a codex2Manually: put the files in place
.agents/skills/competitor-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill competitor-research -a cursor2Manually: put the files in place
.cursor/skills/competitor-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills competitor-research2Manually: put the files in place
.github/skills/competitor-research/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill competitor-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/seo/content/competitor-researchManually: put the files in place
.devin/skills/competitor-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill competitor-research -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about competitor-research
How do I install competitor-research in Claude Code?
Run npx skills add kostja94/marketing-skills --skill competitor-research -a claude-code in your terminal.
What does competitor-research do?
It guides AI agents through competitor keyword analysis, content length and structure comparisons, backlink gap detection, and SWOT report generation.
What tools does the skill require for live article audits?
It relies on mcp_web_fetch or WebSearch to pull live competitor pages. It can also ingest CSV or Excel exports and read project details from a local contextus.md file.
Source text
SKILL.md · MIT
--- name: competitor-research description: When the user wants to analyze competitors for SEO, content, backlinks, or positioning. Also use when the user mentions "competitor analysis," "competitor research," "competitor keywords," "competitor backlinks," "link gap," "content gap," "competitor content," "competitive analysis," or "competitor comparison." For content roadmap, use content-strategy. metadata: version: 1.2.1 --- # SEO Content: Competitor Research Guides competitor research for SEO, content, backlinks, and positioning. Use when planning content, auditing articles, building links, or evaluating market position. **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Research Types | Type | Purpose | Output | |------|---------|--------| | **Keyword/topic** | Topics competitors rank for; gaps | Keyword opportunities; content ideas | | **Content** | Structure, length, gaps vs top rankers | Length target; H2 structure; content gaps | | **Backlink** | Link profile; sites linking to competitors | Link gap; outreach targets | | **Pricing** | Competitor pricing, positioning | Pricing context; differentiation | | **SEO metrics** | Organic traffic, rankings vs competitors | Benchmark; opportunity areas | ## Competitor Keyword / Topic Analysis | Method | Practice | |--------|----------| | **Reverse engineering** | Analyze competitor titles, H1, URL; identify topics they rank for | | **SERP overlap** | Keywords with overlapping top-ranking pages → same cluster; #4–10 = opportunity | | **site: operator** | `site:competitor.com` to see indexed pages | | **Tool** | Ahrefs, Semrush—competitor keyword overlap, gap analysis | **Output**: Keyword opportunities; topics competitors cover that you don't. ## Competitor Content Analysis | Element | Check | |---------|-------| | **Word count** | Top 10 average; length target for your content | | **H2 structure** | Topics covered; structure to adopt | | **Content gaps** | What top rankers cover that you miss | | **Keyword placement** | Primary keyword in title, H1, first 100 words | | **Format** | Lists, tables, FAQ; match or improve | **Use when**: Auditing or creating articles; see **article-page-generator** for Research Phase integration. ### Competitor Article Fetch Workflow (for Article Analysis) When analyzing or auditing a single article, use this lightweight workflow to obtain competitor articles: 1. **Obtain URLs**: From the user, relevant Contextus competitor or content modules, or web search for `"[target keyword]"` to find top-ranking pages 2. **Fetch content**: Use mcp_web_fetch or WebSearch to fetch 2–3 top-ranking pages 3. **Analyze**: Word count, H2 structure, keyword placement, content gaps, CTA, schema 4. **Output**: Competitor URLs, brief structure comparison, content gaps, length target, keyword opportunities **Output format**: Competitor URLs; word count and H2 structure per URL; content gaps vs your article; recommended length target; keyword opportunities (terms top rankers use that your article misses). ## Competitor Backlink Analysis | Action | Purpose | |--------|---------| | **Compare profiles** | Your backlinks vs competitors | | **Link gap** | Sites linking to competitors but not you | | **Opportunity** | Outreach to those sites; content they might link to | **Tools**: Ahrefs, Semrush—Link Intersect, competitor backlink reports. See **backlink-analysis**. ## Competitor Pricing | Use | Practice | |-----|----------| | **Positioning** | Where you sit vs competitors | | **Differentiation** | Value prop when price differs | | **Alternatives pages** | Who to include; how to position | See **pricing-strategy**, **alternatives-page-generator**. ## Data Sources | Source | Use | |--------|-----| | **SimilarWeb** | Traffic, engagement, traffic sources by domain | | **Ahrefs** | Competitor domains, backlinks, DR | | **SEMrush** | Organic competitors, traffic share | | **GA** | Referral traffic, acquisition by source | | **PostHog** | Competitor feature usage (if tracked) | ## Report Workflow 1. **Parse** — Read Excel/CSV, infer domain, visits, traffic sources, etc. from headers 2. **Enrich** — Web search, visit competitor sites; read root `contextus.md` if present 3. **Build** — Structure data for report 4. **Generate** — Output report in chosen format ## Output Format - **Competitors** identified - **Research type** (keyword, content, backlink, pricing) - **Findings** (gaps, opportunities, benchmarks) - **Recommendations** (content to create, links to pursue, positioning) ### Report Structure Reference | Section | Content | |---------|---------| | Executive Summary | Key findings (top 3), top 3 recommendations | | Competitor Overview | Competitor, category, market position, key strength | | Product Comparison | Feature/capability vs Us vs Competitors | | SWOT Analysis | Our strengths/weaknesses/opportunities/threats; competitor deep dives | | Marketing & Messaging | Value prop, target audience, key channels | | Gaps & Opportunities | Gap, opportunity, priority | | Prioritized Recommendations | Recommendation, impact, effort, owner | ## Related Skills - **keyword-research**: Competitor reverse; keyword discovery - **article-page-generator**: Competitor article analysis in Research Phase - **content-strategy**: Competitor analysis for topic mapping - **content-optimization**: Competitor length and structure as reference - **backlink-analysis**: Competitor backlink comparison; link gap - **seo-monitoring**: Competitive comparison; organic vs competitors - **alternatives-page-generator**: Competitor selection; comparison framing - **migration-page-generator**: Competitor migration paths - **pricing-strategy**: Competitor pricing context - **affiliate-marketing**: Find affiliates promoting competitors - **directories**: Competitor info for directory submissions
© kostja94 · MIT · kostja94/marketing-skills