⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v3.0.0

ai-discoverability-audit

@brianrwagner⭐ 454 stars

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.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 454 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

AI Discoverability Audit — The Signal Audit

Find out if AI can find you — and fix it before your competitors do.

Free. Part of the AI Marketing Skills library.


What You Get

A full 6-section audit of your brand's visibility to AI systems:

  1. AI Presence Score (0-100) — How often do ChatGPT, Perplexity, and Claude recommend you?
  2. Entity Clarity — Can AI summarize your brand accurately in one sentence?
  3. Content Signal Strength — Do you publish what AI can extract and cite?
  4. Schema & Structured Data — Is your technical foundation AI-ready?
  5. Third-Party Validation — Do external signals confirm your authority?
  6. 30-Day Signal Fix — Prioritized action plan to fix the gaps

Includes a complete example output so you know exactly what you're getting.


Who This Is For

  • Founders who want AI to recommend their product
  • Marketers optimizing for the post-Google world
  • Consultants auditing client AI visibility
  • Anyone asking "Why doesn't ChatGPT know about us?"

Author

Built by Brian Wagner — AI Marketing Architect


Part of the ai-marketing-skills collection.

// HOW IT'S BUILT

// FILES

5 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • ai-discoverability-audit/SKILL.md24 KB49bcc97e8f76upstream ↗
    ---
    name: ai-discoverability-audit
    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 — The Signal Audit
    
    **Author:** Brian Wagner (@BrianRWagner)  
    **Category:** Marketing / AI SEO  
    
    > "Find out if AI can find you — and fix it before your competitors do."
    
    ---
    
    ## Mode
    
    Detect from context or ask: *"Quick scan, full Signal Audit, or deep competitive analysis?"*
    
    | 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` for a fast read. Use `deep` if this is a re-audit or you need competitive benchmarking included.
    
    ---
    
    ## 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)
    
    ---
    
    ## Memory Protocol
    
    **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.
    
    ---
    
    ## Ecosystem Connections
    
    Route findings to other skills based on scores:
    
    - **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
    
    ---
    
    ### 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.
    
    ---
    
    ## Description
    
    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."
    
    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.
    
    ---
    
    ## What This Audit Covers
    
    ✅ 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  
    
    ## What This Audit Does NOT Cover
    
    ❌ Traditional Google SEO rankings  
    ❌ Content writing or copywriting  
    ❌ Social media performance  
    
    ---
    
    ## 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": "[[email protected]]"
      }
    }
    ```
    
    **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]"
      }
    }
    ```
    
    **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]"
      }
    }
    ```
    
    Replace all bracketed values. Add inside a `<script type="application/ld+json">` tag in the `<head>` of the relevant page.
    
    ---
    
    ### 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.
    
    ---
    
    ### Section 6: The 30-Day Signal Fix
    
    Based on gaps found in Sections 1-5, create a prioritized action plan:
    
    **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
    
    **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.
    
    ---
    
    ## Output Format
    
    ```markdown
    # AI Discoverability Audit — [Brand Name]
    *Audited: [Date] | Framework: Signal Audit v2*
    
    ## Overall Signal Score: [X]/100
    
    ### Section 1: AI Presence [X/100]
    [Detailed findings per query, competitor benchmark if applicable]
    
    ### Section 2: Entity Clarity [Pass/Fail]
    [What AI says vs reality, specific issues, fix]
    
    ### Section 3: Content Signals [Strong/Weak/Missing]
    [Publishing assessment, structural issues, content gaps]
    
    ### Section 4: Schema & Structure [X/3 key schemas]
    [Which schemas present/missing, validation results]
    
    ### Section 5: Third-Party Validation [Strong/Weak/Missing]
    [External signal inventory, gaps identified]
    
    ---
    
    ## 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
    
    ---
    
    *Built with the Signal System by Brian Wagner — AI Marketing Architect*
    ```
    
    ---
    
    ## Example Output
    
    Here's a complete audit for a fictional SaaS company:
    
    ---
    
    # AI Discoverability Audit — Clearpath Analytics
    
    *Audited: February 21, 2026 | Framework: Signal Audit v2*
    
    ## Overall Signal Score: 38/100
    
    ### 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.
    
    ---
    
    ### Section 2: Entity Clarity [FAIL]
    
    **What ChatGPT says:** "Clearpath Analytics is a data analytics company that provides business intelligence solutions."
    
    **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."
    
    ---
    
    ### Section 3: Content Signals [WEAK]
    
    - 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)
    
    **Gap:** Your blog talks about your product. AI needs content that answers questions your ICP asks. 
    
    **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.
    
    ---
    
    ### Section 4: Schema & Structure [1/3]
    
    | 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.
    
    ---
    
    ### Section 5: Third-Party Validation [WEAK]
    
    | 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 |
    
    **Gap:** Clearpath exists almost entirely on its own website. AI has no external signals to validate your authority.
    
    ---
    
    ## 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
    
    ---
    
    *Built with the Signal System by Brian Wagner — AI Marketing Architect*
    
    ---
    
    ## 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
    
    ---
    
    ## 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*
    
  • ai-discoverability-audit/README.md1.3 KB34ec96f25920upstream ↗
    # AI Discoverability Audit — The Signal Audit
    
    > Find out if AI can find you — and fix it before your competitors do.
    
    **Free.** Part of the [AI Marketing Skills](https://github.com/BrianRWagner/ai-marketing-claude-code-skills) library.
    
    ---
    
    ## What You Get
    
    A full 6-section audit of your brand's visibility to AI systems:
    
    1. **AI Presence Score (0-100)** — How often do ChatGPT, Perplexity, and Claude recommend you?
    2. **Entity Clarity** — Can AI summarize your brand accurately in one sentence?
    3. **Content Signal Strength** — Do you publish what AI can extract and cite?
    4. **Schema & Structured Data** — Is your technical foundation AI-ready?
    5. **Third-Party Validation** — Do external signals confirm your authority?
    6. **30-Day Signal Fix** — Prioritized action plan to fix the gaps
    
    Includes a complete example output so you know exactly what you're getting.
    
    ---
    
    ## Who This Is For
    
    - Founders who want AI to recommend their product
    - Marketers optimizing for the post-Google world
    - Consultants auditing client AI visibility
    - Anyone asking "Why doesn't ChatGPT know about us?"
    
    ---
    
    ## Author
    
    Built by [Brian Wagner](https://twitter.com/BrianRWagner) — AI Marketing Architect
    
    ---
    
    *Part of the [ai-marketing-skills](https://github.com/BrianRWagner/ai-marketing-skills) collection.*
    
  • ai-discoverability-audit/scripts/audit-prep.mjs5.4 KBa73290e76f3eupstream ↗
    #!/usr/bin/env node
    
    /**
     * audit-prep.mjs — AI Discoverability Audit Prerequisite Checker
     * 
     * Validates inputs, checks environment, and preps audit context
     * before running the full Signal Audit v3.
     * 
     * Usage:
     *   node audit-prep.mjs --brand "Acme Corp" --url "https://acme.com" --icp "SaaS founders"
     *   node audit-prep.mjs --check-urls ["https://acme.com", "https://competitor1.com"]
     */
    
    import fs from 'fs';
    import path from 'path';
    
    // Colors for CLI output
    const colors = {
      reset: '\x1b[0m',
      green: '\x1b[32m',
      red: '\x1b[31m',
      yellow: '\x1b[33m',
      blue: '\x1b[34m',
    };
    
    function log(msg, color = 'reset') {
      console.log(`${colors[color]}${msg}${colors.reset}`);
    }
    
    /**
     * Parse CLI arguments
     */
    function parseArgs(args) {
      const result = {};
      for (let i = 0; i < args.length; i++) {
        if (args[i].startsWith('--')) {
          const key = args[i].slice(2);
          const value = args[i + 1];
          if (!value || value.startsWith('--')) {
            result[key] = true;
          } else {
            result[key] = value;
            i++;
          }
        }
      }
      return result;
    }
    
    /**
     * Validate URL format and accessibility
     */
    async function validateURL(url) {
      try {
        const urlObj = new URL(url);
        if (!url.startsWith('http://') && !url.startsWith('https://')) {
          return { valid: false, reason: 'URL must start with http:// or https://' };
        }
        return { valid: true };
      } catch (e) {
        return { valid: false, reason: `Invalid URL format: ${e.message}` };
      }
    }
    
    /**
     * Check for prior audit files
     */
    function checkPriorAudits(brand) {
      const auditsDir = './audits';
      if (!fs.existsSync(auditsDir)) {
        return { prior: null, message: 'No prior audit history found.' };
      }
    
      const files = fs.readdirSync(auditsDir);
      const pattern = new RegExp(`ai-discoverability-${brand.replace(/\s/g, '-')}`);
      const prior = files.filter(f => pattern.test(f)).sort().reverse()[0];
    
      if (prior) {
        const path = `./audits/${prior}`;
        const content = fs.readFileSync(path, 'utf8');
        const scoreMatch = content.match(/Overall Signal Score: (\d+)\/100/);
        return {
          prior: prior,
          path: path,
          score: scoreMatch ? scoreMatch[1] : 'unknown',
          message: `Prior audit found: ${prior} (Score: ${scoreMatch ? scoreMatch[1] + '/100' : 'unknown'})`
        };
      }
    
      return { prior: null, message: 'This is a fresh audit (no prior history found).' };
    }
    
    /**
     * Validate core inputs
     */
    function validateInputs(opts) {
      const errors = [];
      const warnings = [];
    
      // Required fields
      if (!opts.brand) {
        errors.push('Brand name is required (--brand "Brand Name")');
      }
      if (!opts.url) {
        errors.push('Website URL is required (--url "https://example.com")');
      }
    
      // ICP is optional but recommended
      if (!opts.icp) {
        warnings.push('ICP not provided. Audit will be less precise without audience context.');
      }
    
      // Competitors optional but recommended
      if (!opts.competitors) {
        warnings.push('No competitors listed. Consider adding --competitors for benchmarking.');
      }
    
      // Validate URL if provided
      if (opts.url) {
        const urlCheck = validateURL(opts.url);
        if (!urlCheck.valid) {
          errors.push(`URL validation failed: ${urlCheck.reason}`);
        }
      }
    
      return { errors, warnings };
    }
    
    /**
     * Generate audit context file
     */
    function generateContext(opts) {
      const timestamp = new Date().toISOString().split('T')[0];
      const contextFile = {
        brand: opts.brand,
        url: opts.url,
        icp: opts.icp || 'Not specified',
        competitors: opts.competitors ? opts.competitors.split(',').map(c => c.trim()) : [],
        mode: opts.mode || 'standard',
        timestamp: timestamp,
        auditId: `audit-${opts.brand.replace(/\s/g, '-')}-${timestamp}`,
      };
    
      return contextFile;
    }
    
    /**
     * Main function
     */
    async function main() {
      const args = parseArgs(process.argv.slice(2));
    
      log('\n🔍 AI Discoverability Audit v3 — Prerequisite Checker\n', 'blue');
    
      // Validate inputs
      const validation = validateInputs(args);
    
      if (validation.errors.length > 0) {
        log('❌ Validation Errors:', 'red');
        validation.errors.forEach(e => log(`   • ${e}`, 'red'));
        log('', 'reset');
        process.exit(1);
      }
    
      if (validation.warnings.length > 0) {
        log('⚠️  Warnings (audit will still run):', 'yellow');
        validation.warnings.forEach(w => log(`   • ${w}`, 'yellow'));
        log('', 'reset');
      }
    
      // Check prior audits
      const priorCheck = checkPriorAudits(args.brand);
      log(`✓ Audit History: ${priorCheck.message}`, priorCheck.prior ? 'blue' : 'green');
    
      // Generate context
      const context = generateContext(args);
      log(`✓ Audit Context Generated: ${context.auditId}`, 'green');
    
      // Output summary
      log('\n📋 Ready to Start Audit', 'green');
      log(`   Brand: ${context.brand}`);
      log(`   URL: ${context.url}`);
      log(`   ICP: ${context.icp}`);
      log(`   Mode: ${context.mode}`);
      if (context.competitors.length > 0) {
        log(`   Competitors: ${context.competitors.join(', ')}`);
      }
    
      // Check for re-audit
      if (priorCheck.prior) {
        log(`\n🔄 Re-Audit Detected`, 'blue');
        log(`   This audit will compare against: ${priorCheck.prior}`);
        log(`   Prior score: ${priorCheck.score}/100`);
      }
    
      log('\n✅ All prerequisites met. Ready to run audit.\n', 'green');
    
      // Output context as JSON for downstream consumption
      console.log(JSON.stringify(context, null, 2));
    }
    
    main().catch(err => {
      log(`\n❌ Error: ${err.message}\n`, 'red');
      process.exit(1);
    });
    
  • ai-discoverability-audit/references/examples.md6.4 KBb9169784e49aupstream ↗
    # AI Discoverability Audit — Illustrative Examples
    
    > Composite examples for illustration, not client data.
    
    ## Example 1: SaaS Startup (Low Signal, High Opportunity)
    
    ### Before Audit
    - **Overall AI Presence Score:** 28/100
    - **Main Problem:** Invisible to AI for category queries
    - **Root Cause:** Generic entity positioning, zero structured data, no blog
    
    ### The Findings
    | Signal | Score | Finding |
    |--------|-------|---------|
    | AI Presence | 28/100 | Only appears when name is searched; never for category or use-case queries |
    | Entity Clarity | ❌ FAIL | ChatGPT describes as "software company" instead of "customer data platform" |
    | Content Signals | MISSING | 0 blog posts, no research, no citable data |
    | Schema | 0/3 | No structured data markup |
    | Third-Party | WEAK | LinkedIn only; no G2, no press mentions |
    
    ### After 30-Day Implementation
    **Score improved: 28 → 62/100 (+34 points)**
    
    What they did:
    1. Added Organization + Product schema (Day 1)
    2. Published 3 cornerstone pieces on "customer data" use cases (Week 1-2)
    3. Added FAQ schema and structured content summaries (Week 2)
    4. Got 2 guest mentions on industry sites (Week 3)
    5. Created G2 listing with 5 reviews (Week 3)
    
    **Result:** Now appears in AI answers for "customer data platform" and "CDP for B2B" — previously invisible.
    
    ---
    
    ## Example 2: B2B Content Agency (Moderate Signal, Brand Confusion)
    
    ### Before Audit
    - **Overall AI Presence Score:** 52/100
    - **Main Problem:** AI recognizes you but can't differentiate you
    - **Root Cause:** Entity clarity (too generic), competitive market, weak original research
    
    ### The Findings
    | Signal | Score | Finding |
    |--------|-------|---------|
    | AI Presence | 52/100 | Mentioned alongside 20 other agencies; no differentiation |
    | Entity Clarity | MUDDY | ChatGPT says "content marketing agency" (vague) instead of "B2B SaaS content specialists" (specific) |
    | Content Signals | WEAK | 47 blog posts but 90% are generic tips; few answer real customer questions |
    | Schema | 1/3 | Organization schema present; missing Product and Article |
    | Third-Party | WEAK | Listed on 3 directories; no case studies on client sites |
    
    ### After 30-Day Implementation
    **Score improved: 52 → 71/100 (+19 points)**
    
    What they did:
    1. Rewrote homepage: "B2B SaaS Content That Converts" (more specific ICP + outcome)
    2. Audited blog: Removed 12 generic posts; kept only high-value, original research pieces
    3. Published case study: "How we 3x'd pipeline for a $2M SaaS startup" (real metrics, real client)
    4. Added Article schema to all blog posts
    5. Pitched guest article to 2 industry publications (got accepted to 1)
    
    **Result:** Now shows up in AI answers for "B2B SaaS content strategy" — differentiated from generic agencies. Started getting inbound from qualified leads mentioning the specific case study.
    
    ---
    
    ## Example 3: Developer Tools Platform (High Signal, Competitive Pressure)
    
    ### Before Audit
    - **Overall AI Presence Score:** 78/100
    - **Main Problem:** Strong position but losing ground to faster-moving competitors
    - **Root Cause:** Maintaining presence, not growing it; gaps in emerging use cases
    
    ### The Findings
    | Signal | Score | Finding |
    |--------|-------|---------|
    | AI Presence | 78/100 | Strong for core category; weak for newer use cases (AI agents, automation) |
    | Entity Clarity | ✅ PASS | "Developer tools platform for API integrations" — clear |
    | Content Signals | STRONG | 120+ blog posts; 40% answer specific developer questions |
    | Schema | 3/3 | Organization, Product, Article all present and valid |
    | Third-Party | STRONG | G2 (4.8★), Capterra (4.6★), 15+ industry directory listings, 3 case studies on client sites |
    
    ### Strategic Opportunity
    They're already winning. The audit found **emerging gaps**:
    - AI mentions them 15% less for "AI agent integration" vs core platform queries
    - Competitors gaining ground on newer keywords: "LLM integration," "autonomous workflow"
    - Zero content bridging developer tools + AI agents
    
    ### After 90-Day Strategic Push
    **Score maintained at 78, but differential against competitors increased (+12 relative points)**
    
    What they did:
    1. Published series: "Developer Tools for AI Agents" (3 in-depth guides)
    2. Added new FAQ schema targeting "AI workflow automation" questions
    3. Featured AI agent integrations prominently on product page
    4. Secured guest post on major AI newsletter (100K subscribers)
    5. Updated schema to highlight AI-related capabilities
    
    **Result:** Now shows up alongside OpenAI, Anthropic partnerships when AI developers search for "tools for building agents." Previously invisible in that conversation.
    
    ---
    
    ## Pattern Recognition Across Examples
    
    ### Low Performers (Score 0-40)
    - Missing entity clarity (AI doesn't know what you do)
    - Zero schema markup
    - No structured content
    - Exist only on their own website
    
    **Typical Fix Timeline:** 30 days
    **Key Actions:** Homepage clarity + schema + 1 strong piece + external mentions
    
    ### Mid Performers (Score 40-70)
    - Identity is recognized but generic
    - Some content exists but not strategic
    - Partial schema (usually Organization only)
    - Limited external signals
    
    **Typical Fix Timeline:** 60 days
    **Key Actions:** Reposition for specificity + audit content strategy + add full schema + build external signals
    
    ### High Performers (Score 70+)
    - Clear identity, strong signals
    - Regular, high-quality content
    - Full schema implementation
    - Multiple external validation signals
    
    **Typical Fix Timeline:** Ongoing
    **Key Actions:** Monitor competitive positioning + stay ahead of emerging keywords + maintain content momentum
    
    ---
    
    ## Timing & Realistic Expectations
    
    **When to expect movement:**
    - **Week 1:** Schema markup changes can be crawled within 3-7 days
    - **Week 2-3:** Homepage/positioning changes visible in next AI knowledge updates (2-4 week lag)
    - **Week 4+:** New content and external mentions take 4-8 weeks to show measurable improvement
    
    **This is NOT instant.** AI systems don't update real-time like Google. Expect 30-90 days for meaningful score movement.
    
    ---
    
    ## Next Audit (Quarterly)
    
    Each example came back 90 days later to re-audit:
    - Low performer: Continued climbing (62 → 68 → 75 over 6 months)
    - Mid performer: Stabilized at 71, then dipped to 68 when new competitors appeared (re-prioritized differentiation)
    - High performer: Stayed ahead of competition but had to evolve keyword strategy as market shifted to AI agents
    
    **Cadence:** Run quarterly (every 90 days). Track what works, discard what doesn't.
    
  • ai-discoverability-audit/AI-DISCOVERABILITY-WORKSHEET.md4.7 KB99314c811c55upstream ↗
    # AI Discoverability Audit Worksheet
    
    > Track your visibility across AI platforms. Run quarterly.
    
    ---
    
    ## 📋 Audit Info
    
    | Field | Value |
    |-------|-------|
    | **Brand/Company** | |
    | **Website** | |
    | **Audit Date** | |
    | **Auditor** | |
    | **Previous Audit** | _(date or "First audit")_ |
    
    ---
    
    ## 🎯 Core Queries to Test
    
    _List 5-10 questions your ideal customers ask that should lead to you:_
    
    | # | Query | Your Expected Relevance |
    |---|-------|------------------------|
    | 1 | | High / Medium / Low |
    | 2 | | High / Medium / Low |
    | 3 | | High / Medium / Low |
    | 4 | | High / Medium / Low |
    | 5 | | High / Medium / Low |
    | 6 | | High / Medium / Low |
    | 7 | | High / Medium / Low |
    | 8 | | High / Medium / Low |
    
    ---
    
    ## 🤖 Platform Audits
    
    ### ChatGPT (GPT-4 / GPT-4o)
    
    | Query | Mentioned? | Position | Sentiment | Notes |
    |-------|------------|----------|-----------|-------|
    | Query 1 | ✅ Yes / ❌ No | 1st / 2nd / 3rd+ / Not listed | Positive / Neutral / Negative | |
    | Query 2 | ✅ / ❌ | | | |
    | Query 3 | ✅ / ❌ | | | |
    | Query 4 | ✅ / ❌ | | | |
    | Query 5 | ✅ / ❌ | | | |
    
    **ChatGPT Summary:**
    - Times mentioned: ___ / ___
    - Average position: ___
    - Overall sentiment: ___
    
    ---
    
    ### Perplexity AI
    
    | Query | Cited? | Source URL Shown? | Position | Notes |
    |-------|--------|-------------------|----------|-------|
    | Query 1 | ✅ / ❌ | ✅ / ❌ | | |
    | Query 2 | ✅ / ❌ | ✅ / ❌ | | |
    | Query 3 | ✅ / ❌ | ✅ / ❌ | | |
    | Query 4 | ✅ / ❌ | ✅ / ❌ | | |
    | Query 5 | ✅ / ❌ | ✅ / ❌ | | |
    
    **Perplexity Summary:**
    - Times cited: ___ / ___
    - Direct links shown: ___ / ___
    
    ---
    
    ### Claude (Anthropic)
    
    | Query | Mentioned? | Position | Sentiment | Notes |
    |-------|------------|----------|-----------|-------|
    | Query 1 | ✅ / ❌ | | | |
    | Query 2 | ✅ / ❌ | | | |
    | Query 3 | ✅ / ❌ | | | |
    | Query 4 | ✅ / ❌ | | | |
    | Query 5 | ✅ / ❌ | | | |
    
    **Claude Summary:**
    - Times mentioned: ___ / ___
    - Overall sentiment: ___
    
    ---
    
    ### Google AI Overviews (SGE)
    
    | Query | In AI Overview? | Your Position | Competitor Mentioned? | Notes |
    |-------|-----------------|---------------|----------------------|-------|
    | Query 1 | ✅ / ❌ | | | |
    | Query 2 | ✅ / ❌ | | | |
    | Query 3 | ✅ / ❌ | | | |
    | Query 4 | ✅ / ❌ | | | |
    | Query 5 | ✅ / ❌ | | | |
    
    **Google AI Overview Summary:**
    - Featured: ___ / ___
    - Competitors appearing instead: ___
    
    ---
    
    ## 🏆 Competitor Comparison
    
    _Who shows up when you don't?_
    
    | Competitor | ChatGPT | Perplexity | Claude | Google AI |
    |------------|---------|------------|--------|-----------|
    | | ___ / 5 | ___ / 5 | ___ / 5 | ___ / 5 |
    | | ___ / 5 | ___ / 5 | ___ / 5 | ___ / 5 |
    | | ___ / 5 | ___ / 5 | ___ / 5 | ___ / 5 |
    | **YOU** | ___ / 5 | ___ / 5 | ___ / 5 | ___ / 5 |
    
    ---
    
    ## 📊 Scorecard
    
    | Platform | Visibility Score | Grade |
    |----------|-----------------|-------|
    | ChatGPT | ___ / 10 | A / B / C / D / F |
    | Perplexity | ___ / 10 | A / B / C / D / F |
    | Claude | ___ / 10 | A / B / C / D / F |
    | Google AI | ___ / 10 | A / B / C / D / F |
    | **OVERALL** | ___ / 40 | |
    
    ### Grading Scale
    - **A (8-10):** Consistently mentioned, positive sentiment, good positioning
    - **B (6-7):** Sometimes mentioned, neutral-positive sentiment
    - **C (4-5):** Rarely mentioned, or only for limited queries
    - **D (2-3):** Almost never mentioned, competitors dominate
    - **F (0-1):** Invisible — AI doesn't know you exist
    
    ---
    
    ## 🔍 Gap Analysis
    
    ### Where You're Strong
    _Queries/platforms where you show up consistently:_
    
    1. 
    2. 
    3. 
    
    ### Where You're Weak
    _Queries/platforms where competitors beat you:_
    
    1. 
    2. 
    3. 
    
    ### Quick Wins
    _Low-effort fixes that could improve visibility:_
    
    1. 
    2. 
    3. 
    
    ---
    
    ## 📝 Content Gaps Identified
    
    _Topics you should create content for based on this audit:_
    
    | Topic/Query | Content Type | Priority | Status |
    |-------------|--------------|----------|--------|
    | | Blog / Video / Tool / FAQ | High / Med / Low | To Do |
    | | | | |
    | | | | |
    | | | | |
    | | | | |
    
    ---
    
    ## ✅ Action Items
    
    | Action | Owner | Due Date | Status |
    |--------|-------|----------|--------|
    | | | | ⬜ Not started |
    | | | | ⬜ Not started |
    | | | | ⬜ Not started |
    | | | | ⬜ Not started |
    | | | | ⬜ Not started |
    
    ---
    
    ## 📈 Progress Tracking
    
    _Compare scores across audits:_
    
    | Date | ChatGPT | Perplexity | Claude | Google AI | Total |
    |------|---------|------------|--------|-----------|-------|
    | | /10 | /10 | /10 | /10 | /40 |
    | | /10 | /10 | /10 | /10 | /40 |
    | | /10 | /10 | /10 | /10 | /40 |
    
    ---
    
    ## 💡 Notes & Observations
    
    _Anything interesting you noticed during this audit:_
    
    
    
    
    ---
    
    _Audit worksheet from AI Discoverability Audit by Brian Wagner_
    _https://github.com/BrianRWagner/ai-marketing-claude-code-skills_
    

Plain-text copy, no login: /skill-bundles/brianrwagner-ai-marketing-claude-code-skills-ai-discoverability-audit.md

// REPO STATS

454 stars