competitive-battlecard-generator

name	competitive-battlecard-generator
description	Use when analyzing competitors, creating sales battlecards, building competitive positioning, preparing for competitive deals, or updating competitive intelligence. Triggers: 'battlecard for [competitor]', 'competitive analysis of [competitor]', 'how do we beat [competitor]', 'compare us to [competitor]', 'competitive intel', 'win against [competitor]'.
version	1.0.0

Competitive Battlecard Generator

Generate comprehensive, actionable competitive battlecards using WebSearch. Each battlecard gives sales teams the intelligence they need to win competitive deals — competitor strengths, weaknesses, objection handling, and trap questions, all grounded in real research. Can batch-process up to 5 competitors in a single run.

---

Activation

When the user triggers this skill, follow the steps below in order. Do NOT skip the input step. Do NOT produce a battlecard without gathering context first.

---

Step 1 — Collect Input

Ask the user for these inputs all at once in a numbered list:

I need some context before building your battlecard(s). Answer these questions:

1. What is your company name and what do you do? (one sentence)
2. Which competitor(s) do you want a battlecard for? (1-5 names)
3. (Optional) What are your key differentiators? (3-5 bullets)
4. (Optional) Any known weaknesses of the competitor(s)?
5. (Optional) Are you usually compared to them? In what context?

Rules for this step:

• Wait for the user to respond before proceeding. Do NOT generate placeholder answers.
• Only question 1 and 2 are required. If either is missing, ask again.
• If the user provides more than 5 competitors, tell them you will batch the first 5 and they can run the skill again for the rest.
• If the user provides optional inputs, use them to sharpen the analysis. If they skip optionals, proceed without them — you will research independently.

---

Step 2 — Competitor Overview

For each competitor, run 2-3 WebSearch queries to establish a factual baseline.

Search patterns:

• "{competitor} what does it do" or "{competitor} company overview"
• "{competitor} funding crunchbase" or "{competitor} series funding investors"
• "{competitor} customers case studies" or "{competitor} pricing"

Gather these data points:

Field	Description
What they do	Their positioning statement — how they describe themselves (from their homepage or about page)
Founded	Year founded
HQ	Headquarters location
Company size	Employee count range
Funding	Total raised, last round, key investors (for private companies)
Key customers	Named logos from case studies, website, or press releases (3-8 names)
Target market	Who they sell to — company size, industry, buyer persona
Pricing model	Pricing tiers, per-seat, usage-based, etc. If not publicly available, write "Pricing not publicly available — ask during discovery"
Recent news	1-3 headlines from the last 90 days with source URLs

Rules:

• If any data point is not findable after searching, write "Not found." Never fabricate company data.
• Always include the source URL for each data point in the Sources section.

---

Step 3 — Their Pitch

For each competitor, run 1-2 WebSearch queries to document their messaging.

Search patterns:

• "{competitor}" (homepage messaging)
• "{competitor} why choose us" or "{competitor} vs alternatives"

Gather:

Field	Description
Main value proposition	Their primary claim — the one sentence from their homepage or hero section
Top 3-5 claims	The specific promises they make (speed, accuracy, cost savings, ease of use, etc.)
How they differentiate	What they say makes them different from competitors
Key messaging themes	Recurring themes across their marketing (innovation, simplicity, enterprise-grade, etc.)
Awards or recognition	Analyst reports (Gartner, Forrester), G2 badges, industry awards they highlight

---

Step 4 — Strengths Analysis

Honestly assess what the competitor does well. A battlecard that ignores competitor advantages is useless — sales reps will lose credibility if they dismiss a competitor that the prospect already likes.

For each competitor, run 1-2 WebSearch queries.

Search patterns:

• "{competitor} reviews G2" or "why I chose {competitor}"
• "{competitor} case study results"

Document:

Field	Description
What they do well	Objective strengths — features, UX, integrations, market position
Where they have an advantage over you	Be honest. If they are better at something, say so. This helps reps prepare instead of getting blindsided.
What their customers love	Pull from reviews, testimonials, and case studies
Why companies choose them	The top 2-3 reasons buyers pick them over alternatives

---

Step 5 — Weaknesses Analysis

Use WebSearch aggressively to find real complaints, criticisms, and gaps. This is the highest-value section of the battlecard.

Run 3-4 WebSearch queries per competitor:

Search patterns:

• "{competitor} reviews complaints" or "{competitor} negative reviews G2 Capterra"
• "{competitor} reddit problems" or "{competitor} reddit complaints"
• "{competitor} issues limitations" or "switching from {competitor}"
• "{competitor} vs" (often surfaces comparison articles that highlight weaknesses)

Organize weaknesses into categories:

Category	What to look for
Feature gaps	Missing capabilities that buyers frequently ask about
Pricing complaints	Too expensive, hidden fees, forced annual contracts, price increases
Support/service issues	Slow support, poor onboarding, unresponsive account management
Implementation difficulties	Long setup times, complex configuration, migration pain
Product quality	Bugs, downtime, performance issues, outdated UI
Customer churn signals	People posting about leaving, "alternatives to {competitor}" searches
Scalability concerns	Breaks at volume, enterprise readiness gaps

