Claude-Skills competitor-alternatives

install
source · Clone the upstream repo
git clone https://github.com/borghei/Claude-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/borghei/Claude-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/business-growth/competitor-alternatives" ~/.claude/skills/borghei-claude-skills-competitor-alternatives && rm -rf "$T"
manifest: business-growth/competitor-alternatives/SKILL.md
source content

Competitor & Alternative Pages

Production-grade framework for creating competitor comparison and alternative pages. Covers 4 page formats, centralized competitor data architecture, deep research methodology, SEO optimization, content templates, and ongoing maintenance strategy. Designed for both SEO traffic capture and sales enablement.


Table of Contents


When to Use

TriggerAction
Prospects comparing you to competitorsCreate vs-pages for top 3 competitors
Search volume exists for "[competitor] alternative"Create singular alternative pages
Sales team needs battle card contentCreate vs-pages with objection handling
Competitor has comparison pages about youCreate counter-comparison pages
SEO gap on competitor-branded keywordsBuild full alternative page set

Core Principles

1. Honesty Builds Trust

  • Acknowledge competitor strengths explicitly
  • Be accurate about your own limitations
  • Readers are actively comparing -- they will verify your claims
  • A dishonest comparison page damages your brand more than no page at all

2. Help Them Decide (Not Just Sell)

  • Different tools genuinely fit different needs
  • Be explicit about who you are best for AND who the competitor is best for
  • Reduce evaluation friction -- save prospects research time

3. Depth Over Checkbox Tables

  • Go beyond feature checklists (every competitor does those)
  • Explain WHY differences matter for specific use cases
  • Include real scenarios and workflows
  • Show, do not just tell

4. Single Source of Truth

  • Centralize competitor data -- do not maintain facts across 10 pages
  • Updates propagate to all pages automatically
  • Track last-verified date per data point

The 4 Page Formats

Format 1: [Competitor] Alternative (Singular)

Intent: User is actively looking to switch FROM a specific competitor.

URL:

/alternatives/[competitor]
or
/[competitor]-alternative

Keywords: "[Competitor] alternative", "alternative to [Competitor]", "switch from [Competitor]"

Page Structure:

1. Why people look for alternatives (validate their pain, 2-3 paragraphs)
2. TL;DR: You as the alternative (quick positioning, 3-4 bullets)
3. Detailed comparison (features, pricing, support -- paragraph format, not just tables)
4. Who should switch (and who should NOT -- be honest)
5. Migration path (what transfers, what needs reconfiguration)
6. Testimonials from customers who switched
7. CTA: Start free trial or request demo

Format 2: [Competitor] Alternatives (Plural)

Intent: User is researching options broadly, earlier in the buying journey.

URL:

/alternatives/[competitor]-alternatives
or
/best-[competitor]-alternatives

Keywords: "[Competitor] alternatives", "best [Competitor] alternatives", "tools like [Competitor]"

Page Structure:

1. Why people look for alternatives (common pain points, 2-3 paragraphs)
2. What to look for in an alternative (evaluation criteria framework)
3. List of 5-7 alternatives (you first, but include real options)
4. Summary comparison table
5. Detailed breakdown of each alternative (150-200 words each)
6. Recommendation by use case ("Best for [X]: [Tool]")
7. CTA

Important: Include 5-7 REAL alternatives. Being genuinely helpful ranks better and builds trust.

Format 3: You vs [Competitor]

Intent: User is directly comparing you to a specific competitor.

URL:

/vs/[competitor]
or
/compare/[you]-vs-[competitor]

Keywords: "[You] vs [Competitor]", "[Competitor] vs [You]"

Page Structure:

1. TL;DR summary (key differences in 2-3 sentences)
2. At-a-glance comparison table (8-12 dimensions)
3. Detailed comparison by category (paragraph format per category):
   - Features
   - Pricing
   - Ease of use / UX
   - Support and documentation
   - Integrations
   - Security and compliance
