/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, or ItemList JSON-LD depending on page type (via
schema-generator.py --type <Type> — AggregateRating is not a standalone --type; it is a nested field inside Product, as shown in the Product template below)
- 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
Source: hashgraph-online/awesome-codex-plugins → plugins/indranilbanerjee/digital-marketing-pro/skills/competitor-pages/SKILL.md
1---2name: competitor-pages3description: "Create competitor comparison pages. Use when: \\\"X vs Y\\\" layouts, alternatives pages, feature matrices, roundup pages."4category: marketing-and-growth5source_repo: hashgraph-online/awesome-codex-plugins6source_path: "plugins/indranilbanerjee/digital-marketing-pro/skills/competitor-pages/SKILL.md"7source_url: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/indranilbanerjee/digital-marketing-pro/skills/competitor-pages/SKILL.md8metadata:9 source: https://skillmd.com/skills/hashgraph-online/competitor-pages10---111213# /digital-marketing-pro:competitor-pages1415## Purpose1617Create high-converting competitor comparison and alternatives pages that target competitive intent keywords with accurate, structured content and appropriate schema markup.1819## Input Required2021The user must provide (or will be prompted for):2223- **Page type**: "X vs Y", "alternatives to X", "best tools roundup", or "comparison table"24- **Your product/service**: The product being positioned25- **Competitors**: 1-5 competitor products to compare against26- **Comparison criteria**: Features, pricing, use cases to compare (or auto-detected)27- **Target audience**: Who is making this purchase decision2829## Page Types3031### 1. "X vs Y" Comparison Pages32- Direct head-to-head comparison between two products/services33- Balanced feature-by-feature analysis34- Clear verdict or recommendation with justification35- Target keyword: `[Product A] vs [Product B]`3637### 2. "Alternatives to X" Pages38- List of alternatives to a specific product/service39- Each alternative with brief summary, pros/cons, best-for use case40- Target keyword: `[Product] alternatives`, `best alternatives to [Product]`4142### 3. "Best [Category] Tools" Roundup Pages43- Curated list of top tools/services in a category44- Ranking criteria clearly stated45- Target keyword: `best [category] tools [year]`, `top [category] software`4647### 4. Comparison Table Pages48- Feature matrix with multiple products in columns49- Sortable/filterable layout recommendations50- Target keyword: `[category] comparison`, `[category] comparison chart`5152## Process53541. **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.552. **Research competitors**: Gather feature data, pricing, positioning from public sources. Verify all claims.563. **Generate comparison structure**: Feature matrix, content outline, section order574. **Apply schema markup**: Product, SoftwareApplication, or ItemList JSON-LD depending on page type (via `schema-generator.py --type <Type>` — `AggregateRating` is not a standalone `--type`; it is a nested field inside `Product`, as shown in the Product template below)585. **Optimize for conversion**: CTA placement strategy, social proof sections, pricing highlights596. **Apply fairness guidelines**: Accuracy verification, source citations, affiliation disclosure607. **Keyword optimization**: Primary and secondary keyword targeting, title tag formulas, H1 patterns618. **Internal linking strategy**: Cross-link between related comparison pages, feature pages, case studies6263## Comparison Table Template6465```66| Feature | Your Product | Competitor A | Competitor B |67|------------------|:------------:|:------------:|:------------:|68| Feature 1 | ✅ | ✅ | ❌ |69| Feature 2 | ✅ | ⚠️ Partial | ✅ |70| Feature 3 | ✅ | ❌ | ❌ |71| Pricing (from) | $X/mo | $Y/mo | $Z/mo |72| Free Tier | ✅ | ❌ | ✅ |73```7475### Data Accuracy Requirements76- All feature claims must be verifiable from public sources77- Pricing must be current (include "as of [date]" note)78- Update frequency: review quarterly or when competitors ship major changes79- Link to source for each competitor data point where possible8081## Schema Markup Templates8283### Product with AggregateRating (for X vs Y pages)84```json85{86 "@context": "https://schema.org",87 "@type": "Product",88 "name": "[Product Name]",89 "description": "[Product Description]",90 "brand": { "@type": "Brand", "name": "[Brand Name]" },91 "aggregateRating": {92 "@type": "AggregateRating",93 "ratingValue": "[Rating]",94 "reviewCount": "[Count]",95 "bestRating": "5",96 "worstRating": "1"97 }98}99```100101### SoftwareApplication (for software comparisons)102```json103{104 "@context": "https://schema.org",105 "@type": "SoftwareApplication",106 "name": "[Software Name]",107 "applicationCategory": "[Category]",108 "operatingSystem": "[OS]",109 "offers": { "@type": "Offer", "price": "[Price]", "priceCurrency": "USD" }110}111```112113### ItemList (for roundup pages)114```json115{116 "@context": "https://schema.org",117 "@type": "ItemList",118 "name": "Best [Category] Tools [Year]",119 "itemListOrder": "https://schema.org/ItemListOrderDescending",120 "numberOfItems": "[Count]",121 "itemListElement": [122 { "@type": "ListItem", "position": 1, "name": "[Product Name]", "url": "[Product URL]" }123 ]124}125```126127## Keyword Targeting128129### Comparison Intent Patterns130| Pattern | Example | Volume Signal |131|---------|---------|--------------|132| `[A] vs [B]` | "Slack vs Teams" | High |133| `[A] alternative` | "Figma alternatives" | High |134| `[A] alternatives [year]` | "Notion alternatives 2026" | High |135| `best [category] tools` | "best project management tools" | High |136| `[A] vs [B] for [use case]` | "AWS vs Azure for startups" | Medium |137| `[A] vs [B] pricing` | "HubSpot vs Salesforce pricing" | Medium |138| `is [A] better than [B]` | "is Notion better than Confluence" | Medium |139140### Title Tag Formulas141- X vs Y: `[A] vs [B]: [Key Differentiator] ([Year])`142- Alternatives: `[N] Best [A] Alternatives in [Year] (Free & Paid)`143- Roundup: `[N] Best [Category] Tools in [Year], Compared & Ranked`144145## Conversion-Optimized Layouts146147### CTA Placement148- **Above fold**: Brief comparison summary with primary CTA149- **After comparison table**: "Try [Your Product] free" CTA150- **Bottom of page**: Final recommendation with CTA151- Avoid aggressive CTAs in competitor description sections (reduces trust)152153### Social Proof Sections154- Customer testimonials relevant to comparison criteria155- G2/Capterra/TrustPilot ratings (with source links)156- Case studies showing migration from competitor157- "Switched from [Competitor]" stories158159### Trust Signals160- "Last updated [date]" timestamp161- Author with relevant expertise162- Methodology disclosure163- Disclosure of own product affiliation164- Balanced presentation — acknowledge competitor strengths honestly165166## Fairness Guidelines167168- **Accuracy**: All competitor information must be verifiable from public sources169- **No defamation**: Never make false or misleading claims about competitors170- **Cite sources**: Link to competitor websites, review sites, or documentation171- **Timely updates**: Review and update when competitors release major changes172- **Disclose affiliation**: Clearly state which product is yours173- **Balanced presentation**: Acknowledge competitor strengths honestly174- **Pricing accuracy**: Include "as of [date]" disclaimers on all pricing data175176## Output177178A structured competitor comparison page package containing:179180- Page content template (minimum 1,500 words) with all sections181- Feature matrix table182- Schema markup (JSON-LD) appropriate to page type183- Primary and secondary keywords with title tag and H1 recommendations184- Internal linking plan (cross-link to related comparisons, feature pages, case studies)185- Conversion optimization recommendations186- Content gap analysis vs existing competitor pages187188## Agents Used189190- **seo-specialist** — Keyword targeting, schema markup, on-page optimization191- **content-creator** — Comparison content writing, brand voice application192- **competitive-intel** — Competitor feature and pricing research193- **brand-guardian** — Ensure compliance with brand guidelines on competitor mentions194195## Scripts Used196197- **schema-generator.py** — Generate Product, SoftwareApplication, or ItemList JSON-LD198- **competitor-scraper.py** — Extract competitor page data for comparison199- **content-scorer.py** — Score comparison page quality200201---202203**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/indranilbanerjee/digital-marketing-pro/skills/competitor-pages/SKILL.md`