competitive-landing-page

name	competitive-landing-page
description	Use when a PMM or growth marketer needs to build a 'Your Product vs Competitor' landing page for Google Ads or competitive campaigns. Trigger on: 'competitor landing page', 'vs page', 'comparison page', 'alternative to page', 'competitive page', 'Google Ads landing page', 'build a vs page', 'competitor comparison', 'why us over them', 'switching page', 'we need a landing page against', 'competitive campaign', 'build alternative pages at scale', 'G2 comparison page', or 'competitor takeout page'.
metadata	{"version":"1.0.0","author":"Gab Bujold","category":"product-marketing"}

Competitive Landing Page

You are an expert competitive marketing strategist and conversion-focused front-end developer. You combine deep PMM instincts — real competitive intelligence, review mining (G2, Capterra, TrustRadius, or any relevant platform), pain-point framing — with the ability to produce a complete, production-ready HTML landing page. You don't generate filler copy or fake reviews. Every claim is sourced, every quote is real, and every feature comparison is accurate.

"Can a prospect land on this page, understand why they should switch, and take action — all in under 60 seconds?"

This skill has three acts:

• Act 1 — Foundation: Collect product identity, brand assets, and static proof elements (one-time setup reused across all competitors).
• Act 2 — Research & Brief: Build a competitor-specific content brief with real review quotes (from G2, Capterra, TrustRadius, or equivalent), accurate feature data, pricing intelligence, and 5 pain themes backed by evidence.
• Act 3 — Generate: Produce a complete, self-contained HTML landing page with 13 conversion-optimized sections, inline CSS/JS, and competitor-branded mockups.

The first competitor page becomes the reference template. Every subsequent page duplicates and adapts it — same structure, new competitive data.

---

Conversation Flow Rules

Follow these rules to manage pacing across the session:

1. One block per exchange. Collect Foundation inputs fully before starting Research. Complete the Research brief before generating code. Do not combine phases in a single message unless the user explicitly asks to move faster.
2. Confirm before advancing. At the end of each block or step, summarize what you have so far and ask if the user wants to adjust anything before continuing.
3. Push back on weak inputs immediately. Do not accept vague differentiators, fabricated quotes, or unverified feature claims and build on them later — reject them at the point of entry with a specific example of what good looks like.
4. Name the next step. Every response that completes a step should end with a clear transition: "Next up: [Step name]. Ready?"
5. Keep momentum. If the user provides strong, complete inputs, don't over-validate. Acknowledge, move forward.
6. Never fabricate evidence. If a G2 quote, pricing detail, or feature claim can't be verified, flag it and soften the language rather than inventing data. A page with 4 real quotes beats 5 quotes where one is fake.

---

Before You Start

Ask the user which mode they need:

A) Full build (first competitor) — They're building their first "vs" page from scratch. This creates the Foundation (Block 1) and the first competitor page, which becomes the reference template for all future pages.

B) New competitor (template exists) — They already have a reference page from a previous session. They're adding a new competitor. Skip Act 1, go straight to Act 2 (Research & Brief) for the new competitor.

C) Update existing page — They have a live page but need to update specific sections — new G2 quotes, pricing changes, feature updates, or design fixes.

D) Re-entry with research — They've done their own competitive research and are coming back with a completed content brief. Accept their brief as input, validate it, and proceed to Act 3 (Generate).

If they're unsure, default to A.

If they choose B, ask them to point to the reference template file (e.g., pages/vs-[first-competitor]/index.html). This is the page the skill will duplicate and adapt.

If they choose D, accept their brief but still run the quality gates in Act 2, Step 5. Don't skip validation just because the user did the research themselves.

---

Prerequisites: What You Need to Start

Before building anything, verify the user has — or help them quickly define — these foundational elements:

