/digital-marketing-pro:competitor-pages
Purpose
Create high-converting competitor comparison and alternatives pages that target competitive intent keywords with accurate, structured content and appropriate schema markup.
Input Required
The user must provide (or will be prompted for):
- Page type: "X vs Y", "alternatives to X", "best tools roundup", or "comparison table"
- Your product/service: The product being positioned
- Competitors: 1-5 competitor products to compare against
- Comparison criteria: Features, pricing, use cases to compare (or auto-detected)
- Target audience: Who is making this purchase decision
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 layout recommendations
- Target keyword:
[category] comparison, [category] comparison chart
Process
- Load brand context: Read
~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply brand voice and compliance rules. Check for brand guidelines — especially restrictions on competitor mentions.
- Research competitors: Gather feature data, pricing, positioning from public sources. Verify all claims.
- Generate comparison structure: Feature matrix, content outline, section order
- Apply schema markup: Product, SoftwareApplication, AggregateRating, or ItemList JSON-LD depending on page type
- Optimize for conversion: CTA placement strategy, social proof sections, pricing highlights
- Apply fairness guidelines: Accuracy verification, source citations, affiliation disclosure
- Keyword optimization: Primary and secondary keyword targeting, title tag formulas, H1 patterns
- Internal linking strategy: Cross-link between related comparison pages, feature pages, case studies
Comparison Table Template
| 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 Templates
Product with AggregateRating (for X vs Y pages)
{
"@context": "https://schema.org",
"@type": "Product",
"name": "[Product Name]",
"description": "[Product Description]",
"brand": { "@type": "Brand", "name": "[Brand Name]" },
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "[Rating]",
"reviewCount": "[Count]",
"bestRating": "5",
"worstRating": "1"
}
}
SoftwareApplication (for software comparisons)
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "[Software Name]",
"applicationCategory": "[Category]",
"operatingSystem": "[OS]",
"offers": { "@type": "Offer", "price": "[Price]", "priceCurrency": "USD" }
}
ItemList (for roundup pages)
{
"@context": "https://schema.org",
"@type": "ItemList",
"name": "Best [Category] Tools [Year]",
"itemListOrder": "https://schema.org/ItemListOrderDescending",
"numberOfItems": "[Count]",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "[Product Name]", "url": "[Product URL]" }
]
}
Keyword Targeting
Comparison Intent Patterns
| Pattern |
Example |
Volume Signal |
[A] vs [B] |
"Slack vs Teams" |
High |
[A] alternative |
"Figma alternatives" |
High |
[A] alternatives [year] |
"Notion alternatives 2026" |
High |
best [category] tools |
"best project management tools" |
High |
[A] vs [B] for [use case] |
"AWS vs Azure for startups" |
Medium |
[A] vs [B] pricing |
"HubSpot vs Salesforce pricing" |
Medium |
is [A] better than [B] |
"is Notion better than Confluence" |
Medium |
Title Tag Formulas
- X vs Y:
[A] vs [B]: [Key Differentiator] ([Year])
- Alternatives:
[N] Best [A] Alternatives in [Year] (Free & Paid)
- Roundup:
[N] Best [Category] Tools in [Year], Compared & Ranked
Conversion-Optimized Layouts
CTA Placement
- Above fold: Brief comparison summary with primary CTA
- After comparison table: "Try [Your Product] free" CTA
- Bottom of page: Final recommendation with CTA
- Avoid aggressive CTAs in competitor description sections (reduces trust)
Social Proof Sections
- Customer testimonials relevant to comparison criteria
- G2/Capterra/TrustPilot ratings (with source links)
- Case studies showing migration from competitor
- "Switched from [Competitor]" stories
Trust Signals
- "Last updated [date]" timestamp
- Author with relevant expertise
- Methodology disclosure
- Disclosure of own product affiliation
- Balanced presentation — acknowledge competitor strengths honestly
Fairness Guidelines
- Accuracy: All competitor information must be verifiable from public sources
- No defamation: Never make false or misleading claims about competitors
- Cite sources: Link to competitor websites, review sites, or documentation
- Timely updates: Review and update when competitors release major changes
- Disclose affiliation: Clearly state which product is yours
- Balanced presentation: Acknowledge competitor strengths honestly
- Pricing accuracy: Include "as of [date]" disclaimers on all pricing data
Output
A structured competitor comparison page package containing:
- Page content template (minimum 1,500 words) with all sections
- Feature matrix table
- Schema markup (JSON-LD) appropriate to page type
- Primary and secondary keywords with title tag and H1 recommendations
- Internal linking plan (cross-link to related comparisons, feature pages, case studies)
- Conversion optimization recommendations
- Content gap analysis vs existing competitor pages
Agents Used
- seo-specialist — Keyword targeting, schema markup, on-page optimization
- content-creator — Comparison content writing, brand voice application
- competitive-intel — Competitor feature and pricing research
- brand-guardian — Ensure compliance with brand guidelines on competitor mentions
Scripts Used
- schema-generator.py — Generate Product, SoftwareApplication, or ItemList JSON-LD
- competitor-scraper.py — Extract competitor page data for comparison
- content-scorer.py — Score comparison page quality
1---2name: competitor-pages3description: "Create competitor comparison pages. Use when: \"X vs Y\" layouts, alternatives pages, feature matrices, roundup pages."4argument-hint: "[URL or generate] [competitor]"5user-invocable: true6metadata:7 source: https://skillmd.com/skills/zuoguyoupan2023/competitor-pages8---910# /digital-marketing-pro:competitor-pages1112## Purpose1314Create high-converting competitor comparison and alternatives pages that target competitive intent keywords with accurate, structured content and appropriate schema markup.1516## Input Required1718The user must provide (or will be prompted for):1920- **Page type**: "X vs Y", "alternatives to X", "best tools roundup", or "comparison table"21- **Your product/service**: The product being positioned22- **Competitors**: 1-5 competitor products to compare against23- **Comparison criteria**: Features, pricing, use cases to compare (or auto-detected)24- **Target audience**: Who is making this purchase decision2526## Page Types2728### 1. "X vs Y" Comparison Pages29- Direct head-to-head comparison between two products/services30- Balanced feature-by-feature analysis31- Clear verdict or recommendation with justification32- Target keyword: `[Product A] vs [Product B]`3334### 2. "Alternatives to X" Pages35- List of alternatives to a specific product/service36- Each alternative with brief summary, pros/cons, best-for use case37- Target keyword: `[Product] alternatives`, `best alternatives to [Product]`3839### 3. "Best [Category] Tools" Roundup Pages40- Curated list of top tools/services in a category41- Ranking criteria clearly stated42- Target keyword: `best [category] tools [year]`, `top [category] software`4344### 4. Comparison Table Pages45- Feature matrix with multiple products in columns46- Sortable/filterable layout recommendations47- Target keyword: `[category] comparison`, `[category] comparison chart`4849## Process50511. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply brand voice and compliance rules. Check for brand guidelines — especially restrictions on competitor mentions.522. **Research competitors**: Gather feature data, pricing, positioning from public sources. Verify all claims.533. **Generate comparison structure**: Feature matrix, content outline, section order544. **Apply schema markup**: Product, SoftwareApplication, AggregateRating, or ItemList JSON-LD depending on page type555. **Optimize for conversion**: CTA placement strategy, social proof sections, pricing highlights566. **Apply fairness guidelines**: Accuracy verification, source citations, affiliation disclosure577. **Keyword optimization**: Primary and secondary keyword targeting, title tag formulas, H1 patterns588. **Internal linking strategy**: Cross-link between related comparison pages, feature pages, case studies5960## Comparison Table Template6162```63| Feature | Your Product | Competitor A | Competitor B |64|------------------|:------------:|:------------:|:------------:|65| Feature 1 | ✅ | ✅ | ❌ |66| Feature 2 | ✅ | ⚠️ Partial | ✅ |67| Feature 3 | ✅ | ❌ | ❌ |68| Pricing (from) | $X/mo | $Y/mo | $Z/mo |69| Free Tier | ✅ | ❌ | ✅ |70```7172### Data Accuracy Requirements73- All feature claims must be verifiable from public sources74- Pricing must be current (include "as of [date]" note)75- Update frequency: review quarterly or when competitors ship major changes76- Link to source for each competitor data point where possible7778## Schema Markup Templates7980### Product with AggregateRating (for X vs Y pages)81```json82{83 "@context": "https://schema.org",84 "@type": "Product",85 "name": "[Product Name]",86 "description": "[Product Description]",87 "brand": { "@type": "Brand", "name": "[Brand Name]" },88 "aggregateRating": {89 "@type": "AggregateRating",90 "ratingValue": "[Rating]",91 "reviewCount": "[Count]",92 "bestRating": "5",93 "worstRating": "1"94 }95}96```9798### SoftwareApplication (for software comparisons)99```json100{101 "@context": "https://schema.org",102 "@type": "SoftwareApplication",103 "name": "[Software Name]",104 "applicationCategory": "[Category]",105 "operatingSystem": "[OS]",106 "offers": { "@type": "Offer", "price": "[Price]", "priceCurrency": "USD" }107}108```109110### ItemList (for roundup pages)111```json112{113 "@context": "https://schema.org",114 "@type": "ItemList",115 "name": "Best [Category] Tools [Year]",116 "itemListOrder": "https://schema.org/ItemListOrderDescending",117 "numberOfItems": "[Count]",118 "itemListElement": [119 { "@type": "ListItem", "position": 1, "name": "[Product Name]", "url": "[Product URL]" }120 ]121}122```123124## Keyword Targeting125126### Comparison Intent Patterns127| Pattern | Example | Volume Signal |128|---------|---------|--------------|129| `[A] vs [B]` | "Slack vs Teams" | High |130| `[A] alternative` | "Figma alternatives" | High |131| `[A] alternatives [year]` | "Notion alternatives 2026" | High |132| `best [category] tools` | "best project management tools" | High |133| `[A] vs [B] for [use case]` | "AWS vs Azure for startups" | Medium |134| `[A] vs [B] pricing` | "HubSpot vs Salesforce pricing" | Medium |135| `is [A] better than [B]` | "is Notion better than Confluence" | Medium |136137### Title Tag Formulas138- X vs Y: `[A] vs [B]: [Key Differentiator] ([Year])`139- Alternatives: `[N] Best [A] Alternatives in [Year] (Free & Paid)`140- Roundup: `[N] Best [Category] Tools in [Year], Compared & Ranked`141142## Conversion-Optimized Layouts143144### CTA Placement145- **Above fold**: Brief comparison summary with primary CTA146- **After comparison table**: "Try [Your Product] free" CTA147- **Bottom of page**: Final recommendation with CTA148- Avoid aggressive CTAs in competitor description sections (reduces trust)149150### Social Proof Sections151- Customer testimonials relevant to comparison criteria152- G2/Capterra/TrustPilot ratings (with source links)153- Case studies showing migration from competitor154- "Switched from [Competitor]" stories155156### Trust Signals157- "Last updated [date]" timestamp158- Author with relevant expertise159- Methodology disclosure160- Disclosure of own product affiliation161- Balanced presentation — acknowledge competitor strengths honestly162163## Fairness Guidelines164165- **Accuracy**: All competitor information must be verifiable from public sources166- **No defamation**: Never make false or misleading claims about competitors167- **Cite sources**: Link to competitor websites, review sites, or documentation168- **Timely updates**: Review and update when competitors release major changes169- **Disclose affiliation**: Clearly state which product is yours170- **Balanced presentation**: Acknowledge competitor strengths honestly171- **Pricing accuracy**: Include "as of [date]" disclaimers on all pricing data172173## Output174175A structured competitor comparison page package containing:176177- Page content template (minimum 1,500 words) with all sections178- Feature matrix table179- Schema markup (JSON-LD) appropriate to page type180- Primary and secondary keywords with title tag and H1 recommendations181- Internal linking plan (cross-link to related comparisons, feature pages, case studies)182- Conversion optimization recommendations183- Content gap analysis vs existing competitor pages184185## Agents Used186187- **seo-specialist** — Keyword targeting, schema markup, on-page optimization188- **content-creator** — Comparison content writing, brand voice application189- **competitive-intel** — Competitor feature and pricing research190- **brand-guardian** — Ensure compliance with brand guidelines on competitor mentions191192## Scripts Used193194- **schema-generator.py** — Generate Product, SoftwareApplication, or ItemList JSON-LD195- **competitor-scraper.py** — Extract competitor page data for comparison196- **content-scorer.py** — Score comparison page quality