Rules:

• Every weakness claim must have a source (URL, review platform, Reddit thread). Never invent criticisms.
• Distinguish between isolated complaints and patterns. A single bad review is an anecdote; five reviews mentioning the same issue is a pattern.

---

Step 6 — Win/Loss Patterns

Based on all research gathered so far, synthesize win/loss patterns. If the user provided optional inputs in Step 1 (known weaknesses, comparison context), factor those in.

Run 1-2 additional WebSearch queries if needed:

Search patterns:

• "{competitor} vs {your company}" or "why I switched from {competitor}"
• "{competitor} alternative for {use case}"

Document four categories:

Category	Description
When you WIN against them	Conditions, buyer profiles, and use cases where you have the advantage. Be specific: company size, industry, technical requirements, decision-maker priorities.
When you LOSE to them	Conditions where they are stronger. Sales reps need to know when they are walking into a tough fight.
Deal killers	Specific things that make the competitor unbeatable for certain buyers (e.g., "If the buyer needs X integration, they will choose {competitor} every time — we do not support it yet")
Landmine questions	3-5 questions that expose the competitor's weaknesses without being negative. These are questions the sales rep can suggest the prospect ask the competitor during their evaluation.

---

Step 7 — Objection Handling

For each competitor, create 5-8 objection handling entries. These should cover the most common things a prospect says when they are leaning toward the competitor.

Format for each entry:

They Say	The Truth	We Say
{What the prospect or competitor claims}	{The reality behind the claim — factual, sourced where possible}	{Your counter-positioning — conversational tone, not corporate speak}

Rules:

• "They Say" should be phrased as the prospect would say it, not as a formal objection label. Example: "But {competitor} has better integrations" — not "Integration breadth objection."
• "The Truth" must be factual and fair. Acknowledge if the claim has merit, then provide the nuance.
• "We Say" must be conversational. Write it the way a sales rep would actually say it on a call. No jargon, no buzzwords, no corporate positioning statements.
• If you do not have enough information to fill 5 entries, fill what you can and note which objections need input from the user's sales team.

---

Step 8 — Trap Questions

Write 3-5 questions that a prospect can ask the competitor during their evaluation. These questions are designed to expose the competitor's weaknesses — but they must sound natural, not hostile.

For each trap question, provide:

1. The question — phrased the way a prospect would naturally ask it
2. Why it matters — what this question reveals about the competitor
3. What a good answer looks like — if the competitor answers well, they may genuinely be strong here
4. What a bad answer looks like — how the competitor will likely dodge, deflect, or struggle

Rules:

• Trap questions must never sound loaded or aggressive. They should sound like normal due-diligence questions a smart buyer would ask any vendor.
• Each question should target a different weakness (do not cluster all questions around the same issue).
• Ground each question in a real weakness found in Step 5.

---

Step 9 — Positioning Statement

For each competitor, write a concise positioning statement that a sales rep can use when the competitor comes up in conversation.

Three components:

Component	What to write
When they come up	One sentence to acknowledge the competitor without dismissing them. Shows respect and confidence.
How to differentiate	2-3 sentences explaining the user's angle — why the user's product is a better choice for certain buyers. Must be specific, not generic "we're better."
When to compete vs. walk away	One sentence defining when this is a winnable deal vs. when the sales rep should focus elsewhere.

---

Step 10 — Output

Per-Competitor Battlecard: docs/battlecards/{competitor-name-slug}.md

The slug is the competitor name lowercased with spaces replaced by hyphens and special characters removed (e.g., "Scale AI" becomes scale-ai, "HubSpot" becomes hubspot).

Create the docs/battlecards/ directory if it does not exist.

Use this structure:

# {Competitor Name} — Competitive Battlecard

