Agent skill

AI Discoverability Audit

by BrianRWagner in BrianRWagner/ai-marketing-claude-code-skills

Audits how a brand is described by AI search tools such as ChatGPT, Perplexity and Gemini, then produces a scored report, action plan and re-audit schedule.

No licenceAuto-check passedMarketing & SEO

Install AI Discoverability Audit

skills CLI
$ npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BrianRWagner/ai-marketing-claude-code-skills ai-discoverability-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BrianRWagner/ai-marketing-claude-code-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ai-discoverability-audit .claude/skills/ai-discoverability-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ai-discoverability-audit
GitHub stars
440
Token cost
~2.3k tokens
SKILL.md length
889 words
Files
3 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
None found

At a glance

Audits how a brand is described by AI search tools such as ChatGPT, Perplexity and Gemini, then produces a scored report, action plan and re-audit schedule.

  • Works in 6 steps: Pre-Audit Analysis → Structured Query Testing → Structured Scoring → …
  • Checking whether ChatGPT or Perplexity describes your brand accurately
  • SKILL.md covers Mode, Context Loading Gates, Phase 1: Pre-Audit Analysis and Phase 2: Structured Query…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill tests how AI assistants understand, describe and recommend a brand, on the view that traditional SEO targets Google while AI discoverability depends on what language models say. It offers three modes: quick, with direct brand queries and the top three fixes; standard, the default, with all four phases, a scored report and a priority roadmap; and deep, which adds competitive benchmarking, a 90-day plan and an ongoing query list.

Before running queries it collects the company name and URL, product and category, target customer, geography, the top three competitors, any prior audit and the current positioning statement. If an earlier audit exists, the run becomes a comparison with a trend summary. A pre-audit analysis checks entity clarity, forms a baseline hypothesis, considers competitor representation and flags gaps against the intended positioning. A query bank is included as a reference file.

When your agent uses it

  • Checking whether ChatGPT or Perplexity describes your brand accurately
  • Benchmarking AI visibility against competitors
  • Planning content changes to improve how AI assistants recommend a brand
  • Re-auditing AI presence to compare with an earlier audit

Example prompts

  • “Audit how we show up in AI search; our site is acme-analytics.com and we sell BI tools to retailers.”
  • “Do a quick scan of what ChatGPT says about our brand.”
  • “Run a deep competitive AI discoverability audit against our top three rivals.”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Pre-Audit Analysis
  2. Structured Query Testing
  3. Structured Scoring
  4. Gap Analysis & Recommendations
  5. Self-Critique Pass (REQUIRED)
  6. Re-Audit Schedule (MANDATORY)

What it can do on your machine

Read from SKILL.md and the folder at commit f36b34f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

AI Discoverability Audit loads about 2.3k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 889 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 889 words (~2,277 tokens).

“You are an AI discoverability expert. Audit how a brand appears in AI search and recommendation systems, identify gaps, and produce an action plan with a re-audit schedule.”

— opening of SKILL.md by BrianRWagner
name
ai-discoverability-audit

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in ai-discoverability-audit of BrianRWagner/ai-marketing-claude-code-skills.

  • SKILL.md
  • SKILL-OC.md
  • references/query-bank.md

Open the folder on GitHubat commit f36b34f

Compare with similar skills

AI Discoverability Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

AI Discoverability Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Discoverability Audit this skillBrianRWagner/ai-marketing-claude-code-skills440—~2.3kAutomated safety check: PassNone
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
GEO Platform Optimizerzubair-trabzada/geo-seo-claude11k2 repos~4.7kAutomated safety check: NotesMIT
Orangeo AI Visibility SkillOranAi-Ltd/orangeo-ai-visibility-skill139—~1.5kAutomated safety check: PassMIT
SEO Auditshadcn-labs/agentcn490—~598Automated safety check: PassMIT
Global SEO Growthminhnv0807/ai-business-skills610—~5kAutomated safety check: PassMIT

Similar skills

  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • GEO Platform Optimizer

    zubair-trabzada/geo-seo-claude

    Audits a site for AI search visibility one platform at a time, scoring Google AI Overviews, ChatGPT, Perplexity, Gemini and Bing Copilot and listing gaps to fix.

    11k GitHub starsUsed in 2 repos~4.7k tokens
    Marketing & SEOAuto-check: notes
  • Orangeo AI Visibility Skill

    OranAi-Ltd/orangeo-ai-visibility-skill

    Audit brand AI visibility readiness and prepare OranGEO-style GEO, AEO, LLM SEO, and AI search optimization action plans.

    139 GitHub stars~1.5k tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    shadcn-labs/agentcn

    How to present the deterministic AI-SEO audit returned by auditpage.

    490 GitHub stars~598 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Global SEO Growth

    minhnv0807/ai-business-skills

    Covers six SEO layers for a website: crawl and index audit, local SEO, search-intent content, AI search visibility, schema markup and backlink or directory distribution.

    610 GitHub stars~5k tokensUpdated 27 days ago
    Marketing & SEOAuto-check passed
  • GEO-Claw AI Visibility Agent

    LeoYeAI/openclaw-master-skills

    Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed

More from BrianRWagner/ai-marketing-claude-code-skills

All 23 skills in this repo
  • Reddit Insights

    BrianRWagner/ai-marketing-claude-code-skills

    Search and analyze Reddit content using semantic AI search via reddit-insights.com MCP server.

    440 GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Meeting Prep Brief

    BrianRWagner/ai-marketing-claude-code-skills

    Builds a pre-meeting brief from your Obsidian vault: participant research, past notes, open commitments, a prioritized agenda and sharp questions.

    440 GitHub stars~922 tokensUpdated 6 mo ago
    Auto-check passed
  • Case Study Builder

    BrianRWagner/ai-marketing-claude-code-skills

    Turns a client win into case studies, proposal blurbs, social proof quotes and sales stories, after collecting the details and at least one concrete number.

    440 GitHub stars~1.8k tokensUpdated 6 mo ago
    Auto-check passed
  • Cold Outreach Sequence Builder

    BrianRWagner/ai-marketing-claude-code-skills

    Builds researched LinkedIn and email outreach for prospects, from a single message to a multi-prospect system, with personalization graded by the signals found.

    440 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Content Idea Generator

    BrianRWagner/ai-marketing-claude-code-skills

    Produces content ideas for LinkedIn, X, newsletters or short video from your positioning statement, in quick, standard or deep planning modes.

    440 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Homepage Conversion Audit

    BrianRWagner/ai-marketing-claude-code-skills

    Audits a homepage or landing page for conversion in quick, standard or deep mode, scoring it by page type and ending with an impact-ranked action plan.

    440 GitHub stars~1.8k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about AI Discoverability Audit

What does AI Discoverability Audit do?

Audits how a brand is described by AI search tools such as ChatGPT, Perplexity and Gemini, then produces a scored report, action plan and re-audit schedule. The skill tests how AI assistants understand, describe and recommend a brand, on the view that traditional SEO targets Google while AI discoverability depends on what language models say. It offers three modes: quick, with direct brand queries and the top three fixes; standard, the default, with all four phases, a scored report and a priority roadmap; and deep, which adds competitive benchmarking, a 90-day plan and an ongoing query list.

When should I use AI Discoverability Audit?

AI Discoverability Audit fits situations like: checking whether ChatGPT or Perplexity describes your brand accurately; benchmarking AI visibility against competitors; planning content changes to improve how AI assistants recommend a brand; re-auditing AI presence to compare with an earlier 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`. Or copy the skill folder (ai-discoverability-audit in BrianRWagner/ai-marketing-claude-code-skills) into .claude/skills/ai-discoverability-audit in your project. Claude Code loads it when a task matches its description.

How do I install AI Discoverability Audit in Codex?

Run `npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a codex`. Or copy the skill folder (ai-discoverability-audit in BrianRWagner/ai-marketing-claude-code-skills) into .agents/skills/ai-discoverability-audit in your project. Codex loads it when a task matches its description.

Can I use AI Discoverability Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BrianRWagner/ai-marketing-claude-code-skills --skill ai-discoverability-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-discoverability-audit, .gemini/skills/ai-discoverability-audit, .github/skills/ai-discoverability-audit and .opencode/skills/ai-discoverability-audit in your project.

What does AI Discoverability Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: AI Discoverability Audit is instructions for the agent only.

Does AI Discoverability Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is AI Discoverability Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does AI Discoverability Audit use?

No licence was found for AI Discoverability Audit or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does AI Discoverability Audit use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1k tokens, read only when the agent opens those files.

What are the alternatives to AI Discoverability Audit?

Skills that share tags, products or a category with AI Discoverability Audit: GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars), GEO Platform Optimizer (zubair-trabzada/geo-seo-claude, 11k stars), Orangeo AI Visibility Skill (OranAi-Ltd/orangeo-ai-visibility-skill, 139 stars) and SEO Audit (shadcn-labs/agentcn, 490 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Discoverability Audit?

BrianRWagner (a GitHub user) maintains it in BrianRWagner/ai-marketing-claude-code-skills, which has 440 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on March 19, 2026.

Source: BrianRWagner/ai-marketing-claude-code-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.