BrianRWagner/ai-marketing-claude-code-skills / ai-discoverability-audit
ai-discoverability-audit
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| AI-DISCOVERABILITY-WORKSHEET.md | markdown | 4.7 KB |
| README.md | markdown | 1.3 KB |
| SKILL.md | skill md | 23.8 KB |
| references/examples.md | markdown | 6.4 KB |
| scripts/audit-prep.mjs | script | 5.4 KB |
references/examples.md
View on GitHub# 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |