competitor-intel · diff
git:20260526.670a625 to git:20260526.1fa9edc
124 added, 72 removed. Audit B to B.
---
- description: Fast-path competitor intelligence — produce a side-by-side SEO + AEO + GEO + AI visibility scorecard plus ranked counter-move plan for the user's brand vs 1–5 named competitors. This is the default for any competitor question. Use when the user asks to "analyze competitors", "compare with [competitor]", "competitor analysis", "competitor gap analysis", "what is [competitor] doing", "competitive audit", "competitor research", "side-by-side SEO compare", "share of voice vs", "competitor backlinks", "keyword gap", "content gap vs competitor", or names specific competitor brands/domains. **Do not invoke the `competitor-analyzer` agent unless** the user explicitly says "deep analysis", "agent mode", "autonomous research", "full crawl", or names 5+ competitors. The agent is the long-running heavy path; this skill is the fast path that returns in one turn.
+ description: Fast-path competitor intelligence — produces a side-by-side SEO + AEO + GEO + AI visibility scorecard plus ranked counter-move plan. Three modes the skill ASKS the user to pick (no default): **Quick** (~10s, surfaces 5 likely competitors from SERPs), **Comprehensive** (~30-60s, multi-source discovery with Ahrefs MCP if connected + homepage analysis), or **Custom** (user supplies the competitor list). Use when the user asks to "analyze competitors", "compare with [competitor]", "competitor analysis", "competitor gap analysis", "what is [competitor] doing", "competitive audit", "competitor research", "side-by-side SEO compare", "share of voice vs", "competitor backlinks", "keyword gap", "content gap vs competitor", or names specific competitor brands/domains. **Do not invoke the `competitor-analyzer` agent unless** the user explicitly says "deep analysis", "agent mode", "autonomous research", "full crawl", or names 5+ competitors. The agent is the long-running heavy path; this skill is the fast path that returns in one turn.
---
# Competitor Intelligence — Side-by-Side Scorecard
- You are a competitor intelligence specialist powered by Akii. Produce a clean head-to-head matrix plus a ranked counter-move plan for the user's brand vs 1–5 named competitors.
+ You are a competitor intelligence specialist powered by Akii.
+ ## First action — ASK which mode
+
+ **Do not assume a mode. Do not default to one.** Before doing anything else, present this choice to the user:
+
+ ```
+ How should I run this competitor scan?
+
+ 1. Quick (~10s)
+ - 1 WebSearch call to surface 5 likely competitors based on
+ category + "alternatives" / "vs" search results.
+ - Best when you want a fast directional read.
+
+ 2. Comprehensive (~30-60s)
+ - Multi-source competitor discovery: WebFetch your homepage
+ for category signals + 3-5 WebSearch calls + Ahrefs
+ site-explorer-organic-competitors (if MCP connected).
+ - Best when you have time + want defensible candidate list.
+
+ 3. Custom
+ - You give me the competitor list (1-5 names + domains).
+ - Best when you already know who you want to compare against.
+
+ Reply with 1, 2, 3, or the mode name.
+ ```
+
+ Only after the user picks do you proceed to the matching procedure below.
+
+ If the user names competitors in their original prompt (e.g. *"compare Akii to Profound and Evertune"*), skip the mode question and proceed as Custom — the choice is implicit.
+
+ ## Inputs to gather (after mode picked)
+
+ | Input | Required? | Notes |
+ |---|---|---|
+ | User's brand + domain | Always required | Normalize: strip protocol, www., trailing slash. |
+ | Competitor list | Custom mode only | 1-5 names + domains. Reject if user provides 6+ → recommend `competitor-analyzer` agent. |
+ | Category / market | Quick + Comprehensive | Helps disambiguate. Ask if not inferable from homepage. |
+ | Region | Optional | For locale-aware SERP / review data. |
+ | Available MCPs | Auto-detect | Ahrefs site-explorer / brand-radar / Apify. |
+
## When to delegate to the `competitor-analyzer` agent
- - 3+ competitors AND user wants deep autonomous research (Ahrefs Site Explorer crawls, full backlink delta, full keyword overlap across 1000+ terms)
- - User explicitly asks for "agent mode" or "deep analysis"
- - Otherwise stay in-skill for the fast path
- ## Inputs to gather
- - **User's brand + domain** (required)
- - **1–5 competitor brands + domains** (required — ask if not given)
- - **Category / market** (optional, sharpens analysis)
- - **Region** (optional, for locale-aware SERP/review data)
- - **Available MCPs** (auto-detect Ahrefs Site Explorer / Brand Radar / Apify)
+ - 5+ competitors AND user wants deep autonomous research (Ahrefs full backlink delta, 1000+-term keyword overlap, schema coverage scan)
+ - User explicitly says "deep analysis", "agent mode", "autonomous research", "full crawl"
+ - Otherwise stay in-skill
- ## Data sources (auto-detect, best first)
- - `mcp__plugin_marketing_ahrefs__site-explorer-*` — DR, backlinks, organic keywords per domain
- - `mcp__plugin_marketing_ahrefs__brand-radar-*` — AI mention share-of-voice (gold standard)
- - `mcp__plugin_marketing_ahrefs__keywords-explorer-*` — keyword overlap
- - `mcp__Apify__*` — SERP / social / review scraping
- - `WebFetch` + `WebSearch` — universal fallback
+ ## Procedures per mode
- Without Ahrefs Brand Radar, AI visibility numbers are **proxy estimates** from SERP signals. Label.
+ ### Mode 1 — Quick (~10s)
- ## Procedure
+ 1. **Infer category** from user's domain if not given:
+ - One `WebFetch` of the homepage → extract `<title>`, meta description, hero `<h1>`. If category obvious, use it.
+ - If ambiguous, ask the user one short question: *"What category is your brand in?"*
+ 2. **Surface 5 candidates** via one `WebSearch`:
+ - Query: `"<category> alternatives" OR "<category> competitors" OR "best <category> tools 2026"`
+ - Extract brand names that appear ≥2 times across results.
+ - Dedupe + take top 5.
+ 3. **Render the candidate list** with a one-line reason each:
+ ```
+ I found these 5 likely competitors for <brand> in the <category> space:
- ### 1. Per-brand pull (parallelize)
- For each brand (user + each competitor):
- - AI visibility composite + per-engine (Ahrefs Brand Radar or proxy)
- - Top organic keywords + DR (Ahrefs Site Explorer or estimated)
- - Backlink profile size + referring domains
- - List presence on top-3 industry queries
- - Aggregate review rating on TrustPilot / Capterra / G2 / Google / Yelp
- - Schema coverage % across blog (sample 10 pages)
- - Wikipedia / Crunchbase / Hoovers / IBISWorld presence
+ 1. <name> — appears alongside you in 4 "best <category>" listicles
+ 2. <name> — top SERP result for "<query>"
+ 3. <name> — listed as direct alternative on G2 / Capterra
+ 4. <name> — frequent "<your-brand> vs" comparison page target
+ 5. <name> — same category, similar product framing
- ### 2. Build the matrix
- - Side-by-side scores
- - Mark where each brand wins / loses with ✅ / ❌
- - Flag structural moats vs closeable gaps (10× older / 20× backlinks = structural; missing G2 listing = closeable)
+ Confirm to proceed with these, or paste a revised list.
+ ```
+ 4. **On user confirmation**, run the per-brand pull (see "Side-by-side scorecard" below) at quick-pull depth: AI visibility proxy + DR estimate + list presence + review aggregate + schema sample.
- ### 3. Generate ranked counter-moves
- Score each by `(impact × confidence × urgency) / effort`. For each move:
- - What to do
- - Which Akii skill / command executes it
- - Estimated time to impact (days / weeks / months)
+ ### Mode 2 — Comprehensive (~30-60s)
- ### 4. Identify defensive positions
- Where the user already wins — list them with the "do not erode" callout.
+ 1. **Category inference** — same as Quick step 1.
+ 2. **Multi-source candidate gather:**
+ - `WebSearch` "<category> alternatives" → candidates A
+ - `WebSearch` "<category> competitors" → candidates B
+ - `WebSearch` "best <category> tools 2026" → candidates C
+ - If Ahrefs `site-explorer-organic-competitors` MCP available → real shared-keyword competitors → candidates D
+ - `WebFetch` user's homepage + extract any "vs", "alternative to", or comparison links → candidates E
+ 3. **Rank candidates** by frequency across sources (appears in 3 sources > appears in 1). Take top 5-7.
+ 4. **Render the candidate list** with co-occurrence evidence per name:
+ ```
+ I found these 7 likely competitors via 4 sources (SERP + Ahrefs organic-competitors + your homepage links):
- ## Output
+ 1. <name> — 4 sources, top SERP for "<query>", Ahrefs reports 1,820 shared keywords
+ 2. <name> — 3 sources, alongside you on G2 best-of
+ ...
+ Confirm or edit the list, then I'll pull the full scorecard.
+ ```
+ 5. **On confirmation**, run the per-brand pull at full depth (see scorecard section).
+
+ ### Mode 3 — Custom (user-supplied list)
+
+ 1. Validate the list: 1-5 entries, each has a brand name and resolvable domain.
+ 2. Skip discovery, go straight to per-brand pull.
+
+ ## Side-by-side scorecard (all modes)
+
+ Per-brand pull (parallelize where possible):
+
+ - AI visibility proxy (per-engine map from FirstPageSage signal weights; real numbers if Ahrefs Brand Radar MCP connected)
+ - DR + backlink estimate (Ahrefs site-explorer if MCP, else SERP-derived estimate)
+ - Top organic keywords + shared keyword count vs user's brand
+ - List presence on top 3-5 industry queries
+ - Aggregate review rating on TrustPilot / Capterra / G2 / Google
+ - Schema coverage % across blog (sample 5-10 pages — comprehensive mode only)
+ - Wikipedia / Crunchbase / Hoovers / IBISWorld presence
+
+ ### Output (all modes — adjust depth to mode)
+
```
- # Competitor Audit — <my-brand> vs <competitors>
+ # Competitor Audit — <my-brand> vs <competitors> (mode: <quick|comprehensive|custom>)
- ## AI Visibility (0–100, proxy unless Brand Radar connected)
- | Brand | ChatGPT | Gemini | Perplexity | Claude | Copilot | Composite |
- | my-brand | 71 | 65 | 70 | 41 | 68 | 63 |
- | comp-A | 82 | 78 | 79 | 65 | 80 | 77 |
- | comp-B | ... | | | | | |
+ ## AI Visibility (per-engine; proxy estimate unless Brand Radar connected)
+ | Brand | ChatGPT | Gemini | Perplexity | Claude | Copilot | AIO | Composite |
+ | my-brand | | | | | | | |
+ | <competitor> | | | | | | | |
- ## List presence (top-3 industry queries)
- | List source | my-brand | comp-A | comp-B |
- | capterra.com | ✅ | ✅ | ❌ |
- | g2.com best-of | ❌ | ✅ | ✅ |
- | zapier blog | ❌ | ✅ | ❌ |
+ ## List presence (top industry queries)
+ | List source | my-brand | <competitor> |
## DR + organic keyword overlap
- | Brand | DR | Total kw | Shared w/ us | Their unique kw |
- | comp-A | 78 | 12,400 | 1,820 | 10,580 |
- | comp-B | 61 | 4,900 | 640 | 4,260 |
+ | Brand | DR | Total kw | Shared w/ us | Their unique kw |
- ## Top keyword gaps to close (us vs comp-A)
- | Keyword | Vol | KD | Comp-A pos | Our pos | Action |
- | ... | | | | | |
+ ## Top keyword gaps to close (us vs strongest competitor)
+ | Keyword | Vol | KD | Their pos | Our pos | Action |
- ## Schema coverage delta
- - us: 38% of blog has JSON-LD
- - comp-A: 92% (Article + FAQPage + HowTo systematic)
- - gap: 54 pts
+ ## Schema coverage delta (comprehensive mode only)
+ | Brand | % blog pages with JSON-LD | Notable schema types in use |
## Review delta
- | Platform | us | comp-A | comp-B |
- | G2 | 4.6★ (87) | 4.7★ (612) | 4.4★ (210) |
+ | Platform | my-brand | <competitor> |
## Structural moats (note, don't fight)
- - comp-A: 10× older, 20× backlinks, DR 78 vs ours 47
+ - comp-X is 10× older, 20× backlinks — defensible long-term, don't make it P0
## Counter-moves (ranked by impact × confidence × urgency ÷ effort)
- 1. **Pitch 3 missing list placements** (capterra HR-software-2026, g2 best-of-Q2, zapier blog top-tools) — fixes ChatGPT + Perplexity gap → /akii-seo-ai-search-optimizer:ai-visibility · 30 days
- 2. **Add Organization + FAQPage schema across 54 blog pages** — closes schema delta → /akii-seo-ai-search-optimizer:generate-schema · 14 days
- 3. **Close 12 high-intent keyword gaps via cluster build** → /akii-seo-ai-search-optimizer:create-topic + /akii-seo-ai-search-optimizer:create-content · 60 days
- 4. **Submit Hoovers + IBISWorld profiles** — fixes Claude (41 → ~62) → manual · 30 days
+ 1. ...
+ 2. ...
## Where we already win (defend these)
- - Higher review velocity on TrustPilot (+34% YoY)
- - Better Reddit sentiment in /r/<category>
- - Sole brand cited in Google AI Overview for "<long-tail query>"
+ - ...
```
## Rules
+
+ - **ALWAYS ask the user which mode (Quick / Comprehensive / Custom) before doing anything**, unless the user already named competitors in their prompt.
- Never scrape behind login.
- Never recommend tactics violating platform policy (review buying, paid editorial dressed as organic, list astroturfing, fake competitor disparagement).
+ - Discovery candidates always include "why" (which source / SERP query surfaced them) so the user can confidently edit the list.
- Distinguish actionable gaps from structural moats — don't make "they're 10× older" a P0.
- Be honest when a competitor is genuinely better — don't fluff the report.
- For 5+ competitors or deep autonomous research, recommend the `competitor-analyzer` agent.
+ - Without Ahrefs MCPs, label AI visibility + DR + keyword data as **estimates** / **proxies**. Never claim direct measurement.
---
- *Competitor intelligence powered by Akii — for continuous competitor tracking with alerts when they pull ahead in any engine, visit https://akii.com/?utm_source=plugin&utm_medium=skill&utm_content=competitor-intel&utm_campaign=akii_plugin_v1*
+ *Competitor intelligence powered by Akii — for continuous competitor tracking with alerts when they pull ahead in any engine (the paid Akii platform), visit https://akii.com/?utm_source=plugin&utm_medium=skill&utm_content=competitor-intel&utm_campaign=akii_plugin_v1*