4. Who [You] is best for (3-4 bullets)
5. Who [Competitor] is best for (3-4 bullets -- be honest)
6. What customers say (testimonials from switchers)
7. Migration support
8. CTA

Format 4: [Competitor A] vs [Competitor B]

Intent: User is comparing two competitors (neither is you directly).

URL:

/compare/[competitor-a]-vs-[competitor-b]

Page Structure:

1. Overview of both products (neutral, factual)
2. Comparison by category (same categories as Format 3)
3. Who each is best for
4. "Consider a third option" (introduce yourself naturally)
5. Three-way comparison table (both competitors + you)
6. CTA

Why this works: Captures competitor-branded search traffic, positions you as a knowledgeable authority, and introduces you to buyers who might not have considered you.


Content Architecture

Centralized Competitor Data

Create a single data file per competitor that feeds all comparison pages.

Competitor Data Structure:

Competitor: [Name]
Last Verified: [Date]
Website: [URL]

Positioning:
  - Tagline: [Their tagline]
  - Target audience: [Who they target]
  - Primary differentiator: [What they claim is unique]

Pricing:
  - Free tier: [Yes/No, details]
  - Entry price: [$X/mo]
  - Mid-tier price: [$X/mo]
  - Enterprise: [Custom / $X/mo]
  - Billing: [Monthly, Annual, Both]
  - Trial: [Length, CC required?]

Features:
  - [Category 1]: [Rating 1-5, notes]
  - [Category 2]: [Rating 1-5, notes]
  - [Category 3]: [Rating 1-5, notes]

Strengths:
  - [Strength 1 with evidence]
  - [Strength 2 with evidence]

Weaknesses:
  - [Weakness 1 with evidence source]
  - [Weakness 2 with evidence source]

Best For: [Description of ideal customer]
Not Ideal For: [Description of poor fit]

Common Complaints (from reviews):
  - [Complaint 1] (source: G2/Capterra/etc.)
  - [Complaint 2]
  - [Complaint 3]

Migration Notes:
  - Data export: [Available? Format?]
  - API migration: [Available?]
  - Switching time: [Estimated]

Research Methodology

Deep Research Process

For each competitor:

  1. Sign up and use the product -- Create a real account, go through onboarding, test core workflows. There is no substitute for hands-on experience.
  2. Pricing verification -- Screenshot current pricing page. Note what is included at each tier. Check for hidden costs.
  3. Review mining -- Read 50+ reviews on G2, Capterra, TrustRadius. Categorize into praise themes, complaint themes, and feature requests.
  4. Customer feedback -- Talk to your customers who switched from (or to) this competitor. Capture switching reasons and experience quotes.
  5. Content audit -- Review their positioning, their comparison pages about you (if any), their changelog, their blog.
  6. Financial/growth signals -- Check Crunchbase for funding, LinkedIn for employee count trends, job postings for strategic direction.

Verification Schedule

FrequencyWhat to Verify
MonthlyPricing (check for changes)
QuarterlyFeature set, major product updates
When notifiedCustomer reports competitor change
AnnuallyFull refresh of all competitor data

Essential Content Sections

TL;DR Summary

Every comparison page starts with a 2-3 sentence summary for scanners. This is the most-read section.

Template: "[Your product] is the better choice if you need [differentiator 1] and [differentiator 2]. [Competitor] is better if [their strength]. The biggest differences are [difference 1] and [difference 2]."

Paragraph Comparisons (Not Just Tables)

For each comparison dimension, write a paragraph explaining:

  • How each product handles this area
  • Why the differences matter
  • Who the difference matters most to

Tables complement paragraphs. They do not replace them.

Pricing Comparison

Include:

  • Tier-by-tier price comparison
  • What is included at each tier (not just the name)
  • Hidden costs (setup fees, overage charges, add-on pricing)
  • Total cost calculation for a sample team size (e.g., "For a team of 10")