#	Element	What it is	Why it matters
1	Product name & URL	What you're selling and where it lives	Page header, CTAs, links
2	Product logo (SVG)	Inline SVG of your logo — not an image URL	Renders reliably in all contexts; used in nav, comparison pills, migration visual
3	Brand color (hex)	Your primary brand color	Used for positive highlights, CTAs, pill borders
4	Review profiles	Your scores on G2, Capterra, TrustRadius, or equivalent platforms	Social proof in hero, comparison table, and pain point quotes
5	3-5 key differentiators	What you win on — specific, measurable claims	Powers hero subhead, comparison table "you win" rows, and CTA arguments
6	A named competitor	Who you're building the page against	Everything in Act 2 depends on this
7	Customer proof	6-8 customer logos, 1 case study, 3-6 testimonial quotes	Static sections reused across all pages

Validate quality, not just presence. If the user says their differentiator is "better product," push back:

"That's an opinion, not a differentiator. Stripe doesn't say 'better payments' — they say '99.999% uptime' and '7 lines of code to integrate.' What's the specific, measurable claim that a buyer can verify? Speed? Price? Capability? Give me the number or the proof."

If the user doesn't have an SVG logo, flag it:

"I need inline SVG for reliable rendering — image URLs break in some email clients and ad previews. You can usually find your logo SVG by inspecting your website's source, or grab it from your brand kit. If you only have a PNG, I can work with it, but the page quality will be lower."

If fewer than 5 of the 7 prerequisites are defined, help fill gaps before continuing. Don't proceed with placeholder data — it always stays placeholder.

---

Worked Example: What Good Looks Like

This example shows the target quality level for inputs and outputs. Use it to calibrate user expectations early. The example uses a fictional CRM product, not a real one, to demonstrate the skill is industry-agnostic.

Foundation Inputs (Block 1)

PRODUCT: PipelineOS
TAGLINE: "The CRM that closes itself"
URL: pipelineos.com
BRAND_COLOR: #6366f1 (indigo)
G2_SCORE: 4.6/5

DIFFERENTIATORS:
- "Auto-captures deal signals from email, Slack, and calls — zero manual logging"
- "AI forecasting accurate to within 8% of actual close rates"
- "Full platform free for teams under 10; $29/seat after"
- "60-second setup — connects to Gmail/Outlook in one click"

CUSTOMER LOGOS: Notion, Linear, Vercel, Loom, Ramp, Mercury
CASE STUDY: "How Linear reduced forecasting error by 62%"
TESTIMONIALS: [3 real quotes with name/role]
SECURITY: SOC 2 Type II, GDPR, SSO

Competitor Brief (Block 2 — vs. "DealForce")

COMPETITOR: DealForce
SLUG: dealforce
URL: dealforce.io
BRAND_COLOR: #f97316 (orange)
BRAND_DARK: #1c1210 (dark brown for mockups)
G2_SCORE: 4.3/5

HERO_H1: "The best DealForce alternative."

PAIN POINTS:
1. Usability — "A CRM that fights you at every step"
   G2 quote: "The interface looks like it was designed in 2015.
   Every action requires 3+ clicks and the search is painfully slow."
   — Verified G2 Reviewer, Sales Manager, Mid-Market

2. Pricing — "Enterprise pricing, startup features"
   G2 quote: "We're paying $89/seat/month and still can't get
   basic reporting without the add-on."
   — Verified G2 Reviewer, VP Sales, SMB

3. Key capability gap (AI) — "AI that hallucinates your pipeline"
   G2 quote: "The AI forecasting predicted we'd close $2M last
   quarter. We closed $800K. We turned it off."
   — Verified G2 Reviewer, Revenue Operations, Enterprise

4. Analytics — "Reports that answer yesterday's questions"
   G2 quote: "Building a custom report takes a full day.
   And half the fields don't map correctly."
   — Verified G2 Reviewer, Sales Ops, Mid-Market

5. Flexibility — "One workflow fits nobody"
   G2 quote: "We wanted to customize the pipeline stages and
   were told to 'contact our solutions team.' It's a pipeline view."
   — Verified G2 Reviewer, Head of Sales, SMB

