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:
- The question — phrased the way a prospect would naturally ask it
- Why it matters — what this question reveals about the competitor
- What a good answer looks like — if the competitor answers well, they may genuinely be strong here
- 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)
- 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.
- 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.
- Trap questions must sound natural. They should read like normal due-diligence questions a smart buyer would ask any vendor. Never hostile, never loaded.
- 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.
- 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.
- Handle pricing honestly. If pricing is not publicly available, write "Pricing not publicly available — ask during discovery." Do not guess pricing.
- 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.
- 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?"
- No internal references. This skill is part of a public playbook. Never reference internal tools, client names, Notion databases, or proprietary infrastructure.
- Works universally. This skill works for any B2B company analyzing any competitor. Do not assume a specific industry, company size, or GTM motion.
- Create directories as needed. If
docs/battlecards/ does not exist, create it before writing files.
- 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.
1---2name: competitive-battlecard-generator3description: 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]'.4---5
6# Competitive Battlecard Generator
7
8Generate 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.
9
10---
11
12## Activation
13
14When 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.
15
16---
17
18## Step 1 — Collect Input
19
20Ask the user for these inputs **all at once** in a numbered list:
21
22```
23I need some context before building your battlecard(s). Answer these questions:
24
251. What is your company name and what do you do? (one sentence)
262. Which competitor(s) do you want a battlecard for? (1-5 names)
273. (Optional) What are your key differentiators? (3-5 bullets)
284. (Optional) Any known weaknesses of the competitor(s)?
295. (Optional) Are you usually compared to them? In what context?
30```
31
32**Rules for this step:**
33- Wait for the user to respond before proceeding. Do NOT generate placeholder answers.
34- Only question 1 and 2 are required. If either is missing, ask again.
35- 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.
36- If the user provides optional inputs, use them to sharpen the analysis. If they skip optionals, proceed without them — you will research independently.
37
38---
39
40## Step 2 — Competitor Overview
41
42For each competitor, run 2-3 WebSearch queries to establish a factual baseline.
43
44**Search patterns:**
45- `"{competitor} what does it do"` or `"{competitor} company overview"`
46- `"{competitor} funding crunchbase"` or `"{competitor} series funding investors"`
47- `"{competitor} customers case studies"` or `"{competitor} pricing"`
48
49**Gather these data points:**
50
51| Field | Description |
52|---|---|
53| **What they do** | Their positioning statement — how they describe themselves (from their homepage or about page) |
54| **Founded** | Year founded |
55| **HQ** | Headquarters location |
56| **Company size** | Employee count range |
57| **Funding** | Total raised, last round, key investors (for private companies) |
58| **Key customers** | Named logos from case studies, website, or press releases (3-8 names) |
59| **Target market** | Who they sell to — company size, industry, buyer persona |
60| **Pricing model** | Pricing tiers, per-seat, usage-based, etc. If not publicly available, write "Pricing not publicly available — ask during discovery" |
61| **Recent news** | 1-3 headlines from the last 90 days with source URLs |
62
63**Rules:**
64- If any data point is not findable after searching, write "Not found." Never fabricate company data.
65- Always include the source URL for each data point in the Sources section.
66
67---
68
69## Step 3 — Their Pitch
70
71For each competitor, run 1-2 WebSearch queries to document their messaging.
72
73**Search patterns:**
74- `"{competitor}"` (homepage messaging)
75- `"{competitor} why choose us"` or `"{competitor} vs alternatives"`
76
77**Gather:**
78
79| Field | Description |
80|---|---|
81| **Main value proposition** | Their primary claim — the one sentence from their homepage or hero section |
82| **Top 3-5 claims** | The specific promises they make (speed, accuracy, cost savings, ease of use, etc.) |
83| **How they differentiate** | What they say makes them different from competitors |
84| **Key messaging themes** | Recurring themes across their marketing (innovation, simplicity, enterprise-grade, etc.) |
85| **Awards or recognition** | Analyst reports (Gartner, Forrester), G2 badges, industry awards they highlight |
86
87---
88
89## Step 4 — Strengths Analysis
90
91Honestly 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.
92
93For each competitor, run 1-2 WebSearch queries.
94
95**Search patterns:**
96- `"{competitor} reviews G2"` or `"why I chose {competitor}"`
97- `"{competitor} case study results"`
98
99**Document:**
100
101| Field | Description |
102|---|---|
103| **What they do well** | Objective strengths — features, UX, integrations, market position |
104| **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. |
105| **What their customers love** | Pull from reviews, testimonials, and case studies |
106| **Why companies choose them** | The top 2-3 reasons buyers pick them over alternatives |
107
108---
109
110## Step 5 — Weaknesses Analysis
111
112Use WebSearch aggressively to find real complaints, criticisms, and gaps. This is the highest-value section of the battlecard.
113
114Run 3-4 WebSearch queries per competitor:
115
116**Search patterns:**
117- `"{competitor} reviews complaints"` or `"{competitor} negative reviews G2 Capterra"`
118- `"{competitor} reddit problems"` or `"{competitor} reddit complaints"`
119- `"{competitor} issues limitations"` or `"switching from {competitor}"`
120- `"{competitor} vs"` (often surfaces comparison articles that highlight weaknesses)
121
122**Organize weaknesses into categories:**
123
124| Category | What to look for |
125|---|---|
126| **Feature gaps** | Missing capabilities that buyers frequently ask about |
127| **Pricing complaints** | Too expensive, hidden fees, forced annual contracts, price increases |
128| **Support/service issues** | Slow support, poor onboarding, unresponsive account management |
129| **Implementation difficulties** | Long setup times, complex configuration, migration pain |
130| **Product quality** | Bugs, downtime, performance issues, outdated UI |
131| **Customer churn signals** | People posting about leaving, "alternatives to {competitor}" searches |
132| **Scalability concerns** | Breaks at volume, enterprise readiness gaps |
133
134**Rules:**
135- Every weakness claim must have a source (URL, review platform, Reddit thread). Never invent criticisms.
136- Distinguish between isolated complaints and patterns. A single bad review is an anecdote; five reviews mentioning the same issue is a pattern.
137
138---
139
140## Step 6 — Win/Loss Patterns
141
142Based 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.
143
144Run 1-2 additional WebSearch queries if needed:
145
146**Search patterns:**
147- `"{competitor} vs {your company}"` or `"why I switched from {competitor}"`
148- `"{competitor} alternative for {use case}"`
149
150**Document four categories:**
151
152| Category | Description |
153|---|---|
154| **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. |
155| **When you LOSE to them** | Conditions where they are stronger. Sales reps need to know when they are walking into a tough fight. |
156| **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") |
157| **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. |
158
159---
160
161## Step 7 — Objection Handling
162
163For 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.
164
165**Format for each entry:**
166
167| They Say | The Truth | We Say |
168|----------|-----------|--------|
169| {What the prospect or competitor claims} | {The reality behind the claim — factual, sourced where possible} | {Your counter-positioning — conversational tone, not corporate speak} |
170
171**Rules:**
172- "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."
173- "The Truth" must be factual and fair. Acknowledge if the claim has merit, then provide the nuance.
174- "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.
175- 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.
176
177---
178
179## Step 8 — Trap Questions
180
181Write 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.
182
183**For each trap question, provide:**
184
1851. **The question** — phrased the way a prospect would naturally ask it
1862. **Why it matters** — what this question reveals about the competitor
1873. **What a good answer looks like** — if the competitor answers well, they may genuinely be strong here
1884. **What a bad answer looks like** — how the competitor will likely dodge, deflect, or struggle
189
190**Rules:**
191- Trap questions must never sound loaded or aggressive. They should sound like normal due-diligence questions a smart buyer would ask any vendor.
192- Each question should target a different weakness (do not cluster all questions around the same issue).
193- Ground each question in a real weakness found in Step 5.
194
195---
196
197## Step 9 — Positioning Statement
198
199For each competitor, write a concise positioning statement that a sales rep can use when the competitor comes up in conversation.
200
201**Three components:**
202
203| Component | What to write |
204|---|---|
205| **When they come up** | One sentence to acknowledge the competitor without dismissing them. Shows respect and confidence. |
206| **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." |
207| **When to compete vs. walk away** | One sentence defining when this is a winnable deal vs. when the sales rep should focus elsewhere. |
208
209---
210
211## Step 10 — Output
212
213### Per-Competitor Battlecard: `docs/battlecards/{competitor-name-slug}.md`
214
215The 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`).
216
217Create the `docs/battlecards/` directory if it does not exist.
218
219Use this structure:
220
221```markdown
222# {Competitor Name} — Competitive Battlecard
223
224**Generated:** {YYYY-MM-DD}
225**Your Company:** {user's company name}
226**Refresh Cadence:** Quarterly — battlecards go stale fast. Re-run this skill every 90 days.
227
228---
229
230## Company Details
231
232| Field | Detail |
233|---|---|
234| **What they do** | {positioning statement} |
235| **Founded** | {year} |
236| **HQ** | {location} |
237| **Employees** | {count or range} |
238| **Funding** | {total raised, last round, key investors} |
239| **Key Customers** | {logos} |
240| **Target Market** | {who they sell to} |
241| **Pricing** | {model and tiers, or "Not publicly available"} |
242
243### Recent News
244- {headline} — [{source}]({url}) ({date})
245- ...
246
247---
248
249## Their Pitch
250
251**Value Proposition:** {main claim}
252
253**Top Claims:**
2541. {claim}
2552. {claim}
2563. {claim}
257
258**Differentiation Angle:** {how they describe what makes them different}
259
260**Messaging Themes:** {recurring themes}
261
262**Awards/Recognition:** {analyst mentions, badges, awards}
263
264---
265
266## Why {Your Company} Wins
267
268### A | {Advantage Category 1}
269{Description with proof points. Why the user's product is better in this dimension. Include specific evidence — features, customer quotes, benchmarks.}
270
271### B | {Advantage Category 2}
272{Description with proof points.}
273
274### C | {Advantage Category 3}
275{Description with proof points.}
276
277---
278
279## Their Strengths (Know What You're Up Against)
280
281{Honest assessment. What they do well, where they have an advantage, what customers love. Sales reps who dismiss competitor strengths lose credibility.}
282
283---
284
285## Their Weaknesses
286
287{Organized by category: feature gaps, pricing complaints, support issues, implementation difficulties, product quality, churn signals. Every claim cited with a source.}
288
289---
290
291## When We Win vs. Lose
292
293| Scenario | Outcome | Why |
294|----------|---------|-----|
295| {Buyer profile / use case / conditions} | **WIN** | {Why you win in this scenario} |
296| {Buyer profile / use case / conditions} | **WIN** | {Why you win in this scenario} |
297| {Buyer profile / use case / conditions} | **LOSE** | {Why you lose in this scenario} |
298| {Buyer profile / use case / conditions} | **LOSE** | {Why you lose in this scenario} |
299
300**Deal Killers:** {Things that make the competitor unbeatable for certain buyers}
301
302---
303
304## Objection Handling
305
306| They Say | The Truth | We Say |
307|----------|-----------|--------|
308| "{prospect/competitor claim}" | {reality behind the claim} | "{conversational counter-positioning}" |
309| ... | ... | ... |
310
311---
312
313## Trap Questions
314
3151. **"{Natural-sounding question}"**
316 - *Why it matters:* {what this question reveals}
317 - *Good answer:* {what it looks like if they handle it well}
318 - *Bad answer:* {how they will likely dodge or struggle}
319
3202. **"{Natural-sounding question}"**
321 - *Why it matters:* ...
322 - *Good answer:* ...
323 - *Bad answer:* ...
324
3253. ...
326
327---
328
329## Quick Positioning
330
331> **When they come up:** {one sentence to acknowledge them}
332>
333> **How to differentiate:** {2-3 sentences — your angle}
334>
335> **Compete or walk away:** {one sentence — when to fight, when to focus elsewhere}
336
337---
338
339## Sources
340
341- [{description}]({url})
342- [{description}]({url})
343- ...
344
345---
346
347*Last Updated: {YYYY-MM-DD} | Refresh quarterly or when major competitor news breaks.*
348```
349
350### Summary File: `docs/battlecards/README.md`
351
352If this file already exists, update it. If not, create it.
353
354```markdown
355# Competitive Battlecards
356
357Last updated: {YYYY-MM-DD}
358
359## Competitor Summary
360
361| Competitor | One-Line Summary | Biggest Weakness | When We Win | When We Lose | Battlecard |
362|---|---|---|---|---|---|
363| {Name} | {What they do in one sentence} | {Top weakness} | {Top win scenario} | {Top loss scenario} | [{name}.md](./{slug}.md) |
364| ... | ... | ... | ... | ... | ... |
365
366---
367
368*Refresh quarterly. Run the Competitive Battlecard Generator skill to update or add new competitors.*
369```
370
371When updating README.md, merge new competitor entries with any existing rows. If a competitor was previously listed, replace its row with the new data.
372
373---
374
375## Tools
376
377| Tool | Purpose |
378|---|---|
379| **WebSearch** | Primary tool. Run 10-15 searches per competitor to cover all sections. Batch independent searches into the same message to run in parallel. |
380| **Read** | Check if `docs/battlecards/README.md` or existing battlecards already exist. |
381| **Write** | Output the battlecard file and update the README. |
382| **Glob** | Check `docs/battlecards/` for existing battlecard files to avoid overwriting without warning. |
383
384---
385
386## Rules (Non-Negotiable)
387
3881. **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.
3892. **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.
3903. **Trap questions must sound natural.** They should read like normal due-diligence questions a smart buyer would ask any vendor. Never hostile, never loaded.
3914. **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.
3925. **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.
3936. **Handle pricing honestly.** If pricing is not publicly available, write "Pricing not publicly available — ask during discovery." Do not guess pricing.
3947. **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.
3958. **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?"
3969. **No internal references.** This skill is part of a public playbook. Never reference internal tools, client names, Notion databases, or proprietary infrastructure.
39710. **Works universally.** This skill works for any B2B company analyzing any competitor. Do not assume a specific industry, company size, or GTM motion.
39811. **Create directories as needed.** If `docs/battlecards/` does not exist, create it before writing files.
39912. **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.