**Generated:** {YYYY-MM-DD}
**Your Company:** {user's company name}
**Refresh Cadence:** Quarterly — battlecards go stale fast. Re-run this skill every 90 days.

---

## Company Details

| Field | Detail |
|---|---|
| **What they do** | {positioning statement} |
| **Founded** | {year} |
| **HQ** | {location} |
| **Employees** | {count or range} |
| **Funding** | {total raised, last round, key investors} |
| **Key Customers** | {logos} |
| **Target Market** | {who they sell to} |
| **Pricing** | {model and tiers, or "Not publicly available"} |

### Recent News
- {headline} — [{source}]({url}) ({date})
- ...

---

## Their Pitch

**Value Proposition:** {main claim}

**Top Claims:**
1. {claim}
2. {claim}
3. {claim}

**Differentiation Angle:** {how they describe what makes them different}

**Messaging Themes:** {recurring themes}

**Awards/Recognition:** {analyst mentions, badges, awards}

---

## Why {Your Company} Wins

### A | {Advantage Category 1}
{Description with proof points. Why the user's product is better in this dimension. Include specific evidence — features, customer quotes, benchmarks.}

### B | {Advantage Category 2}
{Description with proof points.}

### C | {Advantage Category 3}
{Description with proof points.}

---

## Their Strengths (Know What You're Up Against)

{Honest assessment. What they do well, where they have an advantage, what customers love. Sales reps who dismiss competitor strengths lose credibility.}

---

## Their Weaknesses

{Organized by category: feature gaps, pricing complaints, support issues, implementation difficulties, product quality, churn signals. Every claim cited with a source.}

---

## When We Win vs. Lose

| Scenario | Outcome | Why |
|----------|---------|-----|
| {Buyer profile / use case / conditions} | **WIN** | {Why you win in this scenario} |
| {Buyer profile / use case / conditions} | **WIN** | {Why you win in this scenario} |
| {Buyer profile / use case / conditions} | **LOSE** | {Why you lose in this scenario} |
| {Buyer profile / use case / conditions} | **LOSE** | {Why you lose in this scenario} |

**Deal Killers:** {Things that make the competitor unbeatable for certain buyers}

---

## Objection Handling

| They Say | The Truth | We Say |
|----------|-----------|--------|
| "{prospect/competitor claim}" | {reality behind the claim} | "{conversational counter-positioning}" |
| ... | ... | ... |

---

## Trap Questions

1. **"{Natural-sounding question}"**
   - *Why it matters:* {what this question reveals}
   - *Good answer:* {what it looks like if they handle it well}
   - *Bad answer:* {how they will likely dodge or struggle}

2. **"{Natural-sounding question}"**
   - *Why it matters:* ...
   - *Good answer:* ...
   - *Bad answer:* ...

3. ...

---

## Quick Positioning

> **When they come up:** {one sentence to acknowledge them}
>
> **How to differentiate:** {2-3 sentences — your angle}
>
> **Compete or walk away:** {one sentence — when to fight, when to focus elsewhere}

---

## Sources

- [{description}]({url})
- [{description}]({url})
- ...

---

*Last Updated: {YYYY-MM-DD} | Refresh quarterly or when major competitor news breaks.*

Summary File: docs/battlecards/README.md

If this file already exists, update it. If not, create it.

# Competitive Battlecards

Last updated: {YYYY-MM-DD}

## Competitor Summary

| Competitor | One-Line Summary | Biggest Weakness | When We Win | When We Lose | Battlecard |
|---|---|---|---|---|---|
| {Name} | {What they do in one sentence} | {Top weakness} | {Top win scenario} | {Top loss scenario} | [{name}.md](./{slug}.md) |
| ... | ... | ... | ... | ... | ... |

---

*Refresh quarterly. Run the Competitive Battlecard Generator skill to update or add new competitors.*

When updating README.md, merge new competitor entries with any existing rows. If a competitor was previously listed, replace its row with the new data.

---

Tools

Tool	Purpose
WebSearch	Primary tool. Run 10-15 searches per competitor to cover all sections. Batch independent searches into the same message to run in parallel.
Read	Check if docs/battlecards/README.md or existing battlecards already exist.
Write	Output the battlecard file and update the README.
Glob	Check docs/battlecards/ for existing battlecard files to avoid overwriting without warning.

---

Rules (Non-Negotiable)

1. Be honest about competitor strengths. A battlecard that pretends the competitor has no advantages is worse than useless — it destroys sales rep credibility. Acknowledge what they do well, then show why you still win.
2. Always cite sources. Every weakness claim, review quote, and factual assertion must trace back to a URL in the Sources section. No source, no claim.
3. Trap questions must sound natural. They should read like normal due-diligence questions a smart buyer would ask any vendor. Never hostile, never loaded.
4. Objection handling must be conversational. Write "We Say" entries the way a sales rep would actually talk on a call. No corporate jargon, no buzzword-laden positioning statements.
5. Never fabricate data. If WebSearch returns nothing for a data point, write "Not found." Do not invent funding amounts, employee counts, customer names, or review quotes.
6. Handle pricing honestly. If pricing is not publicly available, write "Pricing not publicly available — ask during discovery." Do not guess pricing.
7. Include a refresh date. Every battlecard must include a "Last Updated" date and a note that battlecards should be refreshed quarterly. Competitive intelligence goes stale fast.
8. Check for existing battlecards. Before writing, use Glob to check docs/battlecards/ for an existing file for this competitor. If one exists, tell the user and ask: "A battlecard for {competitor} already exists (last updated {date}). Do you want to (A) overwrite it with fresh research, or (B) skip this competitor?"
9. No internal references. This skill is part of a public playbook. Never reference internal tools, client names, Notion databases, or proprietary infrastructure.
10. Works universally. This skill works for any B2B company analyzing any competitor. Do not assume a specific industry, company size, or GTM motion.
11. Create directories as needed. If docs/battlecards/ does not exist, create it before writing files.
12. Cap at 5 competitors per run. If the user asks for more than 5, process the first 5 and tell them to run the skill again for the rest. Each competitor requires 10-15 searches — more than 5 in a single run degrades quality.