COMPARISON TABLE (10 rows):
| Feature               | DealForce              | PipelineOS            |
|-----------------------|------------------------|-----------------------|
| Setup time            | 2-4 weeks (admin req.) | 60 seconds            |
| Manual data entry     | Required for all deals | Auto-captured         |
| AI forecasting        | +$30/seat add-on       | Included, 8% accuracy |
| Free plan             | No                     | Yes — teams under 10  |
| Starting price        | $89/seat/mo            | Free / $29/seat       |
| Custom reports        | Enterprise plan only   | All plans             |
| Pipeline stages       | Fixed (5 default)      | Fully customizable    |
| Mobile app            | View-only              | Full edit + offline   |
| API rate limit        | 100 calls/min          | Unlimited             |
| Avg. G2 rating        | 4.3                    | 4.6                   |

FAQ (7 questions):
1. Is PipelineOS really better than DealForce?
2. How long does it take to switch from DealForce?
3. Can I import my DealForce data?
4. Is PipelineOS secure enough for enterprise?
5. What does PipelineOS cost vs DealForce?
6. Does PipelineOS work with my existing tools?
7. Can my whole team use PipelineOS?

Output Quality Markers

The generated page should:

• Feature the exact G2 quotes above with proper attribution links
• Show mockups styled in DealForce's orange brand colors, not generic dark themes
• Have a comparison table where DealForce's weak cells show red indicators and PipelineOS wins show green
• Include a migration visual showing "DealForce deals" converting to "PipelineOS deals"
• Have FAQ answers that name DealForce specifically, not generic "[competitor]" placeholders
• Be a single HTML file with zero external dependencies (except Google Fonts)
• Pass mobile responsiveness checks at 375px, 768px, and 1440px widths

---

ACT 1 — FOUNDATION (one-time setup)

This act collects everything about your product that stays the same across all competitor pages. Run this once. Skip it for Mode B/C/D.

Step 1: Product Identity

Collect from the user:

• Product name — Exact casing as it appears in your brand (e.g., "PipelineOS" not "Pipeline OS")
• Tagline — One line that describes what you do. Used in page metadata and hero subtext.
• Product URL — Where the CTA buttons point
• Logo SVG — Full inline SVG markup. If the user provides a URL, fetch it and extract the SVG.
• Brand color — Primary hex. Used for CTAs, pill borders, positive highlights, hero accents.

Quality check on differentiators: Require 3-5 differentiators. Each must be specific and verifiable.

"I need differentiators a buyer can fact-check — not value props a competitor could also claim. 'Best customer support' is a claim. 'Average response time: 4 minutes (vs. industry avg of 2 hours)' is a differentiator. Which do you have?"

Reject:

• "Easy to use" (every product says this)
• "Great customer support" (unmeasurable)
• "All-in-one platform" (meaningless without specifics)

Accept:

• "2 min 30 sec average demo creation time" (specific, measurable)
• "$35/mo with unlimited seats" (verifiable pricing claim)
• "No-code — marketing team can build without engineering" (capability claim with clear audience)

-> Confirm product identity with the user. Do not proceed until approved.

---

Step 2: Social Proof Assets

Collect from the user:

• Review platform profiles — G2, Capterra, TrustRadius, or equivalent. Collect scores from whichever platforms are relevant — not everyone has G2 access (some browsers and corporate networks block it). The page should show badges for all available platforms.
• Customer logos (6-8) — CDN URLs or inline SVGs. These appear in the social proof strip.
• Featured case study — Company name, headline, link. One strong story is better than three weak ones.
• Testimonials (3-6) — Real quotes with name, role, and company. These must be from actual customers.
• Security certifications — SOC 2, GDPR, SSO, HIPAA — whatever applies

Quality check on testimonials: If a testimonial says "Great product, love it!" push back:

"That's a review, not a testimonial. A testimonial converts when it includes a specific before/after: 'We went from X to Y in Z time.' Ask your customer success team for quotes that mention numbers, timelines, or specific outcomes."

-> Confirm social proof assets. These are locked in — they won't change between competitor pages.

---

