startup-competitors/SKILL.md
Deep competitive intelligence for any market. Analyzes competitors' products, pricing, customer sentiment, GTM strategy, and growth signals using real web data. Produces battle cards, pricing landscape, and feature matrix. Use when the user wants to understand their competitive landscape, analyze competitors, compare products in a market, or research who they're competing against. Triggers for "who are my competitors", "competitive analysis", "competitor research", "battle cards", "pricing comparison", "competitor pricing", "market players", "competitive intelligence", "competitive landscape", "who else is in this space", "competitive moat", or any request to profile, compare, or map competitors in a category. Works standalone — no prior startup-design session needed.
npx skillsauth add ferdinandobons/startup-skill startup-competitorsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Deep competitive intelligence that goes beyond surface-level profiles. Produces actionable battle cards, pricing landscape analysis, and strategic vulnerability mapping using real web data.
INTAKE → RESEARCH (3 sequential waves) → SYNTHESIS → BATTLE CARDS
The process is focused: understand the product, research competitors deeply across 3 dimensions, synthesize findings, and produce actionable output. Typical runtime: 15-25 minutes in Claude Code (parallel agents), 30-45 minutes in Claude.ai (sequential).
Default output language is English. If the user writes in another language or explicitly requests one, use that language for all outputs instead.
Before anything else, check if a PROGRESS.md created by this skill exists in the working directory or a project subdirectory (the skill name field says startup-competitors). If it does, read it and resume from the last incomplete phase. Tell the user: "I found progress from a previous session. You completed [phases]. Picking up from [next phase]."
If no progress file exists — or the one found belongs to a different skill — start from Phase 1.
Short and focused — 1-2 rounds of questions, not an extended interview. The goal is just enough context to run targeted research.
Before asking questions, check if a startup-design session has already been completed for this project. Look for these files in the working directory or subdirectories:
01-discovery/competitor-landscape.md — competitor profiles and analysis01-discovery/market-analysis.md — market size, trends, regulatory01-discovery/target-audience.md — customer personas, pain points00-intake/brief.md — product description and contextIf these files exist, read them and use the data as a head start:
competitor-landscape.md as the starting point for deeper analysis (startup-design profiles 5-8 competitors at surface level — this skill goes much deeper on each)market-analysis.md to contextualize the competitive landscapetarget-audience.md to focus the sentiment mining on what matters mostTell the user: "I found data from a previous startup-design session. I'll use it as a starting point and go deeper on the competitive analysis."
Skip the intake interview entirely if the startup-design files provide enough context. Go straight to research.
Round 1 — The basics:
Round 2 — Sharpening (only if needed):
Don't over-interview. If the user gives a clear description upfront, skip straight to research. The competitive analysis itself will surface what matters.
Save to {project-name}/intake.md — a brief summary of the product, market, and known competitors. If built on startup-design data, note the source files used. The project name should be derived from the product/market (kebab-case, e.g., ai-email-assistant).
Create {project-name}/PROGRESS.md with: project name, skill name (startup-competitors), start date, language, research mode (Live / Knowledge-Based), and a phase checklist. Update it after each phase completes. If PROGRESS.md already exists from a previous session, resume from the last incomplete phase.
After intake, assess market complexity and present the Research Depth recommendation to the user.
Reference: Read
references/research-scaling.mdfor the complexity scoring matrix, tier definitions, wave configurations, and the user communication template.
research-scaling.md for the exact template)The selected tier determines the number of agents per wave and search rounds per agent in Phase 2. See research-scaling.md for exact wave configurations per tier.
Three sequential research waves, each attacking the competitive landscape from a different angle — agents within a wave run in parallel. Together they produce a 360-degree view.
Check if the Agent tool is available:
This skill requires WebSearch for real data. If WebSearch is unavailable or denied, fall back to Knowledge-Based Mode: use training data, mark all findings with [Knowledge-Based — verify independently], and reduce confidence ratings by one level.
Reference: Read
references/research-principles.mdbefore starting any wave. It defines source quality tiers, cross-referencing rules, and how to handle data gaps.
Reference: Read
references/research-wave-1-profiles-pricing.mdfor agent templates.
Two agents (or two sequential blocks):
A1: Competitor Deep-Dives — Identify and profile 5-8 direct competitors plus 2-3 adjacent solutions (broader platforms, manual alternatives, tools from neighboring categories that compete for the same budget). For each: product, features, team size, funding, traction signals, strengths, weaknesses. Go beyond their marketing page — check reviews, job postings, and funding data.
A2: Pricing Intelligence — For each competitor: reverse-engineer the pricing model. Not just "it costs $49/mo" but: what's the value metric (per seat? per usage? flat?), how do tiers differentiate, what pricing psychology do they use (anchoring, decoy, charm pricing), what's the switching cost (technical, contractual, emotional). Build a tier-by-tier comparison.
Reference: Read
references/research-wave-2-sentiment-mining.mdfor agent templates.
Two agents (or two sequential blocks):
B1: Review Mining — Mine G2, Capterra, TrustRadius, Product Hunt, and App Store reviews for each competitor. Extract patterns: what do people praise? What do they complain about? What features do they request? Organize by competitor and by pain theme. Include verbatim quotes.
B2: Forum & Community Mining — Mine Reddit, Indie Hackers, Hacker News, Quora, and niche communities. Find: complaints about existing tools, "what do you use for X?" threads, migration stories, workaround discussions. Build a language map — the exact words customers use to describe their problems and desires. Identify churn signals — why people leave each competitor.
Reference: Read
references/research-wave-3-gtm-signals.mdfor agent templates.
Two agents (or two sequential blocks):
C1: Go-to-Market Analysis — For each competitor: primary acquisition channel, sales motion (self-serve vs. sales-led), content strategy (blog frequency, topics, quality), social presence, paid advertising signals, partnership plays. Build a channel opportunity map showing competitor saturation vs. opportunity per channel.
C2: Strategic & Growth Signals — Funding trajectory (rounds, investors, timing), hiring patterns (engineering-heavy = building, sales-heavy = scaling, support-heavy = struggling), content/SEO footprint (what keywords they rank for, where the gaps are), product roadmap signals from changelogs and public statements. Identify content pillars each competitor owns and which topics nobody covers well.
After all three waves complete, before synthesis, briefly present what the research found to the user: how many competitors were profiled, the top customer pain themes, the most notable strategic signals (funding, hiring, GTM patterns). Ask: "Does this align with your expectations? Any competitors to add or remove before I synthesize?"
Keep it to one message — this is a quick alignment check, not a full report.
Reference: Read
references/research-synthesis.mdfor synthesis protocol and battle card template.
After the checkpoint, synthesize raw findings into strategic deliverables. This step creates the real value — it's not reporting, it's pattern-matching across data sources.
Synthesis is where raw competitor data becomes strategy — it's reasoning, not formatting. Before writing, think hard about how the findings interlock: a pricing gap means little until you connect it to a recurring customer complaint and a hiring signal. This is the highest-leverage thinking in the analysis, so if the model supports extended thinking, spend it here. Then work through these steps deliberately:
Every deliverable file must start with a standardized header: # {Title}: {product} followed by *Skill: startup-competitors | Generated: {date}*. Every deliverable must end with Red Flags, Yellow Flags, and Sources sections.
{project-name}/competitors-report.md — The main deliverable:
{project-name}/competitive-matrix.md — Feature comparison table:
{project-name}/pricing-landscape.md — Dedicated pricing analysis:
{project-name}/battle-cards/{competitor-name}.md — One per competitor:
Keep raw research files in {project-name}/raw/ for reference:
competitor-profiles.mdpricing-intelligence.mdreview-mining.mdforum-mining.mdgtm-analysis.mdstrategic-signals.mdAfter synthesis completes and all deliverable files are written, run a verification pass.
Reference: Read
references/verification-agent.mdfor the full verification protocol, universal checks, and skill-specific checks.
{project-name}/verification-report.mdIn Claude.ai or when Agent tool is unavailable, run the verification checks yourself in the main conversation following the same protocol.
Reference: Read
references/honesty-protocol.mdfor full protocol and anti-pattern details.
Competitive intelligence is only useful if it's honest. Core rules apply (label claims, quantify, declare gaps), plus competitive-intelligence-specific additions:
See references/honesty-protocol.md for the full anti-pattern table (6 entries) and detailed protocol.
Read only what you need for the current phase.
| File | When to Read | ~Lines | Purpose |
|------|-------------|--------|---------|
| honesty-protocol.md | Start of session | ~72 | Full honesty protocol with anti-patterns |
| research-principles.md | Before starting Phase 2 | ~54 | Source quality, cross-referencing, data gaps |
| research-wave-1-profiles-pricing.md | When running Wave 1 | ~186 | Agent templates for profiles + pricing |
| research-wave-2-sentiment-mining.md | When running Wave 2 | ~189 | Agent templates for review + forum mining |
| research-wave-3-gtm-signals.md | When running Wave 3 | ~192 | Agent templates for GTM + strategic signals |
| research-synthesis.md | After all waves complete | ~231 | How to synthesize + battle card template |
| research-scaling.md | After intake, before Phase 2 | ~106 | Complexity scoring, tier definitions, wave configurations |
| verification-agent.md | After synthesis | ~126 | Verification protocol, universal + skill-specific checks |
development
Market positioning strategy using the April Dunford framework, enriched with JTBD discovery, Moore positioning statement, and Neumeier's Onliness Test. Produces a complete positioning document, positioning statement, competitive alternatives map, and market category analysis. Use when the user wants to define or refine their market positioning, find their unique position, differentiate from competitors, craft a positioning statement, choose a market category, or figure out "how should we position this product." Triggers for "positioning", "how to position", "market position", "differentiation strategy", "positioning statement", "competitive positioning", "category strategy", "where do we fit in the market", "how are we different", "unique value proposition", or any request to define, sharpen, or rethink positioning. Works standalone — no prior startup-design or startup-competitors session needed, but leverages their output if available.
development
Build investor-ready pitch scripts in multiple formats (10-min, 5-min, 2-min, 1-min elevator, investor email). Produces pitch narratives, Q&A preparation, pitch scoring rubric, and optional investor roleplay practice. Use when the user wants to create a pitch, prepare for investor meetings, craft a startup pitch, write a fundraising narrative, or practice their pitch. Triggers for "pitch deck", "investor pitch", "pitch my startup", "fundraising deck", "seed deck", "how to pitch", "investor meeting", "demo day", "prepare pitch", "pitch script", "elevator pitch for investors", "pitch practice", "practice my pitch", "investor roleplay", or any request to present a startup to investors, accelerators, or partners. Works standalone — no prior startup-design session needed, but leverages its output if available.
development
Design, validate, and plan a startup from scratch. Covers market research, competitive analysis, business model, brand identity, product definition, financial projections, and validation experiments. Trigger when the user has a startup idea to explore, wants to validate a business concept, needs a business plan or lean canvas, asks for market sizing or competitive landscape, wants brand positioning or go-to-market strategy, or says anything like "I have an idea for..." or "is this idea worth pursuing". Also handles resuming from a previous checkpoint.
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.