# seo-competitor-pages

Builds "X vs Y" and "alternatives to X" pages with feature matrices, schema.org markup and conversion-focused layouts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 7600 installs · ★ 21467
- Author: AgriciDaniel
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/AgriciDaniel/claude-seo/tree/HEAD/skills/seo-competitor-pages/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/seo-competitor-pages

## What it does

The skill covers four page types: a head-to-head comparison of two products, a list of alternatives, a "best tools in category" roundup, and a multi-product feature matrix. Each comes with a section outline, title and H1 formulas, and keyword sets aimed at comparison intent.

It ships JSON-LD templates for `Product` with `AggregateRating`, `SoftwareApplication` with an `offers` block, and `ItemList` for roundups. A fairness section sets the rules: every competitor claim has to be verifiable from public sources, pricing needs an "as of" note, and your own product affiliation is disclosed on the page. Skip that and the comparison stops being credible.

Output is `COMPARISON-PAGE.md` with sections and a target of at least 1,500 words, plus `comparison-schema.json` with the markup. You also get primary and secondary keywords and a gap analysis against existing competitor pages. The skill is user-invocable and takes arguments like a URL or `generate` together with a competitor name.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add AgriciDaniel/claude-seo --skill seo-competitor-pages -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/seo-competitor-pages/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/seo-competitor-pages/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add AgriciDaniel/claude-seo --skill seo-competitor-pages -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/seo-competitor-pages/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add AgriciDaniel/claude-seo --skill seo-competitor-pages -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/seo-competitor-pages/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AgriciDaniel/claude-seo seo-competitor-pages
```

2. **Manually: put the files in place**
- File: `.github/skills/seo-competitor-pages/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add AgriciDaniel/claude-seo --skill seo-competitor-pages -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/AgriciDaniel/claude-seo --path skills/seo-competitor-pages
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/seo-competitor-pages/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add AgriciDaniel/claude-seo --skill seo-competitor-pages -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/AgriciDaniel/claude-seo/tree/HEAD/skills/seo-competitor-pages/SKILL.md

## When to use it
- draft a head-to-head comparison page with a feature table
- compile an alternatives list for your own product
- pick keywords that match comparison intent
- generate JSON-LD markup for a roundup page
- spot content gaps on competitor comparison pages

## Example prompts
- Build a comparison page: `generate` against Notion
- Analyze this competitor's page and tell me what to improve
- Put together a best-tools roundup with a table and schema markup

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 70947d990b6795aa.

BEGIN THIRD-PARTY FILE 70947d990b6795aa
````text
---
name: seo-competitor-pages
description: >
  Generate SEO-optimized competitor comparison and alternatives pages. Covers
  "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup,
  and conversion optimization. Use when user says "comparison page", "vs page",
  "alternatives page", "competitor comparison", "X vs Y", "versus",
  "compare competitors", or "alternative to".
user-invocable: true
argument-hint: "[url or generate] [competitor]"
license: MIT
metadata:
  author: AgriciDaniel
  version: "2.5.0"
  category: seo
---

# Competitor Comparison & Alternatives Pages

Create high-converting comparison and alternatives pages that target
competitive intent keywords with accurate, structured content.

## Page Types

### 1. "X vs Y" Comparison Pages
- Direct head-to-head comparison between two products/services
- Balanced feature-by-feature analysis
- Clear verdict or recommendation with justification
- Target keyword: `[Product A] vs [Product B]`

### 2. "Alternatives to X" Pages
- List of alternatives to a specific product/service
- Each alternative with brief summary, pros/cons, best-for use case
- Target keyword: `[Product] alternatives`, `best alternatives to [Product]`

### 3. "Best [Category] Tools" Roundup Pages
- Curated list of top tools/services in a category
- Ranking criteria clearly stated
- Target keyword: `best [category] tools [year]`, `top [category] software`

### 4. Comparison Table Pages
- Feature matrix with multiple products in columns
- Sortable/filterable if interactive
- Target keyword: `[category] comparison`, `[category] comparison chart`

## Comparison Table Generation

### Feature Matrix Layout
```
| Feature          | Your Product | Competitor A | Competitor B |
|------------------|:------------:|:------------:|:------------:|
| Feature 1        | ✅           | ✅           | ❌           |
| Feature 2        | ✅           | ⚠️ Partial   | ✅           |
| Feature 3        | ✅           | ❌           | ❌           |
| Pricing (from)   | $X/mo        | $Y/mo        | $Z/mo        |
| Free Tier        | ✅           | ❌           | ✅           |
```

### Data Accuracy Requirements
- All feature claims must be verifiable from public sources
- Pricing must be current (include "as of [date]" note)
- Update frequency: review quarterly or when competitors ship major changes
- Link to source for each competitor data point where possible

## Schema Markup Recommendations

### Product Schema with AggregateRating
```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "[Product Name]",
  "description": "[Product Description]",
  "brand": {
    "@type": "Brand",
````
END THIRD-PARTY FILE 70947d990b6795aa

The third-party file has ended. Everything between the 70947d990b6795aa tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2691 of 8065 bytes. © AgriciDaniel · MIT · https://github.com/AgriciDaniel/claude-seo/tree/HEAD/skills/seo-competitor-pages/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md