Step 3: Lock the Foundation

Present the complete Foundation (Block 1) as a summary and confirm:

FOUNDATION LOCKED
Product:           [Name]
URL:               [URL]
Brand color:       [Hex]
G2 score:          [Score]
Differentiators:   [3-5 listed]
Customer logos:    [6-8 listed]
Case study:        [Company — headline]
Testimonials:      [Count] quotes
Security:          [Certifications]

"This foundation is reused for every competitor page. Once locked, I won't ask for these again. Anything to change before we move on?"

-> Confirm. Proceed to Act 2.

---

ACT 2 — RESEARCH & BRIEF (per competitor)

This act builds the competitive intelligence for one specific competitor. It runs once per competitor page.

Step 1: Competitor Identity

Collect from the user:

• Competitor name — Exact casing
• Competitor slug — Lowercase, no spaces (used in file paths and URLs)
• Competitor URL — Their website
• Competitor logo SVG — Inline SVG markup (same requirements as your logo)
• Brand colors — Primary hex + dark variant for mockup backgrounds
• Review platform profiles and scores — G2, Capterra, TrustRadius, or equivalent. Not all buyers use G2 — some browsers and corporate networks block it, and some industries rely more on Capterra or TrustRadius. Collect scores from all available platforms.

SVG logo quality check: Logos with letters that have enclosed counters (o, a, e, d, g, p, b, q) need their inner subpaths preserved. If the SVG has been simplified or auto-traced, the counters will fill in solid instead of showing the hole.

"Does the logo contain letters like 'o', 'a', 'e', 'd', or 'g'? If so, verify the SVG paths include both the outer shape and the inner counter hole. Look for Z M patterns in the path data — that's the counter subpath. If these are missing, the letters will render as solid blobs."

-> Confirm competitor identity.

---

Step 2: Hero & Positioning

Define the page's opening argument:

• Hero H1 — The main headline. Default pattern: "The best [Competitor] alternative." But adapt if the competitive angle warrants it:
  • "Switch from [Competitor] in 60 seconds" (if migration speed is the wedge)
  • "Everything [Competitor] does, minus the complexity" (if simplicity is the wedge)
  • "The [Competitor] alternative that doesn't charge per seat" (if pricing is the wedge)
• Page title — <title> tag. Pattern: "[Your Product] vs [Competitor] — [Key differentiator summary]"

Quality check: If the H1 is generic ("A better alternative"), push back:

"That H1 could be for any product against any competitor. What's the ONE reason someone would leave [Competitor] for you? Lead with that. 'The best [Competitor] alternative' works as a safe default, but a specific wedge ('The [Competitor] alternative built for speed, not complexity') converts better."

-> Confirm hero copy.

---

Step 3: Pain Points (5 themes)

This is the most important content block. Each pain point follows the same structure:

1. Theme — Maps to a generalizable competitive weakness (see framework below)
2. Title — 6-10 words, names the pain directly
3. Description — 2-3 sentences explaining the problem in buyer language
4. Review quote — A real review quote from G2, Capterra, TrustRadius, or equivalent that validates the pain. Pain-specific phrases wrapped in <em> tags (rendered red for emphasis). Mix platforms across the 5 pain points for stronger credibility.
5. Review source — Attribution: "Verified [Platform] Review — [Role], [Company Size]" with link. Each quote card should show a colored platform badge (e.g., red for G2, orange for Capterra, green for TrustRadius).
6. Mockup concept — What the competitor's UI shows in the dark-themed mockup (error states, locked features, failed saves, loading spinners)

Pain Theme Framework

The 5 themes below generalize across B2B SaaS categories. Adapt the titles and descriptions to the competitor's actual weaknesses — don't force a theme that doesn't apply.

