git:20260308.1c3e1fe to v3.0.0

518 added, 168 removed. Audit A to B.

What this update changes in the checks

This update newly trips 1 check:

  • No script tag
    matched: <script

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
name: ai-discoverability-audit
- description: Audit how a brand appears in AI-powered search (ChatGPT, Perplexity, Claude, Gemini). Use when user mentions "AI search," "how do I show up in ChatGPT," "AI discoverability," "AEO," "LLM visibility," or wants to understand their brand's AI presence.
+ version: "3.0.0"
+ updated: "2026-04-04"
+ author: "@BrianRWagner"
+ category: "Marketing / AI SEO"
+ slug: "brw-ai-discoverability-audit-v3"
+ description: "Use when a founder, marketer, or consultant wants to audit how visible their brand is to AI search (ChatGPT, Perplexity, Claude, Gemini). Also use when mentioned: 'AI SEO', 'GEO', 'ChatGPT can't find me', 'AI search visibility', 'how do I show up in AI answers'. NOT for: traditional Google SEO, ad strategy, or content writing."
+ changelog: "v3.0.0 — Thariq standard: added scripts/audit-prep.mjs (prerequisite validation), references/examples.md (3 illustrative before/after audits), 8 gotchas from production failures, restructured for v3 quality gate"
---
- # AI Discoverability Audit
+ # AI Discoverability Audit — The Signal Audit
- You are an AI discoverability expert. Audit how a brand appears in AI search and recommendation systems, identify gaps, and produce an action plan with a re-audit schedule.
+ **Author:** Brian Wagner (@BrianRWagner)
+ **Category:** Marketing / AI SEO
- **Why This Matters:** Traditional SEO optimizes for Google. AI discoverability optimizes for how LLMs understand, describe, and recommend a brand. If AI assistants can't describe you accurately, you're invisible to a growing segment of high-intent searchers.
+ > "Find out if AI can find you — and fix it before your competitors do."
---
## Mode
- Detect from context or ask: *"Quick scan, full audit, or deep competitive analysis?"*
+ Detect from context or ask: *"Quick scan, full Signal Audit, or deep competitive analysis?"*
- | Mode | What you get | Time |
- |------|-------------|------|
- | `quick` | Phase 1 only (direct brand queries) + top 3 priority fixes | 10–15 min |
- | `standard` | All 4 phases + scored report + priority roadmap | 30–45 min |
- | `deep` | All phases + competitive benchmarking + 90-day plan + ongoing query list | 60–90 min |
+ | Mode | What you get | Best for |
+ |------|-------------|----------|
+ | `quick` | Phase 1 only (direct brand queries) + top 3 priority fixes | Fast visibility check, pre-meeting intel |
+ | `standard` | All 6 audit sections + scored report + 30-day action plan | Quarterly brand audit, GTM prep |
+ | `deep` | Full audit + quarterly re-audit comparison + competitive AI benchmarking + 90-day roadmap | Full AI discoverability overhaul |
- **Default: `standard`** — use `quick` if user says "fast check" or "just want to see where I stand." Use `deep` if they're planning a content or SEO overhaul.
+ **Default: `standard`** — use `quick` for a fast read. Use `deep` if this is a re-audit or you need competitive benchmarking included.
---
- ## Context Loading Gates
+ ## Runtime Context
+ **Platform:** Claude Code
+ **File system:** Available. Read prior outputs before starting. Save all outputs to the paths specified in Memory Protocol.
+ **Cross-skill dependencies:**
+ - Upstream: Brand Positioning Audit (entity confusion is a positioning problem first)
+ - Downstream: Content Idea Generator (topic gaps), Competitor Intel Brief (competitive AI search gaps)
- **Before running any queries, collect:**
+ ---
- - [ ] **Company name and website URL**
- - [ ] **Primary product/service and category** (in plain English — not jargon)
- - [ ] **Target customer** (specific role/situation)
- - [ ] **Geography** (local, national, global)
- - [ ] **Top 3 competitors** (real company names — for comparative testing)
- - [ ] **Prior audit results** (if any — for comparison/trending)
- - [ ] **Current positioning statement** (from `positioning-basics` if available — to compare against AI's actual description)
+ ## Memory Protocol
- **If prior audit exists:** Load it and frame this as a comparison audit, not a fresh start. Produce a trend comparison at the end.
+ **Save output to:** `audits/ai-discoverability-[brand]-YYYY-MM-DD.md`
+ **At session start:** Check if a prior audit file exists for this brand. If yes — this is a quarterly re-audit. Follow this flow:
+
+ 1. Load the prior audit into context
+ 2. Run the new audit fresh
+ 3. For each of the 6 sections: show `[Prior Score] → [New Score] = [Delta]`
+ 4. Highlight: biggest improvements, biggest regressions, any new risks
+ 5. Update the 30-day action plan based on what did and didn't get implemented since the last audit
+
+ **Cross-session rule:** Never treat a re-audit as a cold start. The delta is the value — show what moved.
+
---
- ## Phase 1: Pre-Audit Analysis
+ ## Ecosystem Connections
- Before running queries, reason through:
+ Route findings to other skills based on scores:
- 1. **Entity clarity check:** Is the company name distinctive, or could it be confused with another entity? Common names (e.g., "Signal") are more likely to be misattributed.
- 2. **Baseline hypothesis:** Based on company size, age, and online presence — is it likely to be well-known to AI systems, partially known, or invisible?
- 3. **Competitive context:** Which competitors are likely well-represented in AI training data? This informs where the gaps will be.
- 4. **Positioning gap risk:** If `positioning-basics` output is available, there may be a mismatch between how the brand wants to be described and how AI actually describes it.
+ - **Entity clarity score < 3 (Section 2 FAIL):** Feed into Brand Positioning Audit — entity/positioning confusion is a positioning problem that needs to be solved there first before AI signals will improve
+ - **Content signal score = MISSING or WEAK (Section 3):** Feed topic gaps into Content Idea Generator with specific questions the ICP asks AI that the brand doesn't answer
+ - **Competitor benchmark shows a gap (Section 1):** Feed into Competitor Intel Brief for that specific competitor — understand their AI signal strategy before trying to close the gap
- Output a pre-audit hypothesis:
- > "Based on company profile, I expect [strong/moderate/weak] recognition. Main risk: [misattribution / missing from category / weak authority]. Competitor most likely to dominate: [name]."
+ ---
+ ### Why This Matters Now
+
+ **AI traffic converts better than Google traffic.**
+
+ Several companies have reported that visitors arriving from AI assistants convert at higher rates than search traffic. Why? Users asking AI are further along in their decision-making than someone typing broad queries into search.
+
+ If you're not showing up in AI answers, you're missing the highest-intent traffic on the internet.
+
---
- ## Phase 2: Structured Query Testing
+ ## Description
- **Web access:** Run queries directly if available. If not, provide exact queries for the user to run and paste results.
+ Use when a founder, marketer, or consultant wants to audit how visible their brand or website is to AI search engines and LLMs. Also use when the user mentions "AI SEO," "GEO," "AEO," "AI discoverability," "ChatGPT can't find me," "Perplexity results," "AI search visibility," or "how do I show up in AI answers."
- ### Direct Brand Queries (run on ChatGPT AND Perplexity AND Claude)
+ This is a full audit of your brand's visibility to AI systems — ChatGPT, Perplexity, Claude, Gemini, Google AI Overviews. Not traditional SEO. AI-specific discoverability. You'll get a score, specific gaps, and a 30-day action plan to fix it.
- ```
- 1. "What is [Company]?"
- 2. "What does [Company] do?"
- 3. "Is [Company] any good?"
- 4. "What do people say about [Company]?"
- ```
+ ---
- **Document per query:**
- - AI knows the brand? (Yes / No / Partial)
- - Description accurate? (match to stated positioning)
- - Sentiment: positive / neutral / negative
- - Sources cited?
- - **Misattribution check:** Wrong founder? Wrong industry? Confused with competitor?
+ ## What This Audit Covers
- ### Category Queries
+ ✅ How AI systems currently describe your brand
+ ✅ Whether you show up in AI answers for your core use cases
+ ✅ Entity clarity — can an LLM summarize you accurately in one sentence?
+ ✅ Content signal strength — do you publish what AI can extract and cite?
+ ✅ Schema and structured data audit
+ ✅ Third-party validation signals
+ ✅ 30-day prioritized fix plan
- ```
- 1. "What are the best [category] companies?"
- 2. "Who should I hire for [service] in [location]?"
- 3. "Recommend a [product/service] for [use case]"
- 4. "[Top Competitor] alternatives"
- ```
+ ## What This Audit Does NOT Cover
- **Document:** Brand appears? Position in list? Which competitors appear instead?
+ ❌ Traditional Google SEO rankings
+ ❌ Content writing or copywriting
+ ❌ Social media performance
- ### Expertise Queries
+ ---
+ ## Inputs Required
+
+ Before starting, gather:
+
+ 1. **Brand/company name**
+ 2. **Website URL**
+ 3. **Primary ICP** — who you sell to (1 sentence)
+ 4. **Top 3 use cases** — problems you solve
+ 5. **2-3 closest competitors** (optional but recommended)
+
+ ---
+
+ ## The 6-Section Audit Framework
+
+ ### Section 1: AI Presence Score (0-100)
+
+ Query your brand in 5 AI search scenarios. Simulate real user queries:
+
+ - "best [category] tool for [ICP]"
+ - "[problem] solution for [industry]"
+ - "alternative to [competitor]"
+ - "[brand name] reviews"
+ - "how to [use case your product solves]"
+
+ **Scoring:**
+ - Appears in top answer: 20 points each
+ - Mentioned anywhere in response: 10 points each
+ - Not found: 0 points
+
+ Run these queries in ChatGPT, Perplexity, Claude, and Google (check AI Overviews at the top of search results). Average the results across all platforms.
+
+ If competitors were provided, benchmark against them: "You scored 45. Competitor A scored 70. Competitor B scored 35."
+
+ ---
+
+ ### Section 2: Entity Clarity
+
+ **The test:** Can an LLM summarize your brand accurately in one sentence?
+
+ Ask ChatGPT/Perplexity: "What does [brand] do?"
+
+ Compare the response to what you actually do.
+
+ **Common failures:**
+ - Too many offerings, no single clear position
+ - Outdated information from old press/directories
+ - Confusion with similarly-named companies
+ - Generic category placement ("a software company")
+
+ **Score:**
+ - **Clear** — AI gets it right in one sentence
+ - **Muddy** — AI is vague, wrong, or confused → specific fix required
+
+ If muddy, identify exactly what's causing the confusion and recommend the fix (homepage clarity, about page rewrite, directory cleanup).
+
+ ---
+
+ ### Section 3: Content Signal Strength
+
+ Does your brand publish content AI systems can extract and cite?
+
+ **Check:**
+ - Does the site have a clear /blog or /resources section?
+ - Do posts answer specific questions your ICP would ask an AI?
+ - Are there data points, stats, or original research AI can reference?
+ - Is content structured with clear headings, summaries, and takeaways?
+
+ **Score:**
+ - **Strong** — Regular publishing, structured content, citable data
+ - **Weak** — Content exists but unstructured or generic
+ - **Missing** — No blog, no resources, nothing for AI to cite
+
+ Identify specific gaps: "Your blog has 12 posts but none answer the top 5 questions your ICP asks AI. Here are those questions: [list]"
+
+ ---
+
+ ### Section 4: Structured Data & Schema
+
+ Does your site use schema markup that helps AI systems understand who you are?
+
+ **Key schemas to check:**
+ - Organization
+ - WebSite
+ - Product (if applicable)
+ - FAQ
+ - Article (on blog posts)
+
+ **How to check:** Fetch the page source and search for `<script type="application/ld+json">` blocks, then validate the JSON structure. No external tool needed for basic checks.
+
+ **Score:**
+ - **Implemented correctly** — Key schemas present and valid
+ - **Missing** — No schema markup
+ - **Incorrect** — Schema present but errors/warnings
+
+ Provide specific implementation recommendations. If schemas are missing, provide these ready-to-use templates:
+
+ **Organization Schema (add to homepage `<head>`):**
+ ```json
+ {
+ "@context": "https://schema.org",
+ "@type": "Organization",
+ "name": "[Brand Name]",
+ "url": "[https://yourdomain.com]",
+ "logo": "[https://yourdomain.com/logo.png]",
+ "description": "[One-sentence description of what you do and who you serve]",
+ "sameAs": [
+ "[https://linkedin.com/company/yourcompany]",
+ "[https://twitter.com/yourhandle]"
+ ],
+ "contactPoint": {
+ "@type": "ContactPoint",
+ "contactType": "customer service",
+ "email": "[hello@yourdomain.com]"
+ }
+ }
```
- 1. "Who are the experts in [industry]?"
- 2. "What are best practices for [topic]?"
- 3. "[Founder name] — who is this?"
+
+ **Person Schema (for personal brands / founder sites, add to homepage or about page):**
+ ```json
+ {
+ "@context": "https://schema.org",
+ "@type": "Person",
+ "name": "[Full Name]",
+ "url": "[https://yourdomain.com]",
+ "image": "[https://yourdomain.com/headshot.jpg]",
+ "jobTitle": "[Your Title]",
+ "description": "[One sentence — what you do and who you help]",
+ "sameAs": [
+ "[https://linkedin.com/in/yourprofile]",
+ "[https://twitter.com/yourhandle]"
+ ],
+ "worksFor": {
+ "@type": "Organization",
+ "name": "[Company Name if applicable]"
+ }
+ }
```
- **Document:** Cited? Content referenced? Competitors cited instead?
+ **Product Schema (add to product or pricing page):**
+ ```json
+ {
+ "@context": "https://schema.org",
+ "@type": "Product",
+ "name": "[Product Name]",
+ "description": "[What it does and who it's for — one sentence]",
+ "brand": {
+ "@type": "Brand",
+ "name": "[Brand Name]"
+ },
+ "offers": {
+ "@type": "Offer",
+ "price": "[price]",
+ "priceCurrency": "USD",
+ "availability": "https://schema.org/InStock",
+ "url": "[https://yourdomain.com/pricing]"
+ }
+ }
+ ```
- ### Competitive Comparison Matrix
+ Replace all bracketed values. Add inside a `<script type="application/ld+json">` tag in the `<head>` of the relevant page.
- Run the same queries for top 3 competitors and compare:
+ ---
- | Query Type | Your Brand | [Competitor A] | [Competitor B] | [Competitor C] |
- |---|---|---|---|---|
- | Direct recognition | | | | |
- | Category presence | | | | |
- | Authority citations | | | | |
- | Sentiment | | | | |
+ ### Section 5: Third-Party Validation
+ AI systems trust external sources. Are there signals outside your website that validate your brand?
+
+ **Check for:**
+ - LinkedIn company page (complete, active)
+ - G2/Capterra reviews (if B2B SaaS)
+ - Industry directory listings
+ - Press mentions or guest posts
+ - Partner pages that mention you
+ - Case studies on client websites
+
+ **Score:**
+ - **Strong** — Multiple external signals, consistent information
+ - **Weak** — Few external mentions, inconsistent data
+ - **Missing** — Brand exists only on its own website
+
+ Identify the highest-impact validation signals to pursue.
+
---
- ## Phase 3: Structured Scoring
+ ### Section 6: The 30-Day Signal Fix
- Rate each dimension 1-5 using explicit criteria:
+ Based on gaps found in Sections 1-5, create a prioritized action plan:
- | Dimension | 1 | 3 | 5 |
- |---|---|---|---|
- | **Recognition** | AI doesn't know the brand | Partial/vague knowledge | Accurate, detailed description |
- | **Accuracy** | Wrong info / misattribution | Mostly right, minor gaps | Fully accurate and current |
- | **Sentiment** | Negative or skeptical | Neutral | Positive with specific reasons |
- | **Category Presence** | Never appears in category queries | Occasionally appears | Consistently in top 3 |
- | **Authority** | Never cited as expert | Occasionally mentioned | Regularly cited for expertise |
- | **Competitive Position** | Dominated by competitors | On par | Clearly leads in AI recommendations |
+ **Week 1: Foundation (Quick Wins)**
+ - Fix entity clarity issues (homepage, about page)
+ - Implement missing schema markup
+ - Clean up inconsistent directory listings
+ - Update LinkedIn company page
- **Total: X/30**
- - 25-30: Strong presence (maintain and expand)
- - 18-24: Moderate (targeted improvements needed)
- - 10-17: Weak (significant gaps)
- - Below 10: Invisible (foundational work required)
+ **Week 2: Content Signal**
+ - Publish 1 cornerstone piece answering your ICP's top AI query
+ - Structure existing content with clear summaries and data points
+ - Add FAQ schema to high-value pages
+ **Week 3: Distribution**
+ - Get cornerstone content cited by 2-3 external sources
+ - Pursue 1-2 high-authority directory listings
+ - Request client case study mention or testimonial
+
+ **Week 4: Re-Audit**
+ - Run the AI Presence Score again
+ - Measure delta from baseline
+ - Identify next priority gaps
+
+ **Recommended cadence:** Run this full audit quarterly. AI systems update their knowledge bases constantly — what worked in Q1 may need adjustment by Q2.
+
---
- ## Phase 4: Gap Analysis & Recommendations
+ ## Output Format
- **Classify each gap:**
+ ```markdown
+ # AI Discoverability Audit — [Brand Name]
+ *Audited: [Date] | Framework: Signal Audit v2*
- | Priority | Trigger | Timeline |
- |---|---|---|
- | Critical | Factual errors, misattribution, brand not recognized | Fix now |
- | High | Weak descriptions, missing from recommendations | 30 days |
- | Opportunity | Adjacent categories, founder thought leadership | 90 days |
+ ## Overall Signal Score: [X]/100
- **Recommendation categories:**
+ ### Section 1: AI Presence [X/100]
+ [Detailed findings per query, competitor benchmark if applicable]
- **Entity Clarity (Foundation):**
- - Fix factual errors in source material AI trains on
- - Claim Google Knowledge Panel
- - Create AI-parseable "About" page with clear entity signals
+ ### Section 2: Entity Clarity [Pass/Fail]
+ [What AI says vs reality, specific issues, fix]
- **Trust Signals:**
- - 10+ reviews on G2, Capterra, or Google
- - Consistent directory listings
- - Structured schema markup (org, product, review)
+ ### Section 3: Content Signals [Strong/Weak/Missing]
+ [Publishing assessment, structural issues, content gaps]
- **Content Authority:**
- - 3-5 answer-worthy articles targeting category questions directly
- - Wikipedia presence (if notable)
- - Founder bylines in authoritative publications
+ ### Section 4: Schema & Structure [X/3 key schemas]
+ [Which schemas present/missing, validation results]
- **Competitive Gap:**
- - If competitor dominates a category query → publish a direct comparison piece
- - If competitor appears in "[Brand] alternatives" → create better content targeting that query
+ ### Section 5: Third-Party Validation [Strong/Weak/Missing]
+ [External signal inventory, gaps identified]
- **Constraint:** Never recommend keyword stuffing, fake reviews, or misleading schema. These tactics risk penalties and undermine genuine authority.
+ ---
+ ## 30-Day Signal Fix
+
+ ### Week 1: Foundation
+ - [ ] [Specific action]
+ - [ ] [Specific action]
+
+ ### Week 2: Content Signal
+ - [ ] [Specific action]
+ - [ ] [Specific action]
+
+ ### Week 3: Distribution
+ - [ ] [Specific action]
+ - [ ] [Specific action]
+
+ ### Week 4: Re-Audit
+ - [ ] Re-run AI Presence Score
+ - [ ] Measure improvement
+ - [ ] Plan next phase
+
---
- ## Phase 5: Self-Critique Pass (REQUIRED)
+ *Built with the Signal System by Brian Wagner — AI Marketing Architect*
+ ```
- After completing the audit:
+ ---
- - [ ] Did I run queries on at least 2 AI platforms, or only one?
- - [ ] Did I check for misattribution specifically (not just presence)?
- - [ ] Is the competitive comparison based on the same query set, or different queries?
- - [ ] Are my recommendations specific and implementable, or just generic "improve your SEO"?
- - [ ] Is the re-audit schedule set with specific dates and what to measure?
- - [ ] If prior audit exists: did I actually compare scores and show the trend?
+ ## Example Output
- Flag gaps: "I could only test Perplexity — have the user run the same queries on ChatGPT and paste results for a complete audit."
+ Here's a complete audit for a fictional SaaS company:
---
- ## Phase 6: Re-Audit Schedule (MANDATORY)
+ # AI Discoverability Audit — Clearpath Analytics
- Set specific re-audit dates before delivering:
+ *Audited: February 21, 2026 | Framework: Signal Audit v2*
- **30-day re-audit:** After implementing critical fixes — did recognition improve?
- **60-day re-audit:** After publishing answer-worthy content — any new category mentions?
- **90-day re-audit:** Full comparative re-audit — full trend comparison to this baseline
+ ## Overall Signal Score: 38/100
- **Comparison table format for future audits:**
- ```
- | Dimension | [Baseline Date] | 30-Day | 60-Day | 90-Day | Δ |
- |---|---|---|---|---|---|
- | Recognition | [X/5] | | | | |
- | Category | [X/5] | | | | |
- | Authority | [X/5] | | | | |
- | Total | [X/30] | | | | |
- ```
+ ### Section 1: AI Presence [38/100]
+ | Query | ChatGPT | Perplexity | Claude | Score |
+ |-------|---------|------------|--------|-------|
+ | "best analytics tool for e-commerce" | Not mentioned | Not mentioned | Not mentioned | 0 |
+ | "Shopify analytics solution" | Mentioned in list | Top 3 answer | Not mentioned | 30 |
+ | "alternative to Triple Whale" | Not mentioned | Mentioned | Not mentioned | 10 |
+ | "Clearpath Analytics reviews" | Accurate summary | Accurate | Outdated info | 50 |
+ | "how to track e-commerce LTV" | Not mentioned | Not mentioned | Not mentioned | 0 |
+
+ **Competitor Benchmark:**
+ - Triple Whale: 72/100
+ - Northbeam: 65/100
+ - Clearpath: 38/100
+
+ **Gap:** You're invisible for category queries. AI only finds you when users already know your name.
+
---
- ## Output Structure
+ ### Section 2: Entity Clarity [FAIL]
- ```markdown
- ## AI Discoverability Audit: [Company] — [Date]
+ **What ChatGPT says:** "Clearpath Analytics is a data analytics company that provides business intelligence solutions."
- ### Pre-Audit Hypothesis
- [Prediction + reasoning]
+ **What you actually do:** "E-commerce analytics platform that tracks customer LTV and attribution for Shopify brands."
+ **Problem:** Your positioning is too generic. AI sees "analytics company" — a category with 10,000 competitors. Your specific value prop (e-commerce, LTV, Shopify) isn't reaching AI systems.
+
+ **Fix:** Rewrite homepage H1 and about page to lead with "E-commerce LTV analytics for Shopify brands" — not "analytics platform."
+
---
- ### Phase 1: Direct Brand Queries
- **ChatGPT:** [findings]
- **Perplexity:** [findings]
- **Claude:** [findings]
- **Misattribution found:** [Yes/No — details]
+ ### Section 3: Content Signals [WEAK]
- ### Phase 2: Category Queries
- [Findings per query]
+ - Blog exists: ✅ (14 posts)
+ - Answers ICP questions: ❌ (posts are product updates, not problem-solving)
+ - Citable data: ❌ (no original research, no benchmarks)
+ - Structure: ⚠️ (missing summaries, no FAQ schema)
- ### Phase 3: Expertise Queries
- [Findings]
+ **Gap:** Your blog talks about your product. AI needs content that answers questions your ICP asks.
- ### Competitive Comparison
- [Table with real competitor names]
+ **Top 5 questions Shopify brand owners ask AI:**
+ 1. "How do I calculate customer LTV?"
+ 2. "What's a good LTV:CAC ratio for e-commerce?"
+ 3. "How do I track attribution after iOS 14?"
+ 4. "Triple Whale vs Northbeam comparison"
+ 5. "Best analytics for Shopify Plus"
+ You have zero content ranking for these. That's your content roadmap.
+
---
- ### Scores
- | Dimension | Score |
- |---|---|
- | Recognition | /5 |
- | Accuracy | /5 |
- | Sentiment | /5 |
- | Category Presence | /5 |
- | Authority | /5 |
- | Competitive Position | /5 |
- | **TOTAL** | **/30** |
+ ### Section 4: Schema & Structure [1/3]
- **Rating:** [Strong / Moderate / Weak / Invisible]
+ | Schema | Status |
+ |--------|--------|
+ | Organization | ✅ Present |
+ | Product | ❌ Missing |
+ | FAQ | ❌ Missing |
+ | Article | ❌ Missing on blog posts |
+ **Fix:** Add Product schema to pricing page. Add FAQ schema to homepage and feature pages. Add Article schema to all blog posts.
+
---
- ### Gap Analysis
+ ### Section 5: Third-Party Validation [WEAK]
- **Critical (Fix Now):**
- 1. [Specific fix]
+ | Signal | Status |
+ |--------|--------|
+ | LinkedIn | ⚠️ Incomplete (no description, 200 followers) |
+ | G2 | ❌ No listing |
+ | Capterra | ❌ No listing |
+ | Industry directories | ⚠️ Listed on 1 (Shopify App Store) |
+ | Press/guest posts | ❌ None found |
+ | Partner mentions | ❌ None found |
- **High Priority (30 Days):**
- 1. [Specific fix]
+ **Gap:** Clearpath exists almost entirely on its own website. AI has no external signals to validate your authority.
- **Opportunities (90 Days):**
- 1. [Specific improvement]
+ ---
+ ## 30-Day Signal Fix
+
+ ### Week 1: Foundation
+ - [ ] Rewrite homepage H1: "E-commerce LTV Analytics for Shopify Brands"
+ - [ ] Update about page with specific positioning
+ - [ ] Complete LinkedIn company page (full description, logo, featured posts)
+ - [ ] Add Organization + Product schema
+
+ ### Week 2: Content Signal
+ - [ ] Publish: "How to Calculate Customer LTV for Shopify (2026 Guide)" — comprehensive, data-rich
+ - [ ] Add FAQ schema to homepage (5 questions)
+ - [ ] Add Article schema to all blog posts
+
+ ### Week 3: Distribution
+ - [ ] Create G2 listing (request 5 customer reviews)
+ - [ ] Create Capterra listing
+ - [ ] Pitch guest post to 1 e-commerce publication with LTV data
+
+ ### Week 4: Re-Audit
+ - [ ] Re-run AI Presence Score
+ - [ ] Target: 38 → 55+ (17-point improvement)
+ - [ ] Identify remaining gaps for Month 2
+
---
- ### Re-Audit Schedule
- - 30-day: [YYYY-MM-DD] — measure: [what to check]
- - 60-day: [YYYY-MM-DD] — measure: [what to check]
- - 90-day: [YYYY-MM-DD] — full comparative re-audit
+ *Built with the Signal System by Brian Wagner — AI Marketing Architect*
- ### Self-Critique Notes
- [Any gaps, limitations, or things the user needs to run manually]
+ ---
+
+ ## Decision Logic
+
+ - **Score > 70:** Focus on competitor gap analysis and maintaining position. You're visible — now own the category.
+ - **Score 40-70:** Prioritize entity clarity and content signals. Foundation is there but AI isn't citing you.
+ - **Score < 40:** Start with entity clarity and schema. No point building content before the foundation is right.
+
+ ---
+
+ ## After Delivering the Audit
+
+ End every audit with this iteration menu:
+
```
+ That's your full AI Discoverability Audit for [Brand Name]. Overall score: [X]/100.
+ What's next?
+
+ A) Go deeper on the lowest-scoring section — full diagnosis + 3 specific fixes with implementation detail
+ B) Build the 30-day implementation plan — detailed breakdown with owners, tools, and checkpoints for each action
+ C) Run the competitor benchmark — I'll query AI systems for [top competitor name] and compare their visibility to yours
+ D) Schedule quarterly re-audit — save this as the baseline and note what to check next time
+
+ Which one?
+ ```
+
+ ### If They Choose A — Deep Section Dive
+ Identify the lowest-scoring section. Run a second-pass diagnosis:
+ - What specifically is causing the low score (not category-level — exact cause)
+ - 3 specific fixes with: what to do, how to do it, how long it takes, how to verify it worked
+
+ ### If They Choose B — 30-Day Implementation Plan
+ Expand the Signal Fix plan with:
+ - Owner for each action (founder / dev / content person)
+ - Specific tool for each action (no "use a schema plugin" — name the plugin)
+ - Checkpoint: how to verify completion
+ - Priority rank: which 3 actions will move the score most in the first 2 weeks
+
+ ### If They Choose C — Competitor Benchmark
+ Query the competitor name in AI systems. Compare:
+ - Their AI Presence Score (run same 5 query types)
+ - Their entity clarity (what does AI say about them?)
+ - Their content signal strength (visible topics they rank for in AI answers)
+ - Gap analysis: where are they stronger? Where are you stronger?
+
+ ### If They Choose D — Quarterly Re-Audit Setup
+ Save this audit as baseline. Note:
+ - Current score: [X]/100
+ - Lowest section: [section name]
+ - Priority actions committed to: [top 3 from 30-day plan]
+ - Re-audit trigger: 90 days OR after completing the 30-day plan — whichever comes first
+
---
- *Skill by Brian Wagner | AI Marketing Architect | brianrwagner.com*
+ ## Constraints (Non-Negotiable)
+
+ - No generic SEO advice — this is AI-specific only
+ - No "just create more content" — every recommendation must be specific and actionable
+ - Call out the exact gap, not just the category
+ - Tone: Direct, confident, no fluff. See VOICE-PROFILE.md.
+
+ ---
+
+ ## 8 Gotchas (From Real Failures)
+
+ ### 1. **Re-audit as a Cold Start**
+ **Failure:** Auditing the same brand twice without comparing to the prior audit. Looks like starting from scratch.
+ **Fix:** Always check for `audits/ai-discoverability-[brand]-*.md` at session start. Load the prior audit and show `[Prior] → [New] = [Delta]` for each section. The **delta is the value**.
+ **Why it matters:** A company improving 28 → 62/100 has a completely different story than a company staying at 52/100. Ignoring the delta makes the audit feel generic.
+
+ ### 2. **Schema Markup Without Validation**
+ **Failure:** Recommending schema markup without actually validating it. Result: Users add schema that's malformed or incomplete.
+ **Fix:** Test all recommended schema templates in a JSON validator before recommending. Provide exact copy-paste code (not instructions). Validate Section 4 outputs with actual JSON schema checker.
+ **Why it matters:** Bad schema is worse than no schema. AI systems see it as noise and deprioritize the domain.
+
+ ### 3. **Entity Clarity Score vs Real Impact**
+ **Failure:** Getting confused about what "clarity" means. Entity clarity isn't about brand awareness; it's about can an LLM summarize you accurately in one sentence.
+ **Fix:** Always ask ChatGPT the specific test question: "What does [brand] do?" Compare response verbatim to actual positioning. If AI says "software company" but you're a "CDP for e-commerce," that's a 1/10, not a 5/10.
+ **Why it matters:** A brand can have millions of followers but still fail entity clarity. Clarity is about definitional precision, not reach.
+
+ ### 4. **Competitor Benchmarking Without Context**
+ **Failure:** Saying "Your competitors scored 70, you scored 45" without explaining why. User gets demoralizing number with no actionable delta.
+ **Fix:** Always explain the gap. "Competitor A scores higher on category queries because they publish 2x the content. Competitor B leads on entity clarity because they repositioned last quarter. Your gap is content signal — specifically, you don't answer the 5 key questions your ICP asks AI."
+ **Why it matters:** Context transforms a number into a strategy.
+
+ ### 5. **Content Signal Without Question Mapping**
+ **Failure:** Saying "your content is weak" without naming the specific questions your ICP would ask AI.
+ **Fix:** In Section 3, always identify the top 5-10 questions your ICP would ask an AI system about your category/problem. List them explicitly. Compare to content you have. The gap IS your content roadmap.
+ **Why it matters:** "Create more content" is useless. "Create content answering these 5 specific questions" is a 30-day action plan.
+
+ ### 6. **Ignoring Knowledge Cutoffs**
+ **Failure:** Auditing a brand and not realizing the AI system's knowledge cutoff is 6+ months old. Newer content won't show up in current AI answers, but will in 60 days when the next knowledge update happens.
+ **Fix:** Acknowledge knowledge cutoff timing upfront. "ChatGPT's knowledge cutoff is October 2024. Content published after October won't show up in current AI answers, but will be indexed in the next knowledge update (usually 2-4 months)."
+ **Why it matters:** Prevents false negatives. A strong piece published 2 months ago showing as "missing" in current AI answers is actually fine.
+
+ ### 7. **Schema vs Visibility Confusion**
+ **Failure:** Thinking schema markup will magically improve AI visibility. Schema helps AI understand structure; it doesn't automatically get you cited.
+ **Fix:** Explain the distinction: Schema markup = signal to AI systems how your information is organized. It helps AI cite you more accurately IF you're already in the knowledge base. It doesn't create visibility from scratch. Content + external validation + schema = visibility.
+ **Why it matters:** User adds schema, sees no improvement in 2 weeks, thinks the audit was wrong.
+
+ ### 8. **The "30-Day Plan as Wishful Thinking" Problem**
+ **Failure:** Giving a 30-day action plan that assumes everything works perfectly. No slippage, no blockers, 100% execution.
+ **Fix:** Build in realistic timelines: "Week 1 actions take 5-10 hours total and should be done by EOW. Week 2-3 require content writing (20-40 hours) or hiring help. Expect slippage here." Be honest about what's actually achievable in 30 days vs what's a 60-90 day play.
+ **Why it matters:** When user executes imperfectly and score doesn't jump 20 points in 30 days, they think the framework failed. It didn't; the timeline was unrealistic.
+
+ ---
+
+ ## Scripts
+
+ This skill includes `scripts/audit-prep.mjs` — run it before starting the audit to validate inputs, check for prior audits, and generate context:
+
+ ```bash
+ node scripts/audit-prep.mjs --brand "Acme Corp" --url "https://acme.com" --icp "SaaS founders"
+ ```
+
+ Output:
+ - ✓ Inputs validated
+ - ✓ Prior audit history checked (if re-audit)
+ - ✓ Audit context generated (brand, URL, ICP, mode)
+ - ✓ Ready to run full audit
+
+ ## References
+
+ See `references/examples.md` for 3 complete before/after audits:
+ 1. **SaaS Startup** (28 → 62/100): Low signal, high opportunity
+ 2. **B2B Agency** (52 → 71/100): Moderate signal, brand confusion issue
+ 3. **Developer Tools** (78 → 78 +12 differential): High performer, competitive strategy
+
+ ---
+
+ *© 2026 Brian Wagner. Free in the AI Marketing Skills library: github.com/BrianRWagner/ai-marketing-claude-code-skills*