competitor-alternatives

Overview

What the competitor-alternatives skill does

The competitor-alternatives skill helps you create high-quality competitor comparison and alternative pages that work for both SEO and sales. It is tuned for queries like:

• "[Competitor] alternatives"
• "Best [Tool] alternatives"
• "[Product] vs [Product]"
• "comparison page" or "competitor comparison"
• "battle card" or "competitor teardown"

The skill focuses on four repeatable formats:

1. Singular alternative – "Best alternative to [Competitor]" where your product is the main focus.
2. Plural alternatives – "Best [Competitor] alternatives" list posts that still position your product strongly.
3. You vs competitor – "[Your Product] vs [Competitor]" head‑to‑head pages.
4. Competitor vs competitor – comparisons where you are not named in the title but still want to be featured.

It is designed to produce pages that:

• Rank for competitive search terms with clear intent (alternatives, vs, comparison).
• Provide honest, detailed assessments (not just shallow feature checklists).
• Give evaluators practical guidance on which tool is right for them.
• Arm sales and success teams with consistent comparison narratives and battle cards.

Who this skill is for

Use competitor-alternatives if you are:

• A product marketer or growth marketer owning comparison and alternatives content.
• An SEO specialist building a cluster of high-intent competitive landing pages.
• A content marketer tasked with "[Competitor] alternatives" lists or "[Tool] vs [Tool]" posts.
• A founder or PM creating competitor teardowns or internal battle cards.
• A developer or ops person building a system to generate consistent comparison pages from structured data.

If you primarily need detailed sales playbooks and objection handling (not web pages), pair this with the separate sales-enablement skill which is aimed at sales-specific docs.

Problems the skill solves

The competitor-alternatives skill is built to address common issues with comparison content:

• Shallow pages that do not convert – It encourages depth over surface, using structured sections, tables, and narrative comparisons.
• Biased or unbelievable claims – The guidance emphasizes honest strengths and weaknesses to build trust.
• Inconsistent messaging across pages – Centralized competitor data and templates keep positioning consistent.
• Hard-to-scale comparison content – Modular content architecture lets you reuse competitor data across many alternatives and vs pages.
• SEO pages that ignore buyer needs – The skill balances keyword targeting with practical evaluation criteria (pricing, features, who it is best for, migration, support, etc.).

If you need generic blog posts or top-of-funnel content that is not about competitors or alternatives, another content-focused skill will be a better fit.

How to Use

1. Install the competitor-alternatives skill

To add this skill to your project, install it from the marketingskills repository:

npx skills add https://github.com/coreyhaines31/marketingskills --skill competitor-alternatives

This pulls in the competitor-alternatives skill definition plus supporting reference material and evaluation prompts, so you can understand and adapt the workflow.

After installation, confirm the key files are available under the skill directory, including:

• SKILL.md
• evals/evals.json
• references/content-architecture.md
• references/templates.md

2. Review the core guidance in SKILL.md

Open SKILL.md first. It explains how the skill thinks about competitor and alternative pages, including:

• The goal: pages that rank, help evaluators, and position your product clearly.
• The Initial Assessment process: understand your product and the competitive landscape before writing.
• Core principles such as honesty, depth, and audience clarity.

Before drafting content, follow the initial assessment steps:

1. Check for product marketing context

   • If .agents/product-marketing-context.md exists (or .claude/product-marketing-context.md in older setups), read it first.
   • Use that file as your primary source of truth about positioning, ICP, pricing, and messaging.

2. Clarify your product

   • Core value proposition.
   • Key differentiators.
   • Ideal customer profile.
   • Pricing model.
   • Real strengths and honest weaknesses.

3. Map the competitive landscape

   • Direct competitors.
   • Indirect or adjacent competitors.
   • Market positioning for each.
   • Search demand around competitor and alternatives queries.

Having this context ready makes the skill’s outputs much more accurate and credible.

3. Structure your competitor data for scale

The references/content-architecture.md file shows how to build a scalable content architecture for competitor pages. A typical setup uses a centralized competitor data directory, for example:

competitor_data/
├── notion.md
├── airtable.md
├── monday.md
└── ...

Each competitor file can follow a template like the one in content-architecture.md, capturing:

• Basic profile (name, website, tagline, founding details, headquarters).
• Positioning (primary use case, target audience, market position).
• Pricing (model, tiers, free plan details).
• Features (scored or described by capability).
• Strengths and weaknesses (honest, specific statements).
• Best-fit use cases and ideal customers.

This makes it easier to:

• Reuse the same competitor facts across many alternatives and vs pages.
• Keep pricing, feature descriptions, and messaging in sync over time.
• Generate comparison tables and "who it is best for" sections programmatically if desired.

4. Use the templates for consistent sections

Open references/templates.md to see ready-made section templates for competitor pages. These cover:

• TL;DR Summary – a concise, skimmable overview that compares your product and the competitor.
• Paragraph comparison sections – narrative comparisons by dimension (features, pricing, support, etc.), not just bullet lists.
• Feature comparison – detailed breakdown by category, going beyond simple checkmarks.
• Pricing comparison – how each product prices, typical total cost, and tradeoffs.
• Service & support – onboarding, support channels, SLAs, and success resources.
• Who it is for – which segments are best served by each product.
• Migration – what it looks like to switch from a competitor to your product.
• Social proof – reviews, case studies, logos, and proof points.
• Comparison table best practices – how to present tables clearly and fairly.