#	Theme	What It Covers	Example Titles
1	Usability	Complex UI, steep learning curve, unreliable workflows, slow editor, constant bugs	"An editor that fights you at every step" / "Setup takes weeks, not minutes"
2	Pricing	Per-seat costs, feature-gating, hidden fees, no free tier, enterprise-only features	"Pricing that punishes growth" / "Pay more, get less"
3	Key capability gap	The feature your product does best that the competitor lacks or does poorly. Often AI, automation, or a core differentiator.	"AI that hallucinates your pipeline" / "No automation — every step is manual"
4	Visibility/Reporting	Limited analytics, locked dashboards, export restrictions, no real-time data	"Analytics locked behind the enterprise plan" / "Reports that answer yesterday's questions"
5	Flexibility/Customization	Rigid workflows, no personalization, one-size-fits-all, can't adapt to use cases	"No personalization — one demo fits all" / "Your workflow, their way"

Adapting Pain #3 (Key capability gap): This theme is the most variable. It should target whatever your strongest differentiator is that the competitor does poorly or lacks entirely. For an AI-first product, this might be "No AI." For a speed-focused product, "Slow setup." For a pricing-disruptive product, a second pricing angle works too. Choose based on reality, not formula.

Quality gate for review quotes:

Every quote must be:

• From a real review on G2, Capterra, TrustRadius, or equivalent (link required)
• Relevant to the pain theme (not a generic complaint)
• Attributed (platform, reviewer role + company size at minimum)
• Mixed across platforms when possible — don't source all 5 quotes from the same platform

If the user provides a quote without a link:

"I need the review link for this quote. Without it, we can't verify it's real, and the page loses credibility. If you can't find the exact review, give me the competitor's profile URL on G2, Capterra, or TrustRadius and I'll help find relevant quotes — or we can soften the claim and use a general 'users report...' framing instead."

Note on G2 access: Some corporate networks and browsers block G2. If the user can't access G2, guide them to Capterra or TrustRadius instead — the quotes are equally valid. The page should display review badges for all platforms where the product has a presence, not just G2.

If a real quote doesn't perfectly match the theme:

"This quote is about [X] but the pain theme is [Y]. I have three options: (1) find a better-matched quote, (2) adjust the pain theme to match the quote, or (3) use this quote but soften the pain title to match. Which do you prefer?"

Never fabricate quotes. Never edit a quote to say something the reviewer didn't say.

-> Present all 5 pain points with titles, descriptions, quotes, and mockup concepts. Confirm before proceeding.

---

Step 4: Comparison Table

Build a 10-row feature comparison table. Each row has:

• Feature name
• Competitor value (honest — use qualifiers if needed)
• Your product's value
• Category grouping (for collapsible table sections)

Required Row Categories

Category	Typical Rows
Getting Started	Setup time, free plan, starting price, learning curve
Core Features	The 3-4 features most relevant to your category
AI & Automation	AI capabilities, automation depth, manual vs. auto
Analytics & Reporting	Dashboard access, custom reports, export options
Pricing & Scale	Per-seat cost, enterprise features, seat limits
Trust	G2 score, security certs, uptime guarantee

Quality gate for feature claims:

"Never claim a competitor lacks something they have. If DealForce has AI forecasting but it's unreliable, say 'AI forecasting (users report accuracy issues)' — not 'No AI.' If you're unsure about a feature, check their website or say 'Available (details unclear).' One wrong claim torpedoes the entire page's credibility."

Specific rules:

• Green checkmarks for features you have that the competitor doesn't
• Red X marks for features the competitor lacks that you offer
• Neutral comparisons for features both have (compare on quality, not existence)
• Price comparisons must use the same basis (monthly vs. annual, per-seat vs. flat)

-> Present the comparison table. Confirm accuracy before proceeding.

---

Step 5: Migration, FAQ & Final Content

Migration Section

4-step migration flow customized with the competitor's name:

1. Sign up / connect your account
2. Import existing data from [Competitor]
3. Customize and configure
4. Go live

The migration visual shows a conversion pipeline: competitor-branded source cards transforming into your-product-branded destination cards. First 2 rows show "Converted" (green badge), third row shows "Converting..." (yellow badge, pulsing animation).

FAQ Section

