/prd-v09-alternatives-pages
Generate "X vs Y" and "Alternative to X" SEO/CRO pages targeting competitive search intent during PRD v0.9 Go-to-Market. Triggers on requests to build comparison pages, target competitive search traffic, or when user asks "build alternatives pages", "X vs Y page", "competitor
$ npx -y skills add mattgierhart/PRD-driven-context-engineering --skill prd-v09-alternatives-pages --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/prd-v09-alternatives-pages
Context preview
The summary Claude sees to decide when to auto-load this skill.
Generate "X vs Y" and "Alternative to X" SEO/CRO pages targeting competitive search intent during PRD v0.9 Go-to-Market. Triggers on requests to build comparison pages, target competitive search traffic, or when user asks "build alternatives pages", "X vs Y page", "competitor
SKILL.md
prd-v09-alternatives-pages.SKILL.mdname: prd-v09-alternatives-pages
description: >
Generate "X vs Y" and "Alternative to X" SEO/CRO pages targeting competitive search intent
during PRD v0.9 Go-to-Market. Triggers on requests to build comparison pages, target
competitive search traffic, or when user asks "build alternatives pages", "X vs Y page",
"competitor comparison page", "we're better than X page", "capture branded search",
"competitive SEO". Outputs SCR-ALT-* page specs and GTM-* channel entries.
context: fork
allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- WebSearch
- WebFetch
execution_modes:
default: standard
supports: [quick, standard, deep]
Alternatives Pages (Competitive Comparison SEO/CRO)
Position in workflow: v0.9 AEO Audit → **v0.9 Alternatives Pages** → v0.9 Launch Metrics
Execution Mode
Default is **standard**. See [`.claude/rules/08-skill-execution-modes.md`](../../rules/08-skill-execution-modes.md) for selection logic.
| Mode | What this skill produces | |------|--------------------------| | **quick** | 2 pages for the single most-searched competitor (X-vs-us + alternative-to-X) | | **standard** | 5–10 pages covering top 3–5 competitors with both variant types; CRO copy + comparison table | | **deep** | Full competitor portfolio (10+ competitors); plus multi-way comparison ("X vs Y vs Z"); page-level A/B test plan; SEO targeting per page |
What This Does
Produces a portfolio of high-intent comparison pages — `/x-vs-us` and `/alternative-to-x` — that capture buyers actively searching for competitor names + comparison/alternative keywords. These are the highest-converting acquisition surface for B2B SaaS and many consumer products: the buyer has already passed awareness and is in active evaluation.
The pages must be **fair, credible, and conversion-oriented** — acknowledging where the competitor wins, claiming where you win, with social proof and a clear "when to pick each" guide. Aggressive trashing fails: buyers fact-check, and one false claim loses the page.
How It Works
1. **Source the competitor list** — From the AEO Audit's comparison gaps and v0.2 CFD- competitive landscape. Rank by search volume (use Ahrefs/Semrush/free volume estimators) × buyer-intent strength. 2. **For each competitor, design two pages**:
- **`/<competitor>-vs-<us>`** — Symmetric comparison. Buyer is comparing both.
- **`/alternative-to-<competitor>`** — Asymmetric. Buyer is leaving competitor or shopping replacements.
3. **Apply the page template** (see Output Template) — Honest comparison table on 5–8 dimensions, "When to pick each" guidance, your unique attributes (from Dunford positioning), social proof, CTA. 4. **Anchor in positioning rules** — Each page must respect the BR-POS-* constraints. If positioning says "not for enterprise procurement," the page does not court enterprise buyers. 5. **Plan attribution** — Each page gets its own UTM source and a conversion event. Track per-page activation rate to identify dead pages.
Example
Competitor: **Mixpanel** (mid-search-volume, B2B SaaS analytics).
**Page 1: `/mixpanel-vs-us`**
Symmetric comparison table:
| Dimension | Mixpanel | Us | |-----------|----------|-----| | Setup time | 1–2 weeks (data engineering required) | 15 minutes (autoinstrument) | | Analytics depth | Industry-leading (cohorts, retention, funnels) | Solid (cohorts, funnels — no formula language) | | Pricing | Custom enterprise; usage-based | Flat tier; predictable | | Best-fit team | 50+ person product orgs | 1–20 person teams |
"**Pick Mixpanel if**: you have a data team and need advanced funnel/cohort analysis." "**Pick us if**: you're a small team that needs analytics today, not after a 2-week setup."
CTA: "Start free trial — full setup in under an hour"
**Page 2: `/alternative-to-mixpanel`**
Asymmetric, replacement-oriented. Headline: "Looking for a faster Mixpanel alternative?" Same table, plus migration guide ("export your Mixpanel events; we'll set up identical funnels in 1 hour"), plus customer story ("[Customer X] moved off Mixpanel in 2 days — here's how").
What You Get Back
- **SCR-ALT-\* page specs** — One per page. Includes URL slug, headline, comparison table content, "when to pick each" copy, social proof references, CTA. Hands off to design/dev for build.
- **GTM-\* with Type=Channel** for each page — The page treated as a channel (Owned layer), with attribution plan
- **Page priority queue** — Build order ranked by competitor search volume × conversion potential
When to Use It
| Trigger | Mode | |---------|------| | AEO Audit identified comparison gaps | standard | | Competitor raised prices / had a public incident (capture displaced buyers) | quick (single page, fast) | | Quarterly competitive SEO refresh | standard | | Launch wave needs additional Owned-channel surfaces | standard | | Enterprise / paid-tier buyer education | deep |
Do **not** use for products in tightly regulated categories where comparison claims have legal exposure (e.g., medical devices, financial advice) without legal review.
Consumes
- **CFD-\* competitive alternatives** (from v0.2 + v0.3 Moat) — Anchor for honest comparison; CFD- entries should include competitor strengths, not just weaknesses
- **GTM-AEO-\* gaps** (from v0.9 AEO Audit) — Comparison gaps become page priorities
- **GTM-\* positioning** + **BR-POS-\*** (from v0.9 Positioning) — Defines "when to pick us" claims; pages must honor BR-POS- constraints
- **CFD-\* customer stories** (from v0.1–v0.4 + post-launch) — Social proof and migration stories
- **FEA-\* feature list** — Anchor for "what we have" claims (no vaporware)
Produces
- **SCR-ALT-\* page specs** (subcategorized SCR- entries for alternatives pages, lives in `SoT/SoT.USER_JOURNEYS.md` alongside other SCR- entries)
- **GTM-\* with Type=Channel** for each page (the page-as-channel with attribution plan)
- **CFD-\* gaps surfaced** — If a competitor strength is unaddressed, log CFD- research-gap
##
Read more
name: prd-v09-alternatives-pages description: > Generate "X vs Y" and "Alternative to X" SEO/CRO pages targeting competitive search intent during PRD v0.9 Go-to-Market. Triggers on requests to build comparison pages, target competitive search traffic, or when user asks "build alternatives pages", "X vs Y page", "competitor comparison page", "we're better than X page", "capture branded search", "competitive SEO". Outputs SCR-ALT-* page specs and GTM-* channel entries. context: fork allowed-tools: - Read - Write - Edit - Glob - Grep - WebSearch - WebFetch execution_modes: default: standard supports: [quick, standard, deep]
Alternatives Pages (Competitive Comparison SEO/CRO)
Position in workflow: v0.9 AEO Audit → **v0.9 Alternatives Pages** → v0.9 Launch Metrics
Execution Mode
Default is **standard**. See [`.claude/rules/08-skill-execution-modes.md`](../../rules/08-skill-execution-modes.md) for selection logic.
| Mode | What this skill produces | |------|--------------------------| | **quick** | 2 pages for the single most-searched competitor (X-vs-us + alternative-to-X) | | **standard** | 5–10 pages covering top 3–5 competitors with both variant types; CRO copy + comparison table | | **deep** | Full competitor portfolio (10+ competitors); plus multi-way comparison ("X vs Y vs Z"); page-level A/B test plan; SEO targeting per page |
What This Does
Produces a portfolio of high-intent comparison pages — `/x-vs-us` and `/alternative-to-x` — that capture buyers actively searching for competitor names + comparison/alternative keywords. These are the highest-converting acquisition surface for B2B SaaS and many consumer products: the buyer has already passed awareness and is in active evaluation.
The pages must be **fair, credible, and conversion-oriented** — acknowledging where the competitor wins, claiming where you win, with social proof and a clear "when to pick each" guide. Aggressive trashing fails: buyers fact-check, and one false claim loses the page.
How It Works
1. **Source the competitor list** — From the AEO Audit's comparison gaps and v0.2 CFD- competitive landscape. Rank by search volume (use Ahrefs/Semrush/free volume estimators) × buyer-intent strength. 2. **For each competitor, design two pages**:
- **`/<competitor>-vs-<us>`** — Symmetric comparison. Buyer is comparing both.
- **`/alternative-to-<competitor>`** — Asymmetric. Buyer is leaving competitor or shopping replacements.
3. **Apply the page template** (see Output Template) — Honest comparison table on 5–8 dimensions, "When to pick each" guidance, your unique attributes (from Dunford positioning), social proof, CTA. 4. **Anchor in positioning rules** — Each page must respect the BR-POS-* constraints. If positioning says "not for enterprise procurement," the page does not court enterprise buyers. 5. **Plan attribution** — Each page gets its own UTM source and a conversion event. Track per-page activation rate to identify dead pages.
Example
Competitor: **Mixpanel** (mid-search-volume, B2B SaaS analytics).
**Page 1: `/mixpanel-vs-us`**
Symmetric comparison table:
| Dimension | Mixpanel | Us | |-----------|----------|-----| | Setup time | 1–2 weeks (data engineering required) | 15 minutes (autoinstrument) | | Analytics depth | Industry-leading (cohorts, retention, funnels) | Solid (cohorts, funnels — no formula language) | | Pricing | Custom enterprise; usage-based | Flat tier; predictable | | Best-fit team | 50+ person product orgs | 1–20 person teams |
"**Pick Mixpanel if**: you have a data team and need advanced funnel/cohort analysis." "**Pick us if**: you're a small team that needs analytics today, not after a 2-week setup."
CTA: "Start free trial — full setup in under an hour"
**Page 2: `/alternative-to-mixpanel`**
Asymmetric, replacement-oriented. Headline: "Looking for a faster Mixpanel alternative?" Same table, plus migration guide ("export your Mixpanel events; we'll set up identical funnels in 1 hour"), plus customer story ("[Customer X] moved off Mixpanel in 2 days — here's how").
What You Get Back
- **SCR-ALT-\* page specs** — One per page. Includes URL slug, headline, comparison table content, "when to pick each" copy, social proof references, CTA. Hands off to design/dev for build.
- **GTM-\* with Type=Channel** for each page — The page treated as a channel (Owned layer), with attribution plan
- **Page priority queue** — Build order ranked by competitor search volume × conversion potential
When to Use It
| Trigger | Mode | |---------|------| | AEO Audit identified comparison gaps | standard | | Competitor raised prices / had a public incident (capture displaced buyers) | quick (single page, fast) | | Quarterly competitive SEO refresh | standard | | Launch wave needs additional Owned-channel surfaces | standard | | Enterprise / paid-tier buyer education | deep |
Do **not** use for products in tightly regulated categories where comparison claims have legal exposure (e.g., medical devices, financial advice) without legal review.
Consumes
- **CFD-\* competitive alternatives** (from v0.2 + v0.3 Moat) — Anchor for honest comparison; CFD- entries should include competitor strengths, not just weaknesses
- **GTM-AEO-\* gaps** (from v0.9 AEO Audit) — Comparison gaps become page priorities
- **GTM-\* positioning** + **BR-POS-\*** (from v0.9 Positioning) — Defines "when to pick us" claims; pages must honor BR-POS- constraints
- **CFD-\* customer stories** (from v0.1–v0.4 + post-launch) — Social proof and migration stories
- **FEA-\* feature list** — Anchor for "what we have" claims (no vaporware)
Produces
- **SCR-ALT-\* page specs** (subcategorized SCR- entries for alternatives pages, lives in `SoT/SoT.USER_JOURNEYS.md` alongside other SCR- entries)
- **GTM-\* with Type=Channel** for each page (the page-as-channel with attribution plan)
- **CFD-\* gaps surfaced** — If a competitor strength is unaddressed, log CFD- research-gap
##
PRD-driven Context Engineering: A systematic approach to building AI-powered products using progressive documentation and context-aware development workflows
Repo: mattgierhart/PRD-driven-context-engineering
Other skills on prd-driven-context-engineering.
- /SKILL_TEMPLATE
[1-2 sentence description of what this skill does]. Triggers on [specific phrases/contexts that should activate this skill]. Outputs [what the skill produces].
Open skill - /ghm-gate-check
Validates gate criteria before PRD lifecycle advancement by delegating to the readiness scoring pipeline (scripts/readiness.py). Returns a graduated PASS / WARN / BLOCK verdict with top blockers and their causal chain. Triggers before advancing from v0.X to v0.Y or explicit
Open skill - /ghm-harvest
Extracts durable insights from temp/ files to SoT during EPIC Phase E. Triggers at EPIC completion or explicit `/ghm-harvest` invocation. Outputs new SoT entries and archive manifest.
Open skill - /ghm-id-register
Validates and registers new SoT IDs with cross-reference integrity. Triggers when creating BR-XXX, UJ-XXX, API-XXX, or CFD-XXX entries. Outputs formatted SoT entry with validated cross-references.
Open skill - /ghm-self-install
Install the PRD-Driven Context Engineering methodology into a fresh OR existing repository — the subscription-native alternative to forking the whole repo. Runs an interactive wizard that seeds the framework (.claude/ hooks, skills, agents, rules, scripts) without clobbering
Open skill - /ghm-sot-builder
Creates new Source of Truth (SoT) files when existing templates don't fit your needs. Triggers on requests to create a new SoT file, add a new artifact type, or when user says "I need to track [X] but there's no SoT for it", "create SoT", "new source of truth". Outputs a
Open skill

