# ai-discoverability-audit

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 449
- Author: BrianRWagner
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/HEAD/ai-discoverability-audit/SKILL.md
- Updated: 2026-03-19
- HTML: https://affpapa.org/en/nevibecode/skills/ai-discoverability-audit

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ai-discoverability-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ai-discoverability-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ai-discoverability-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ai-discoverability-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install BrianRWagner/ai-marketing-claude-code-skills ai-discoverability-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/ai-discoverability-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/BrianRWagner/ai-marketing-claude-code-skills --path ai-discoverability-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ai-discoverability-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/HEAD/ai-discoverability-audit/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [seo-audit](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — skill · 238500 installs
- [brand](https://affpapa.org/en/nevibecode/skills/brand.md) — skill · 40500 installs
- [banner-design](https://affpapa.org/en/nevibecode/skills/banner-design.md) — skill · 40000 installs
- [marketing-psychology](https://affpapa.org/en/nevibecode/skills/coreyhaines31-marketing-psychology.md) — skill · 165300 installs
- [content-strategy](https://affpapa.org/en/nevibecode/skills/coreyhaines31-content-strategy.md) — skill · 164700 installs
- [ai-seo](https://affpapa.org/en/nevibecode/skills/ai-seo.md) — skill · 151500 installs

From the same set: [brianrwagner/ai-marketing-claude-code-skills](https://affpapa.org/en/nevibecode/by/brianrwagner/ai-marketing-claude-code-skills.md) — 23 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md