Competitors
Corey HainesCommunityCreated by Corey Haines
- Skill
- Content generator
- Business and productivity
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a structured framework for creating buyer-facing competitor comparison and alternative pages. It emphasizes honesty, evidence-based claims, and a modular content architecture to ensure accuracy and maintainability. By following these guidelines, you can build pages that capture search traffic, assist users in their evaluation journey, and clearly differentiate your product from competitors. The skill covers four primary formats: singular alternatives, plural alternatives, direct 'you vs competitor' comparisons, and 'competitor vs competitor' analyses, while also providing a process for auditing existing competitive assets to ensure claims remain current and defensible.
What it does
- Drafts SEO-optimized competitor alternative and comparison pages.
- Provides templates for feature, pricing, and service comparisons.
- Establishes a centralized data architecture for consistent competitor information.
- Guides the creation of 'who it's for' sections to build user trust.
- Includes a rigorous audit process for verifying claims in existing competitive assets.
- Offers guidance on migration paths to help users switch to your product.
When to use it
- When you need to create landing pages targeting '[Competitor] alternative' or '[You] vs [Competitor]' search terms.
- When you need to audit existing comparison pages or sales battle cards for stale or inaccurate claims.
- When you want to provide potential customers with clear, honest guidance on how your product compares to others.
- When you need to scale your competitive content while maintaining a single source of truth for competitor data.
Advantages
- Builds trust through honest, evidence-backed comparisons.
- Improves SEO performance by targeting high-intent competitive keywords.
- Reduces maintenance effort through a centralized data architecture.
- Provides clear, actionable guidance for users evaluating your product against others.
- Ensures competitive claims are defensible and up-to-date.
Usage examples
- “Create a 'vs' page comparing our product to Salesforce.”
- The agent will draft a page structure including a TL;DR summary, comparison table, and detailed breakdowns of features, pricing, and ideal use cases for both products.
- “Audit our existing 'Notion alternative' page for stale claims.”
- The agent will review the page's claims against current data, flag unverifiable or overclaimed statements, and provide a prioritized list of fixes.
- “Help me write a 'Best Alternatives to Jira' page.”
- The agent will generate a page structure that includes your product alongside 4-7 other real alternatives, providing a balanced view for users researching the market.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/coreyhaines31/competitors/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip competitors.zip -d .agents/skills
Documentation by Corey Haines
Competitor & Alternative Pages
You are an expert in creating competitor comparison and alternative pages. Your goal is to build pages that rank for competitive search terms, provide genuine value to evaluators, and position your product effectively.
Initial Assessment
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Never guess the competitor. If the request doesn't name one and the context file doesn't identify it, ask, and stop there. Don't draft a polished page around the most likely candidate.
Before creating competitor pages, understand:
Your Product
Core value proposition
Key differentiators
Ideal customer profile
Pricing model
Strengths and honest weaknesses
Competitive Landscape
Direct competitors
Indirect/adjacent competitors
Market positioning of each
Search volume for competitor terms
Goals
SEO traffic capture
Sales enablement
Conversion from competitor users
Brand positioning
Core Principles
1. Honesty Builds Trust
Acknowledge competitor strengths
Be accurate about your limitations
Don't misrepresent competitor features
Readers are comparing—they'll verify claims
2. Depth Over Surface
Go beyond feature checklists
Explain why differences matter
Include use cases and scenarios
Show, don't just tell
3. Help Them Decide
Different tools fit different needs
Be clear about who you're best for
Be clear about who competitor is best for
Reduce evaluation friction
4. Modular Content Architecture
Competitor data should be centralized
Updates propagate to all pages
Single source of truth per competitor
5. Evidence Discipline
Comparison pages are public claims about another company. Every one should survive the competitor's own team reading it.
"Not observed" is not "doesn't have." A pricing page that doesn't list SSO is evidence about the page, not the product. Write "not listed on their pricing page (as of Mar 2026)" or drop the row. Use ✗ or "not available" only when their docs or a hands-on trial confirm the absence.
Date competitor facts. Pricing and features change. Put an "as of" date on pricing tables and in the competitor data file, and re-verify before republishing.
One look is a snapshot. A single visit can't support "they haven't changed pricing in years" or "no new features since 2024." That needs dated history (changelog, archived pages).
State what changed, not why. "They moved SSO to the Enterprise tier" is a fact. "Because they're squeezing upmarket" is a guess. Leave motive out unless they've said it publicly.
Separate fact from interpretation. Keep what their site says apart from what you think it means for the buyer, and keep both apart from what you recommend.
Page Formats
Format 1: [Competitor] Alternative (Singular)
Search intent: User is actively looking to switch from a specific competitor
URL pattern: /alternatives/[competitor] or /[competitor]-alternative
Target keywords: "[Competitor] alternative", "alternative to [Competitor]", "switch from [Competitor]"
Page structure:
Why people look for alternatives (validate their pain)
Summary: You as the alternative (quick positioning)
Detailed comparison (features, service, pricing)
Who should switch (and who shouldn't)
Migration path
Social proof from switchers
CTA
Format 2: [Competitor] Alternatives (Plural)
Search intent: User is researching options, earlier in journey
URL pattern: /alternatives/[competitor]-alternatives
Target keywords: "[Competitor] alternatives", "best [Competitor] alternatives", "tools like [Competitor]"
Page structure:
Why people look for alternatives (common pain points)
What to look for in an alternative (criteria framework)
List of alternatives (you first, but include real options)
Comparison table (summary)
Detailed breakdown of each alternative
Recommendation by use case
CTA
Important: Include 4-7 real alternatives. Being genuinely helpful builds trust and ranks better.
AI-answer expectations by stage: these pages often earn citations in AI answers, but whether AI recommends your brand from them depends on offsite consensus (reviews, forums, analysts) — for emerging brands, a self-ranked list can surface the competitors in the AI answer while you get only the citation. Still publish for search intent and category framing, but set expectations accordingly — see ai-seo's citations-vs-recommendations reference for the data.
Format 3: You vs [Competitor]
Search intent: User is directly comparing you to a specific competitor
URL pattern: /vs/[competitor] or /compare/[you]-vs-[competitor]
Target keywords: "[You] vs [Competitor]", "[Competitor] vs [You]"
Page structure:
TL;DR summary (key differences in 2-3 sentences)
At-a-glance comparison table
Detailed comparison by category (Features, Pricing, Support, Ease of use, Integrations)
Who [You] is best for
Who [Competitor] is best for (be honest)
What customers say (testimonials from switchers)
Migration support
CTA
Format 4: [Competitor A] vs [Competitor B]
Search intent: User comparing two competitors (not you directly)
URL pattern: /compare/[competitor-a]-vs-[competitor-b]
Page structure:
Overview of both products
Comparison by category
Who each is best for
The third option (introduce yourself)
Comparison table (all three)
CTA
Why this works: Captures search traffic for competitor terms, positions you as knowledgeable.
Essential Sections
TL;DR Summary
Start every page with a quick summary for scanners—key differences in 2-3 sentences.
Paragraph Comparisons
Go beyond tables. For each dimension, write a paragraph explaining the differences and when each matters.
Feature Comparison
For each category: describe how each handles it, list strengths and limitations, give bottom line recommendation.
Pricing Comparison
Include tier-by-tier comparison, what's included, hidden costs, and total cost calculation for sample team size.
Who It's For
Be explicit about ideal customer for each option. Honest recommendations build trust.
Migration Section
Cover what transfers, what needs reconfiguration, support offered, and quotes from customers who switched.
For detailed templates: See references/templates.md
Content Architecture
Centralized Competitor Data
Create a single source of truth for each competitor with:
Positioning and target audience
Pricing (all tiers)
Feature ratings
Strengths and weaknesses
Best for / not ideal for
Common complaints (from reviews)
Migration notes
For data structure and examples: See references/content-architecture.md
Research Process
Deep Competitor Research
For each competitor, gather:
Product research: Sign up, use it, document features/UX/limitations
Pricing research: Current pricing, what's included, hidden costs
Review mining: G2, Capterra, TrustRadius for common praise/complaint themes
Customer feedback: Talk to customers who switched (both directions)
Content research: Their positioning, their comparison pages, their changelog
Ongoing Updates
Quarterly: Verify pricing, check for major feature changes
When notified: Customer mentions competitor change
Annually: Full refresh of all competitor data
Competitive Asset Audit
When asked to check existing competitive content for stale or risky claims, audit every asset that makes claims about competitors: vs and alternative pages, battle cards, talk tracks, objection docs, and comparison tables in decks.
List each claim about a competitor, with the asset and line it lives in.
Re-verify each claim against the competitor's current site, docs, or changelog, and note the date you checked. If you can't browse, mark claims unchecked and list what to verify. Never mark one Current without a check date.
Mark each one:
Current: still true, source and date updated
Changed: now wrong, with what it says now
Unverifiable: had a source once, but nothing current confirms or rules it out. Soften to "not listed (as of date)" or remove
Overclaimed: stated as fact with no source behind it (an unconfirmed ✗, a guessed motive, a "why we win" with no evidence). Rewrite to what the evidence supports or remove
Prioritize fixes: public pages first (buyers and competitors read them), then anything reps say on calls, then internal docs.
Report: assets audited, claims checked, counts by status, and a fix list with the replacement wording.
Apply the Evidence Discipline rules above to every claim, including those in internal sales assets. Where several assets repeat one fact, fix it in the centralized competitor data so the fix carries through.
SEO Considerations
Keyword Targeting
| Format | Primary Keywords |
|---|---|
| Alternative (singular) | [Competitor] alternative, alternative to [Competitor] |
| Alternatives (plural) | [Competitor] alternatives, best [Competitor] alternatives |
| You vs Competitor | [You] vs [Competitor], [Competitor] vs [You] |
| Competitor vs Competitor | [A] vs [B], [B] vs [A] |
Internal Linking
Link between related competitor pages
Link from feature pages to relevant comparisons
Create hub page linking to all competitor content
Schema Markup
Consider FAQ schema for common questions like "What is the best alternative to [Competitor]?"
Output Format
Competitor Data File
Complete competitor profile in YAML format for use across all comparison pages.
Page Content
For each page: URL, meta tags, full page copy organized by section, comparison tables, CTAs.
Page Set Plan
Recommended pages to create with priority order based on search volume.
Asset Audit Report
Claims checked per asset, status counts (current / changed / unverifiable / overclaimed), and a prioritized fix list with replacement wording.
Task-Specific Questions
What are common reasons people switch to you?
Do you have customer quotes about switching?
What's your pricing vs. competitors?
Do you offer migration support?
Related Skills
programmatic-seo: For building competitor pages at scale
copywriting: For writing compelling comparison copy
seo-audit: For optimizing competitor pages
schema: For FAQ and comparison schema
sales-enablement: For battle cards and internal sales collateral, decks, and objection docs
Files
- ATTRIBUTION.mdAdded by AutoGineer883 B
- LICENSELicence file added by AutoGineer1.0 KiB
- SKILL.md11.8 KiB
- evals/evals.json8.9 KiB
- references/content-architecture.md7.6 KiB
- references/templates.md5.5 KiB
references/content-architecture.md
Content Architecture for Competitor Pages
How to structure and maintain competitor data for scalable comparison pages.
Contents
Centralized Competitor Data
Competitor Data Template
Your Product Data
Page Generation
Index Page Structure (alternatives index, vs comparisons index, index page best practices)
Footer Navigation
Centralized Competitor Data
Create a single source of truth for each competitor:
competitor_data/
├── notion.md
├── airtable.md
├── monday.md
└── ...Competitor Data Template
Per competitor, document:
name: Notion
website: notion.so
tagline: "The all-in-one workspace"
founded: 2016
headquarters: San Francisco
# Positioning
primary_use_case: "docs + light databases"
target_audience: "teams wanting flexible workspace"
market_position: "premium, feature-rich"
# Provenance (re-verify before republishing)
last_verified: 2026-03-14
sources:
pricing: notion.so/pricing
features: notion.so/help + hands-on trial
# Pricing
pricing_model: per-seat
free_tier: true
free_tier_limits: "limited blocks, 1 user"
starter_price: $8/user/month
business_price: $15/user/month
enterprise: custom
# Features (rate 1-5 or describe)
features:
documents: 5
databases: 4
project_management: 3
collaboration: 4
integrations: 3
mobile_app: 3
offline_mode: 2
api: 4
# Strengths (be honest)
strengths:
- Extremely flexible and customizable
- Beautiful, modern interface
- Strong template ecosystem
- Active community
# Weaknesses (be fair)
weaknesses:
- Can be slow with large databases
- Learning curve for advanced features
- Limited automations compared to dedicated tools
- Offline mode is limited
# Best for
best_for:
- Teams wanting all-in-one workspace
- Content-heavy workflows
- Documentation-first teams
- Startups and small teams
# Not ideal for
not_ideal_for:
- Complex project management needs
- Large databases (1000s of rows)
- Teams needing robust offline
- Enterprise with strict compliance
# Common complaints (from reviews)
common_complaints:
- "Gets slow with lots of content"
- "Hard to find things as workspace grows"
- "Mobile app is clunky"
# Migration notes
migration_from:
difficulty: medium
data_export: "Markdown, CSV, HTML"
what_transfers: "Pages, databases"
what_doesnt: "Automations, integrations setup"
time_estimate: "1-3 days for small team"Your Product Data
Same structure for yourself—be honest:
name: [Your Product]
# ... same fields
strengths:
- [Your real strengths]
weaknesses:
- [Your honest weaknesses]
best_for:
- [Your ideal customers]
not_ideal_for:
- [Who should use something else]Page Generation
Each page pulls from centralized data:
[Competitor] Alternative page: Pulls competitor data + your data
[Competitor] Alternatives page: Pulls competitor data + your data + other alternatives
You vs [Competitor] page: Pulls your data + competitor data
[A] vs [B] page: Pulls both competitor data + your data
Benefits:
Update competitor pricing once, updates everywhere
Add new feature comparison once, appears on all pages
Consistent accuracy across pages
Easier to maintain at scale
Index Page Structure
Alternatives Index
URL: /alternatives or /alternatives/index
Purpose: Lists all "[Competitor] Alternative" pages
Page structure:
Headline: "[Your Product] as an Alternative"
Brief intro on why people switch to you
List of all alternative pages with:
Competitor name/logo
One-line summary of key differentiator vs. that competitor
Link to full comparison
Common reasons people switch (aggregated)
CTA
Example:
## Explore [Your Product] as an Alternative
Looking to switch? See how [Your Product] compares to the tools you're evaluating:
- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]
- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]
- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]Vs Comparisons Index
URL: /vs or /compare
Purpose: Lists all "You vs [Competitor]" and "[A] vs [B]" pages
Page structure:
Headline: "Compare [Your Product]"
Section: "[Your Product] vs Competitors" — list of direct comparisons
Section: "Head-to-Head Comparisons" — list of [A] vs [B] pages
Brief methodology note
CTA
Index Page Best Practices
Keep them updated: When you add a new comparison page, add it to the relevant index.
Internal linking:
Link from index → individual pages
Link from individual pages → back to index
Cross-link between related comparisons
SEO value:
Index pages can rank for broad terms like "project management tool comparisons"
Pass link equity to individual comparison pages
Help search engines discover all comparison content
Sorting options:
By popularity (search volume)
Alphabetically
By category/use case
By date added (show freshness)
Include on index pages:
Last updated date for credibility
Number of pages/comparisons available
Quick filters if you have many comparisons
Footer Navigation
The site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.
Option 1: Link to Index Pages (Minimum)
At minimum, add links to your comparison index pages in the footer:
Footer
├── Compare
│ ├── Alternatives → /alternatives
│ └── Comparisons → /vsThis ensures every marketing page passes link equity to your comparison content hub.
Option 2: Footer Columns by Format (Recommended for SEO)
For stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:
Footer
├── [Product] vs ├── Alternatives to ├── Compare
│ ├── vs Notion │ ├── Notion Alternative │ ├── Notion vs Airtable
│ ├── vs Airtable │ ├── Airtable Alternative │ ├── Monday vs Asana
│ ├── vs Monday │ ├── Monday Alternative │ ├── Notion vs Monday
│ ├── vs Asana │ ├── Asana Alternative │ ├── ...
│ ├── vs Clickup │ ├── Clickup Alternative │ └── View all →
│ ├── ... │ ├── ... │
│ └── View all → │ └── View all → │Guidelines:
Include up to 8 links per column (top competitors by search volume)
Add "View all" link to the full index page
Only create columns for formats you've actually built pages for
Prioritize competitors with highest search volume
Why Footer Links Matter
Sitewide distribution: Footer links appear on every marketing page, passing link equity from your entire site to comparison content
Crawl efficiency: Search engines discover all comparison pages quickly
User discovery: Visitors evaluating your product can easily find comparisons
Competitive positioning: Signals to search engines that you're a key player in the space
Implementation Notes
Update footer when adding new high-priority comparison pages
Keep footer clean—don't list every comparison, just the top ones
Match column headers to your URL structure (e.g., "vs" column →
/vs/URLs)Consider mobile: columns may stack, so order by priority
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Corey Haines
- Publisher
- Corey Haines (Community)
- Source
- coreyhaines31/marketingskills · skills/competitors · commit 96798cf
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Corey Haines or Corey Haines.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download competitors.zip