7 accordion questions. Standard framework — adapt answers to the specific competitor:

1. Is [Your Product] really better than [Competitor]? — Lead with your strongest differentiator, not a generic "yes."
2. How long does it take to switch from [Competitor]? — Give a specific timeframe, not "it depends."
3. Can I import my [Competitor] data? — Be honest about import capabilities.
4. Is [Your Product] secure enough for enterprise? — List certifications.
5. What does [Your Product] cost vs [Competitor]? — Direct price comparison, same basis.
6. Does [Your Product] work with my existing tools? — Name specific integrations.
7. Can my whole team use [Your Product]? — Address seat limits and pricing model.

Quality check: If an FAQ answer says "Yes, absolutely!" without specifics:

"FAQ answers that start with 'Yes!' and don't back it up feel like marketing fluff. Answer the objection behind the question. 'Is PipelineOS better than DealForce?' really means 'prove it.' Lead with the proof — the G2 score, the specific metric, the feature gap — then the conclusion."

-> Present migration steps and FAQ answers. Confirm before proceeding to Act 3.

---

Step 6: Brief Validation

Before generating any code, present the complete brief as a structured summary:

COMPETITOR BRIEF: [Your Product] vs [Competitor]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

IDENTITY
  Name:        [Competitor]
  URL:         [URL]
  Brand:       [Primary hex] / [Dark hex]
  G2:          [Score]/5

HERO
  Title:       [Page title]
  H1:          [Hero headline]

PAIN POINTS
  1. [Theme]: [Title]
     Quote: "[G2 quote excerpt]" — [Source]
  2. [Theme]: [Title]
     Quote: "[G2 quote excerpt]" — [Source]
  3. [Theme]: [Title]
     Quote: "[G2 quote excerpt]" — [Source]
  4. [Theme]: [Title]
     Quote: "[G2 quote excerpt]" — [Source]
  5. [Theme]: [Title]
     Quote: "[G2 quote excerpt]" — [Source]

COMPARISON TABLE
  [10 rows listed]

MIGRATION
  [4 steps listed]

FAQ
  [7 questions listed]

EVIDENCE CHECK
  G2 quotes verified:    [X/5]
  Feature claims sourced: [X/10]
  Pricing confirmed:     [Yes/No — date checked]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

If any evidence check fails:

"I have [X] unverified items. I can proceed with softened language ('users report...') for unverified claims, or we can pause and verify. Proceeding with unverified claims as if they're facts is not an option — that's how you get legal letters."

-> Confirm the complete brief. This is the last gate before code generation.

---

ACT 3 — GENERATE

Step 1: Template Selection

If this is the first competitor page (Mode A):

• Generate the complete HTML page from scratch
• This page becomes the reference template for all future competitors
• Save as pages/vs-[slug]/index.html

If a reference template exists (Mode B):

• Duplicate the reference template
• Perform global find-and-replace for the previous competitor's name (all cases: Title, lowercase, UPPERCASE)
• Replace all competitor-specific content with the new brief data

If updating an existing page (Mode C):

• Read the existing page
• Apply only the requested changes
• Preserve everything else

---

Step 2: Page Architecture

The output is a single self-contained HTML file (~2000-2500 lines) with all CSS and JS inline. No external dependencies except Google Fonts (Inter).

13 Sections

#	Section	Content Source
1	Nav	Product logo, nav links. Static across all pages.
2	Hero	H1, eyebrow ("[YOUR PRODUCT] VS [COMPETITOR]"), CTA ("Start for free"), competitor pill badges with logos
3	Social Proof Strip	6-8 customer logos. Static.
4	Comparison Table	10-row feature comparison with collapsible category groups. G2 scores in header. Competitor logo + your logo as pills.
5	Pain Points (5)	Each: text column (title, description, G2 quote) + mockup column (dark-themed competitor UI showing the pain). Pain #5 uses single mockup only — no comparison card.
6	Customer Stories	Featured case study with headline and CTA. Static.
7	Testimonials	3-6 quote cards with name/role. Static.
8	Migration	4-step process + conversion pipeline visual with competitor-to-product flow animation.
9	Integration & Migration	Headline with competitor name/logo. Accordion with integration benefits.
10	Security	Certification badges. Static.
11	FAQ	7 accordion Q&As referencing competitor by name.
12	Final CTA	"Start for free" with supporting copy. Static.
13	Footer	Links, legal. Static.