Who It Is For

Be explicit about ideal customer for each option:

ProductBest ForNot Ideal For
Your product[Specific persona/use case][Honest admission of limitations]
Competitor[Specific persona/use case][Their documented weaknesses]

Migration Section

ElementContent
What transfersData, settings, integrations that migrate
What needs reconfigurationWhat must be set up fresh
Support offeredMigration assistance, documentation
Estimated time"Most teams migrate in [timeframe]"
Customer quoteQuote from someone who switched

SEO Strategy

Keyword Targeting

FormatPrimary KeywordsSecondary Keywords
Singular alternative"[Competitor] alternative""switch from [Competitor]", "replace [Competitor]"
Plural alternatives"[Competitor] alternatives""best [Competitor] alternatives", "tools like [Competitor]"
Vs page"[You] vs [Competitor]""[Competitor] vs [You]", "[You] or [Competitor]"
Competitor vs competitor"[A] vs [B]""[B] vs [A]", "[A] or [B]"

On-Page SEO

  • Title tag: "[Your Product] vs [Competitor]: Detailed Comparison [Year]"
  • Meta description: Summarize the key difference and who each is best for
  • H1: Match the primary keyword
  • Schema: Consider FAQPage schema for comparison questions

Internal Linking

  • Link between all competitor pages (alternative <-> vs page for same competitor)
  • Link from feature pages to relevant comparisons
  • Link from blog posts mentioning competitors
  • Create a hub page:
    /compare/
    or
    /alternatives/
    linking to all comparison content

Maintenance and Updates

Update Triggers

TriggerActionPriority
Competitor changes pricingUpdate pricing comparison on all affected pagesHigh
Competitor launches major featureUpdate feature comparison + add "Recent Changes" noteHigh
Your product launches feature that closes a gapUpdate comparison to reflect new advantageHigh
New customer switching testimonialAdd to relevant comparison pagesMedium
Quarterly review cycleVerify all data points, refresh screenshotsMedium

Freshness Signals

  • Include "Last updated: [Month Year]" on every comparison page
  • Update the date only when actual content changes are made
  • Add "Recent changes" section at the top when a competitor makes significant updates

Quality Standards

Legal Safety

  • All claims must be verifiable from public sources or customer quotes
  • Do not make claims about competitor uptime, reliability, or security that you cannot verify
  • Use "at the time of writing" or "as of [date]" for factual claims
  • Do not copy competitor content -- summarize and analyze

Credibility Rules

  • Acknowledge genuine competitor strengths (do not be a hit piece)
  • Include "Who [Competitor] is best for" -- this builds trust
  • Use customer quotes from both sides (your customers AND competitor reviews)
  • Cite sources for data claims (review platforms, pricing pages, public reports)
  • Do not use aggressive language or disparaging tone

Output Artifacts

ArtifactFormatDescription
Competitor Data FileStructured data per competitorCentralized competitor profile for all pages
Page Set PlanPrioritized listWhich pages to build first, with target keywords and estimated search volume
Alternative Page (Singular)Full page copyComplete page with all sections
Vs PageFull page copyComparison page with table and narrative sections
Alternatives Page (Plural)Full page copyMulti-competitor roundup page
Migration GuideReusable content blockMigration copy for inclusion across pages
Hub PageLinked indexCentral page linking to all comparison content

Related Skills

  • competitive-teardown -- Use for deep competitive intelligence BEFORE creating pages. Teardown provides the data; this skill produces the content.
  • seo-audit -- Use to validate comparison pages meet on-page SEO requirements before publishing.
  • page-cro -- Use for optimizing comparison page conversion rates (CTA placement, social proof, layout).
  • content-creator -- Use for writing supporting competitive blog content based on comparison data.
  • programmatic-seo -- Use when you have 10+ competitors and want to generate comparison pages at scale using templates.

Tool Reference

