| name | battlecard-doc |
| description | Visual competitive battlecard document rendered as interactive HTML with expandable sections and color-coded comparisons. Use when user says "battlecard document", "visual battlecard", "competitive reference doc", or wants a formatted HTML version of competitive intelligence. Do NOT use for text-based competitive analysis — use /octave:battlecard instead. |
/octave:battlecard-doc - Visual Competitive Battlecard
Generate polished, self-contained HTML competitive battlecard documents powered by your Octave GTM knowledge base. Designed to be bookmarked and referenced during live competitive deals. Sticky sidebar navigation, color-coded win/loss indicators, expandable objection handlers, and visual scorecard bars make these documents scannable under pressure.
Unlike /octave:battlecard which outputs text-based competitive intelligence, this skill renders that intelligence as a styled, interactive HTML document with visual hierarchy. Unlike /octave:deck which builds presentations for audiences, this is an internal reference document for individual use.
On-brand styling — use a brand kit if one exists
Before generating, decide whose brand this battlecard should match (usually the target company; sometimes your own company). Then:
- Resolve the company to a
<slug> and check for a cached brand kit at ~/.octave/brands/<slug>/manifest.json.
- If a kit exists → offer it: "I found a saved brand kit for — want this battlecard rendered in their brand?" If yes, style the output with the kit instead of a generic preset:
- inline the kit's
tokens.css (:root + the embedded @font-face) and get-brand-components/assets/kit_base.css into the output <style>;
- follow
brand-kit.md → Signature moves, and reuse the kit's real logo, images/, and icons.json;
- for doc-shaped output you can compose directly with
get-brand-components/scripts/render_kit.py (hero / split / logos / pricing / cta / footer blocks).
- If no kit exists → offer to build one first: "No brand kit for yet — want me to capture it (~1 min) so this is on-brand?" → run
/octave:get-brand-components <domain>, then proceed.
- If the user declines → generate with the default style/preset.
The brand kit is the strongest styling signal — when one is available, prefer it over generic --style presets. See the get-brand-components skill for the kit format, token contract, and renderer.
Review pass (runs by default)
After generating, run the review pass by default — don't wait to be asked. In interactive mode, tell the user at intake that you'll review before finishing (recommended) and that they can opt out with --skip-review or "skip review". Follow get-brand-components/references/asset-review.md: the always-on preflight (em dashes, broken images/logos, link target, themed scrollbars, leaked internals) plus the visual pass (render/screenshot, inspect the pixels across the dimensions — groundedness/verification matters most — report a short located scorecard, fix, re-verify). The visual pass defaults off only in a --research fast run; the preflight always runs.
When generating, follow the output rules in get-brand-components/references/presentation-principles.md — the generation-time companion to the review pass (label every value, no tool names in the output, confirmed vs hypothesized, lean and deal-specific).
Usage
/octave:battlecard-doc [--competitor <name>] [--style <preset>]
Examples
/octave:battlecard-doc --competitor "Gong" # Deep-dive battlecard for vs Gong
/octave:battlecard-doc # Pick competitor interactively
/octave:battlecard-doc --competitor "all" # Full competitive landscape doc
/octave:battlecard-doc --competitor "Gong" --style neon-pulse
Instructions
When the user runs /octave:battlecard-doc:
Step 1: Identify Competitor(s)
If --competitor is not specified, fetch the competitor list and let the user choose:
# Get all competitors
list_all_entities({ entityType: "competitor" })
Present:
Which competitor are you building a battlecard for?
COMPETITORS IN YOUR LIBRARY
1. [Competitor 1] - [Brief description]
2. [Competitor 2] - [Brief description]
3. [Competitor 3] - [Brief description]
OTHER
4. Full competitive landscape (all competitors)
Your choice:
If they pick a single competitor, confirm the scope:
What kind of document do you want?
1. Full battlecard — comprehensive reference with all sections
2. Quick reference — positioning + objections + trap questions only
Your choice:
If they pick "all" or "Full competitive landscape," confirm:
I'll create a landscape overview with condensed battlecards for each competitor.
This includes a market map, per-competitor cards, and cross-competitor patterns.
Sound good? (y/n)
Step 2: Octave Context Gathering
Based on the competitor(s) selected, use Octave MCP tools to build rich competitive context. Always tell the user what you're researching and why.
Call as many tools as needed to build a complete picture. The best battlecard documents come from layering multiple sources -- competitor profiles + deal outcomes + conversation evidence + proof points all combine to create a reference grounded in real data. Don't stop at one tool when three would give you a stronger document.
See tool-reference.md for the list-vs-search guidance and the tool reference tables for single-competitor and landscape modes.
Output of this step: Present a structured content brief to the user:
BATTLECARD OUTLINE: vs [Competitor]
====================================
Competitor: [Competitor name]
Data Sources: [N] deals analyzed, [N] conversation mentions, [N] proof points
Date Range: Last 180 days
Win Rate: [X%] ([N] wins / [N] losses)
---
SECTIONS
--------
1. Quick Positioning — one-liner + 30-second pitch
2. Competitor Overview — what they do, target, pricing, key customers
3. Where We Win — strengths table + real deal evidence
4. Where They Win — honest assessment + how to counter each
5. Objection Handlers — organized by category (pricing, feature, relationship, risk)
6. Trap Questions — discovery questions that expose weaknesses
7. Landmines to Set — evaluation criteria to plant early
8. Proof Points — switching stories, competitive wins, metrics
9. Win/Loss Scorecard — visual scoreboard with win rate and factors
10. Displacement Playbook — how to unseat them when entrenched
Octave Sources Used:
- Competitor entity: [name]
- Deals analyzed: [N] wins, [N] losses
- Conversation mentions: [N] findings
- Proof points: [N] relevant
- Motions / Motion ICPs: [list of Motions and ICP cells]
- Custom Motion Playbooks (COMPETITIVE narrative): [list]
---
Does this outline look good? I can:
1. Proceed to style selection and generation
2. Add/remove sections
3. Go deeper on any area
4. Switch to landscape overview
Wait for user approval before proceeding.
Step 3: Style Selection
Ask the user to select a visual style. Default recommendation for battlecards is neon-pulse (dark + neon green/cyan, high-energy) or electric-studio (pure black + electric blue).
Pick a style for your battlecard:
DARK (recommended for battlecards)
1. neon-pulse — Dark + neon green/cyan. High-energy. [DEFAULT]
2. electric-studio — Pure black + electric blue. Tech-forward.
3. midnight-pro — Dark navy + blue accents. Executive feel.
4. executive-dark — Charcoal + gold. Premium boardroom.
LIGHT
5. swiss-modern — White + red accent. Clean minimal.
6. soft-light — Warm white + sage green. Calm.
7. paper-minimal — Off-white + black type. Editorial.
VIBRANT
8. solar-flare — Deep orange gradients. Bold.
9. aurora-gradient — Purple-to-teal. Visionary.
10. monochrome-bold — High-contrast B&W. Statement typography.
Your choice (number or name, or press Enter for neon-pulse):
If --style was provided via flag, skip this prompt and use that preset.
Full CSS variable definitions for each preset are in the deck skill's style-presets.md. Apply the same CSS variable system.
Step 4: Generate HTML
Build a single, self-contained HTML file. No external dependencies except Google Fonts. Everything else inlined.
Output Directory
Save the battlecard under .octave-decks/:
.octave-decks/
└── battlecard-<competitor-kebab>-<YYYY-MM-DD>/
└── battlecard-<competitor-kebab>.html
Example: /octave:battlecard-doc --competitor "Gong" produces .octave-decks/battlecard-gong-2026-02-11/battlecard-gong.html
For landscape: .octave-decks/battlecard-landscape-2026-02-11/battlecard-landscape.html
The entire .octave-decks/ directory is in .gitignore -- nothing here gets committed.
Single Competitor -- Document Sections
See single-competitor-sections.md for the single-competitor document section specs.
Landscape Overview -- Document Sections
See landscape-sections.md for the landscape overview document section specs.
HTML Architecture
See html-architecture.md for the full HTML/CSS scaffold, landscape-mode component swaps, and key HTML/CSS principles.
Step 5: Delivery
After generating the HTML file:
- Open the document in the default browser
- Present a summary:
BATTLECARD READY
================
Folder: .octave-decks/battlecard-<competitor>-<date>/
File: .octave-decks/battlecard-<competitor>-<date>/battlecard-<competitor>.html
Style: [Preset name]
Size: [file size]
Competitor: [Competitor name]
Sections: [N] sections
Data sources: [N] deals, [N] conversation mentions, [N] proof points
Win rate: [X%] (last 180 days)
Navigation:
- Scroll naturally through the document
- Sidebar dots on the right track your position
- Click any dot to jump to that section
- Objection handlers: click to expand/collapse
---
Want me to:
1. Add more objection handlers
2. Go deeper on any section
3. Create displacement outreach for a specific person
4. Generate a version for a different persona
5. Create a presentation version (/octave:deck)
6. Export as PDF
7. Done
If user requests PDF export:
To save as PDF:
PDF (recommended): bash "${CLAUDE_PLUGIN_ROOT:-.}"/scripts/export-pdf.sh .octave-decks/battlecard-<competitor>-<date>/battlecard-<competitor>.html
— or use the manual print dialog below:
1. Open the file in your browser (should already be open)
2. Press Cmd+P (Mac) or Ctrl+P (Windows)
3. Select "Save as PDF" as the destination
4. Set margins to "Minimum" or "None" for best results
5. The sidebar navigation will be hidden in print
MCP Tools Used
Competitive Intelligence
list_all_entities (competitor) -- List all competitors for selection or landscape
list_entities (competitor) -- Full competitor profiles with data
get_entity -- Deep dive on a specific competitor
search_knowledge_base -- Competitive positioning, Motion ICP matching, proof point discovery
list_findings -- Real conversation mentions, objections, competitor references from calls
list_events -- Deal win/loss outcomes against specific competitors
get_event_detail -- Deep dive into specific competitive deals for evidence
Library (Fetching / Searching)
list_motions -- List Motions in the workspace
list_motion_playbooks -- Find Custom Motion Playbooks with narrative type COMPETITIVE
get_motion_playbook -- Full details for a Custom Motion Playbook (competitive narrative)
list_motion_icps -- Motion ICP cells (persona × segment) under a Motion
find_motion_icp -- Motion ICP narrative + Learning Loop learnings
list_entities (product) -- Product capabilities for comparison
list_entities (proof_point) -- Competitive win proof points and switching stories
list_entities (reference) -- Customer references who switched from competitors
search_resources -- Search uploaded analyst reports, battlecards, competitive docs
Intelligence & Signals
list_findings -- Conversation-based competitive insights and objection patterns
list_events -- Deal stage changes, win/loss events with competitor filters
get_event_detail -- Full details on specific competitive deals
Error Handling
No Competitors in Library:
No competitors found in your library.
To build a battlecard, I need at least one competitor in your Octave library.
Options:
- Add a competitor first:
/octave:library create competitor
- Tell me the competitor name and I'll create a basic comparison from web research (limited data)
No Deal Data for This Competitor:
No win/loss data found against [Competitor] in the last 180 days.
I'll build the battlecard from library data, conversation mentions, and positioning. The win/loss scorecard and deal evidence sections will be limited.
As you log deals with this competitor tagged, the battlecard will get richer with real evidence.
Competitor Not in Library:
"[Name]" isn't in your competitor library yet.
Options:
- Create the competitor entity first:
/octave:library create competitor "[name]"
- I'll generate a basic battlecard from available information (Motion ICPs, conversations, web research)
Octave Connection Failed:
Could not connect to your Octave workspace.
The battlecard builder needs Octave data to generate competitive intelligence. Without it, I can't pull competitor profiles, deal outcomes, or conversation evidence.
To reconnect: check your MCP configuration or run /octave:workspace status
No Conversation Evidence:
No conversation mentions found for [Competitor].
The objection handlers and trap questions will be based on library data and general competitive positioning rather than real conversation evidence. They'll improve as your team logs more calls where this competitor comes up.
Related Skills
/octave:battlecard -- Text-based competitive intelligence (this is the visual version)
/octave:brief -- Account-focused dossier (when dealing with a specific account in a competitive deal)
/octave:deck -- Competitive presentation for an audience (this is a reference doc)
/octave:wins-losses -- Text-based win/loss analysis across competitors
/octave:campaign -- Competitive campaign content and displacement outreach
/octave:research -- Deep account research (feeds into account-specific competitive context)
/octave:insights -- Surface competitive mentions from conversations