ai-discoverability-audit — Claude Code skill for brand visibility
This skill checks how AI search describes a brand and whether it appears in category answers. Use it to spot gaps and plan what to fix.
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-codeWhat ai-discoverability-audit does
The skill gathers a company’s name, website, product or service, target customer, geography, and competitors. It then checks AI responses to questions about the brand, its category, and relevant expertise. The same queries can be run for the company and its competitors. When web access is unavailable, the user runs the supplied queries and shares the results with the agent.
The audit moves from an initial assessment to query testing and scores the brand across six dimensions, including recognition, accuracy, and competitive position. It then groups gaps by priority and proposes actions. Past audit results can be used to track changes. The comparison depends on having company details and competitor names ready; without them, the audit has less context for judging brand visibility.
What it helps with
- check how AI describes a company
- find factual errors or brand mix-ups
- see whether a brand appears in category answers
- compare a company’s AI presence with competitors
- turn audit findings into prioritized actions
Example prompts for the agent
- Audit how AI describes our company and product.
- Compare our brand with three competitors in category-related answers.
- Review our previous audit and create a plan for improving our AI visibility.
How to install ai-discoverability-audit
1Skills CLI (Vercel)
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-code2Manually: put the files in place
~/.claude/skills/ai-discoverability-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-discoverability-audit/
1Skills CLI (Vercel)
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a codex2Manually: put the files in place
.agents/skills/ai-discoverability-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a cursor2Manually: put the files in place
.cursor/skills/ai-discoverability-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install BrianRWagner/ai-marketing-claude-code-skills ai-discoverability-audit2Manually: put the files in place
.github/skills/ai-discoverability-audit/SKILL.md1Skills CLI (Vercel)
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/BrianRWagner/ai-marketing-claude-code-skills --path ai-discoverability-auditManually: put the files in place
.devin/skills/ai-discoverability-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-discoverability-audit
How do I install ai-discoverability-audit in Claude Code?
Run npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-code. The skill file is at ~/.claude/skills/ai-discoverability-audit/SKILL.md.
What does ai-discoverability-audit do?
It examines how AI systems describe a brand, whether they include it in category answers, and how it compares with competitors. The audit produces scores and a prioritized action plan.
What information do I need to run the audit?
Provide the company name and website, its product or service, target customer, geography, and three competitors. Earlier audit results can also be supplied for comparison.