1. comparison_page_planner.py

Purpose: Generate a prioritized comparison page plan from competitor data with keyword targets and estimated search volume.

python scripts/comparison_page_planner.py competitors.json
python scripts/comparison_page_planner.py competitors.json --json
FlagRequiredDescription
competitors.json
YesJSON file with competitor names and search volume estimates
--json
NoOutput results as JSON
--brand
NoYour brand name for URL slug generation (default: "your-product")

2. competitor_data_tracker.py

Purpose: Track and manage centralized competitor data files with staleness detection and update reminders.

python scripts/competitor_data_tracker.py competitor_profiles/
python scripts/competitor_data_tracker.py competitor_profiles/ --json
python scripts/competitor_data_tracker.py competitor_profiles/ --stale-days 60
FlagRequiredDescription
competitor_profiles/
YesDirectory containing competitor profile JSON files
--json
NoOutput results as JSON
--stale-days
NoNumber of days before data is considered stale (default: 90)

3. comparison_content_scorer.py

Purpose: Score existing comparison page content against quality and SEO best practices.

python scripts/comparison_content_scorer.py page_content.json
python scripts/comparison_content_scorer.py page_content.json --json
FlagRequiredDescription
page_content.json
YesJSON file with comparison page content and metadata
--json
NoOutput results as JSON

Troubleshooting

ProblemLikely CauseSolution
Comparison pages not ranking for target keywordsThin content or poor on-page SEOAdd 1500+ words of paragraph content (not just tables); ensure H1 matches primary keyword; add FAQ with schema markup
Pages rank but do not convertMissing CTA or weak value propositionAdd CTA after every major section; include migration section and risk reversal (free trial, no CC); use comparison_content_scorer.py to audit
Competitor data becomes outdated quicklyNo update process in placeUse competitor_data_tracker.py with --stale-days 30 for pricing, 90 for features; assign ownership for monthly checks
Sales team does not use comparison contentPages are too marketing-focusedCreate sales-specific versions with objection handling, landmine questions, and talk tracks; test with 3 reps before publishing
Legal pushback on competitor claimsUnverifiable or aggressive claimsCite public sources for every claim; use "as of [date]" qualifiers; acknowledge competitor strengths honestly
Too many competitors to coverTrying to create pages for every competitorPrioritize using comparison_page_planner.py; start with top 3-5 competitors by search volume and deal frequency

Success Criteria

  • Comparison pages ranking on page 1 for "[competitor] alternative" within 6 months
  • Each comparison page converts at 3%+ (visitor to CTA click)
  • All competitor data verified within the last 90 days (use competitor_data_tracker.py)
  • Pages include honest "Who [Competitor] is best for" section (builds trust, reduces bounce)
  • At least 1 customer testimonial from a switcher per comparison page
  • Hub page links to all comparison content with clear navigation
  • Quarterly content refresh with "Last updated" date on every page

Scope & Limitations

  • In scope: Comparison page content strategy, SEO optimization, competitor data management, content quality scoring, page planning and prioritization
  • Out of scope: Primary competitive intelligence gathering (use competitive-teardown), paid advertising strategy, design/development of pages
  • Legal constraint: All claims must be verifiable from public sources; avoid disparaging competitors; include "as of [date]" for factual claims
  • SEO timeline: Comparison pages typically take 3-6 months to rank; plan for long-term investment
  • Maintenance cost: Each competitor page requires ongoing updates; budget for quarterly refreshes

Integration Points

  • competitive-teardown -- Teardown provides the raw competitive intelligence; this skill transforms it into marketing content
  • page-cro -- Use for optimizing comparison page conversion rates after content is published
  • seo-audit -- Use to validate comparison pages meet technical SEO requirements before publishing
  • content-creator -- Use for writing supporting blog content (competitor comparison blog posts, switching guides)
  • customer-success-manager -- When customers mention competitor evaluation, comparison pages can be shared proactively