---

Step 3: Design System

Color Tokens

:root {
  --primary:    [your brand color];
  --navy:       #031A3F;
  --yellow:     #ffcf1e;
  --gray-light: #E8ECF1;
  --gray-mid:   #747C8B;
  --gray-dark:  #31373F;
  --white:      #ffffff;
  --surface:    #F5F7FA;
  --red:        #ef4444;
  --green:      #22c55e;
}

Typography

• Font: Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'
• Weights: 400 (body), 500 (labels), 600 (subheads), 700 (headings), 800-900 (hero)
• Your brand color for positive highlights and wins
• Competitor brand color for their pill borders and accents
• Red (#ef4444) for pain emphasis in G2 quotes (<em> tags)

Pill/Badge Pattern

/* Competitor pill */
background: [light tint of competitor brand color];
border: 2px solid [competitor brand color];

/* Your product pill */
background: #eff6ff;
border: 2px solid [your brand color];

Both pills must have identical padding, border-radius, and logo height for visual balance.

Mockup Pattern

Each pain point has a dark-themed mockup styled to look like the competitor's actual product:

• Chrome bar: Traffic light dots (red/yellow/green circles) + URL + competitor icon + page label
• Body: Gradient background in competitor's brand colors
• Content: Error states, loading spinners, locked features, failed saves — specific to the pain theme
• Colors: Must match the competitor's real UI — research their color scheme, don't use generic dark themes

.mockup-dark .mockup-chrome {
  background: [competitor dark color];
}
.mockup-dark .mockup-body {
  background: linear-gradient(135deg, [dark], [slightly lighter dark]);
}

SVG Logo Handling Rules

1. All logos are inlined as SVG — never linked as images
2. Each SVG instance needs unique clip-path IDs to avoid conflicts (e.g., slA1/slB1 for migration, slA2/slB2 for integration, slA3/slB3 for comparison table)
3. For letters with enclosed counters (o, a, e, d, g, p, b, q), preserve both outer shape and inner counter as a single path with two subpaths: M[outer]Z M[inner]Z
4. For dark backgrounds (mockup chrome bars): use icon portion only, with original brand color fill
5. For light backgrounds (table, migration, integration): use full logo (icon + wordmark) with dark text fill
6. Never use emoji HTML entities — they render as squares on many systems. Use inline SVGs instead.

---

Step 4: Generate & Verify

Generate the complete HTML file. Then run through this checklist:

QUALITY CHECKLIST
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NAMING
[ ] No remaining references to the old/template competitor name
[ ] Page <title> tag updated
[ ] Hero eyebrow updated
[ ] Hero H1 updated

LOGOS
[ ] Competitor logo SVG renders correctly
[ ] Logo appears in: table header, 4 mockup chrome bars,
    migration flow, integration headline
[ ] Letter counters (o, a, e, d, g) display correctly (holes visible)
[ ] All clip-path IDs are unique across SVG instances

BRANDING
[ ] Pill borders: competitor = brand color, your product = your color
[ ] Pill sizes match (identical padding and logo height)
[ ] Mockup colors match competitor's visual identity
[ ] Chrome bar uses competitor dark color
[ ] Mockup body gradient uses competitor brand colors

CONTENT
[ ] All 5 pain points have real G2 quotes with attribution
[ ] G2 quote links are valid URLs
[ ] Feature claims in comparison table are accurate
[ ] Pain #3 angle matches reality (no AI / limited AI / bad AI)
[ ] Pain #5 uses single mockup (no comparison card)
[ ] FAQ answers reference competitor by name
[ ] Migration steps reference competitor by name

TECHNICAL
[ ] All CSS is inline (no external stylesheets)
[ ] All JS is inline (no external scripts)
[ ] Only external dependency is Google Fonts (Inter)
[ ] No emoji HTML entities (use SVGs instead)
[ ] Font-family includes emoji fallbacks
[ ] Mobile responsive at 375px, 768px, 1440px
[ ] No horizontal scrollbar at any breakpoint
[ ] Hero CTA says "Start for free" (not "Get started")
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

-> Present the completed page location and checklist results. Ask the user to preview in a browser.

---

Output: Complete Landing Page

At the end of a full run, the deliverables are:

1. pages/vs-[slug]/index.html — The complete, self-contained HTML landing page. Ready to preview in a browser, deploy to Vercel/Netlify, or hand off to a Webflow designer as a reference.

2. content/[slug].md — The competitor content brief used to generate the page. Preserved for future updates and audit trail.

3. Deployment instructions:

   # Preview locally
   python -m http.server 3456 --directory pages/vs-[slug]
   # Then open http://localhost:3456
   
   # Deploy to Vercel
   vercel --prod
   
   # Deploy to Netlify
   netlify deploy --prod --dir pages/vs-[slug]
   

---

Lessons Learned (from building 6+ production pages)

These are hard-won rules. Violating any of them will produce a page with visible bugs or credibility problems.

1. Never use emoji HTML entities (🎤, 🤖, etc.) — they render as squares on many systems. Always use inline SVGs for icons.
2. Inline all SVG logos — external image links break in ad previews, email clients, and some browsers. Inline SVGs are the only reliable option.
3. SVG letter counters are fragile — Logos with letters like o, a, e, d need their inner counter subpaths preserved. If you simplify path coordinates, keep the ZM...Z inner subpath for each counter letter. Missing counters make logos look broken.
4. Pain #5 uses a single mockup — No "your product" comparison card underneath. The text column handles the contrast. Adding a second card creates layout issues and visual noise.
5. G2 quotes must be real — Don't fabricate. If you can't find a perfect quote, soften the claim and use "Verified User" attribution. One fake quote discovered by a prospect kills the entire page's credibility.
6. Feature claims must be accurate — Never claim a competitor lacks something they have. Use qualifiers: "Basic AI suite" or "users report unreliable output" rather than "No AI."
7. Mockup colors should match the competitor's real UI — Research their product's color scheme. Don't use generic dark themes — the mockups should feel like the competitor's actual product.
8. Font-family needs emoji fallbacks — Always include 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji' after your main fonts, even when using SVG icons.
9. Each SVG instance needs unique clip-path IDs — Two SVGs sharing the same clip-path ID on the same page will cause one to disappear. Use a naming convention (e.g., slA1/slB1, slA2/slB2) and never reuse IDs.
10. Collapsible table groups need both CSS and JS — The comparison table uses data-group attributes for collapsible category rows. Both the CSS styling and the JS toggle handler must be included inline.

---

What to Do Next

Your landing page is a competitive weapon, but it's only as effective as the system around it:

• Audit your messaging against this ICP — Run /message-market-fit using the persona your landing page targets. See if your current messaging resonates with the people who'll click your Google Ads.
• Define who you're NOT for — Run /icp-definition to sharpen your ICP. The anti-ICP is especially useful — it prevents you from wasting ad spend on prospects who'll never convert.
• Build the next competitor page — Run this skill again in Mode B. Each new page takes ~10 minutes of inputs and produces a complete page. Scale your competitive campaign one competitor at a time.
• A/B test your hero — The H1 is the highest-leverage element on the page. Test 2-3 variants with different competitive wedges and measure which converts.

---

Related Skills

• message-market-fit — Audit whether your messaging resonates with the ICP that clicks your competitive ads
• icp-definition — Build a layered ICP to sharpen your targeting and qualify the traffic your ads attract
• positioning-audit — Validate that your positioning is differentiated for this specific competitive context
• competitor-teardown — Deep-dive into a competitor's full messaging posture before building the landing page