You can copy these templates into your own content system and fill them in using your centralized competitor data. The skill is optimized to follow this structure when generating or editing content.

5. Match the format to the request

The evals/evals.json file gives concrete examples of the formats the competitor-alternatives skill is tuned for, such as:

• Plural alternatives pages – e.g. "Best Asana Alternatives".

  • Should identify this as the plural alternatives format.
  • Should include sections like:
    • TL;DR comparison.
    • Short paragraphs on each alternative (with your product featured prominently when appropriate).
    • Feature comparison table.
    • Pricing comparison.
    • "Who it is best for" per alternative.
    • Keyword-aware SEO handling for the target alternatives term.

• Head-to-head vs pages – e.g. "HubSpot vs Salesforce" where one side is your product.

  • Should recognize it as a vs comparison format.
  • Should analyze where each product wins or loses for the target audience.
  • Should position your product clearly without ignoring the competitor’s strengths.

Use these examples to:

• Validate your own prompts against what the skill expects.
• Understand how the skill balances SEO, clarity, and honesty.
• Design your own internal evals for additional competitor scenarios.

6. Integrate into your workflow

Once installed and understood, you can integrate competitor-alternatives into your broader workflow:

• For SEO

  • Plan an alternatives and vs-page roadmap based on your competitor list and search demand.
  • Use the skill to draft or improve each page using consistent templates.
  • Ensure on-page elements (titles, H1s, meta descriptions, internal links) follow SEO best practices outlined in your product marketing context.

• For sales enablement

  • Turn the core comparison narrative into internal battle cards.
  • Keep a single set of competitor facts that both marketing and sales teams reference.
  • For deeper sales content (talk tracks, objection handling), use the sales-enablement skill in parallel.

• For documentation and product sites

  • Use the modular architecture to generate comparison sections in docs, pricing pages, and feature overviews.
  • Keep competitor-sensitive content up to date without rewriting each page from scratch.

FAQ

When should I use the competitor-alternatives skill?

Use competitor-alternatives whenever you are creating content that compares your product to other tools, especially for:

• "[Competitor] alternatives" or "Best [Competitor] alternatives" pages.
• "[Your Product] vs [Competitor]" feature and pricing comparisons.
• "[Competitor A] vs [Competitor B]" pages where you appear as an alternative.
• Competitor teardowns and battle-card style comparison docs that may be adapted for the website.

If the content is not about competitors or alternatives (for example, a product launch blog or onboarding guide), this skill is not the best fit.

What formats does competitor-alternatives support?

The skill is explicitly designed for four main formats:

1. Singular alternative – you as the main alternative to a named competitor.
2. Plural alternatives – multi-tool lists targeting "[Competitor] alternatives" queries.
3. You vs competitor – direct side-by-side comparisons in a vs page.
4. Competitor vs competitor – third-party comparisons where you appear as an alternative or in follow-up sections.

In all cases, it prioritizes clear positioning, honest pros and cons, and practical guidance for evaluators.

How honest should these comparison pages be?

The guidance in SKILL.md emphasizes that honesty builds trust. You should:

• Clearly state where competitors are stronger.
• Acknowledge tradeoffs and segments where your product is not the best fit.
• Focus on your real differentiators instead of claiming to be the best at everything.

This approach tends to:

• Increase credibility with evaluators.
• Reduce buyer’s remorse and churn.
• Support long-term brand trust, even if some readers choose another tool.

Do I need structured competitor data to use this skill?

You can use competitor-alternatives without a full data system, but it is most effective when you follow the content architecture in references/content-architecture.md:

• Maintain a structured file for each competitor.
• Capture pricing, features, strengths, weaknesses, and ideal customer segments.
• Reuse that data across alternatives pages, vs pages, and internal docs.

This makes your comparison content more consistent, scalable, and easier to update.

How does this skill support SEO for alternatives and vs pages?

The skill is designed with competitive search intent in mind:

• It recognizes alternatives and vs-page formats from the prompt.
• It encourages clear TL;DR sections and headings that match search queries.
• It integrates feature and pricing comparisons that align with how evaluators search.
• It promotes modular content so you can build internal links and index pages (alternatives index, vs comparisons index) as described in content-architecture.md.

You should still apply your usual SEO basics (keyword research, internal linking, on-page metadata), but the skill helps ensure the content structure and depth meet searcher expectations.

How is this different from the sales-enablement skill?

competitor-alternatives is focused on public-facing comparison content and SEO-driven landing pages.

The sales-enablement skill is focused on internal sales documents, such as battle cards, objection handling, and talk tracks.

Use competitor-alternatives to create pages that live on your marketing site, and use sales-enablement to create internal resources for sales and success teams. The two skills are complementary and can share the same underlying competitor data.

Where should I start after installing the skill?

After installation, a practical path is:

1. Open SKILL.md and read the Initial Assessment section.
2. Check for .agents/product-marketing-context.md (or .claude/product-marketing-context.md) and update it if needed.
3. Review references/content-architecture.md and decide how you will store competitor data.
4. Use references/templates.md to define your standard page layout for alternatives and vs comparisons.
5. Use the examples in evals/evals.json to craft your first few prompts and validate outcomes.

Following these steps will help you decide how to integrate competitor-alternatives into your content and competitive analysis workflow effectively.