- name
SKILL.md
Beceri dosyası yayıncının deposunda kalır.
Kopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a cursor -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-code -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a codex -yKopyalanan komutu bir terminale yapıştırın. Bu SKILL.md dosyasını ilgili ajana kurar.
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a grok -yKopyalanan mesajı bir Grok Bot sohbetinde gönderin. Bot bu SKILL.md dosyasını GitHub'dan alır ve tüm Bot'larınızın paylaştığı becerilere ekler.
Install this skill: https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/HEAD/ai-discoverability-auditYayıncıdan
Author: Brian Wagner (@BrianRWagner)
Category: Marketing / AI SEO
"Find out if AI can find you — and fix it before your competitors do."
Detect from context or ask: "Quick scan, full Signal Audit, or deep competitive analysis?"
Default: standard — use quick for a fast read. Use deep if this is a re-audit or you need competitive benchmarking included.
Platform: Claude Code
File system: Available. Read prior outputs before starting. Save all outputs to the paths specified in Memory Protocol.
Cross-skill dependencies:
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:
[Prior Score] → [New Score] = [Delta]Cross-session rule: Never treat a re-audit as a cold start. The delta is the value — show what moved.
Route findings to other skills based on scores:
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.
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.
✅ 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
❌ Traditional Google SEO rankings
❌ Content writing or copywriting
❌ Social media performance
Before starting, gather:
Query your brand in 5 AI search scenarios. Simulate real user queries:
Scoring:
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."
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:
Score:
If muddy, identify exactly what's causing the confusion and recommend the fix (homepage clarity, about page rewrite, directory cleanup).
Does your brand publish content AI systems can extract and cite?
Check:
Score:
Identify specific gaps: "Your blog has 12 posts but none answer the top 5 questions your ICP asks AI. Here are those questions: [list]"
Does your site use schema markup that helps AI systems understand who you are?
Key schemas to check:
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:
Provide specific implementation recommendations. If schemas are missing, provide these ready-to-use templates:
Organization Schema (add to homepage <head>):
{
"@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):
{
"@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):
{
"@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.
AI systems trust external sources. Are there signals outside your website that validate your brand?
Check for:
Score:
Identify the highest-impact validation signals to pursue.
Based on gaps found in Sections 1-5, create a prioritized action plan:
Week 1: Foundation (Quick Wins)
Week 2: Content Signal
Week 3: Distribution
Week 4: Re-Audit
Recommended cadence: Run this full audit quarterly. AI systems update their knowledge bases constantly — what worked in Q1 may need adjustment by Q2.
# 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*
Here's a complete audit for a fictional SaaS company:
Audited: February 21, 2026 | Framework: Signal Audit v2
Competitor Benchmark:
Gap: You're invisible for category queries. AI only finds you when users already know your name.
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."
Gap: Your blog talks about your product. AI needs content that answers questions your ICP asks.
Top 5 questions Shopify brand owners ask AI:
You have zero content ranking for these. That's your content roadmap.
Fix: Add Product schema to pricing page. Add FAQ schema to homepage and feature pages. Add Article schema to all blog posts.
Gap: Clearpath exists almost entirely on its own website. AI has no external signals to validate your authority.
Built with the Signal System by Brian Wagner — AI Marketing Architect
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?
Identify the lowest-scoring section. Run a second-pass diagnosis:
Expand the Signal Fix plan with:
Query the competitor name in AI systems. Compare:
Save this audit as baseline. Note:
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.
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.
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.
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.
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.
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.
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.
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.
This skill includes scripts/audit-prep.mjs — run it before starting the audit to validate inputs, check for prior audits, and generate context:
node scripts/audit-prep.mjs --brand "Acme Corp" --url "https://acme.com" --icp "SaaS founders"
Output:
See references/examples.md for 3 complete before/after audits:
© 2026 Brian Wagner. Free in the AI Marketing Skills library: github.com/BrianRWagner/ai-marketing-claude-code-skills
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
---name: ai-discoverability-auditdescription: Use when a founder, marketer, or consultant wants to audit how visible their brand is to AI search (ChatGPT…---# ai-discoverability-audit/SKILL.mdGenel bakış
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.
SSS
ai-discoverability-audit/SKILL.md dosyasını yayıncıdan indirin veya yolu kopyalayıp depoyu açın. PlugMCP beceriyi listeler, dosyayı barındırmaz.
Yayıncı bunu şurada tutuyor: https://github.com/BrianRWagner/ai-marketing-claude-code-skills.
Claude, Cursor, Codex ve Grok Build, yayıncının deposundan eklediğiniz bir SKILL.md dosyasını okuyabilir. Grok Bot, becerinin GitHub klasör bağlantısını bir sohbette gönderdiğinizde onu kurar.