surfacedby/ai-visibility-optimizer-for-claude

3 stars · Last commit 2026-07-01

Honest GEO/AEO (AI search visibility) audit skill for Claude Code. Labels every finding deterministic vs estimate vs measured, uses the cited > named > considered > missing presence ladder, and refuses fabricated ROI and llms.txt snake oil.

README preview

# ai-visibility-optimizer

An honest GEO / AEO audit skill for Claude Code. It tells you how to show up in AI search (ChatGPT, Perplexity, Gemini, Google AI Mode, Claude), grounded in how the engines actually cite, and it is straight with you about what it can measure versus what it is only estimating.

Most GEO tools score your "AI visibility" without ever asking an AI engine anything. They infer a confident "ChatGPT: 18/100" from on-page signals, wrap it in a projected-ROI table, and call it a measurement. This skill does not do that. It separates what is deterministic (your robots.txt, your llms.txt, your page structure) from what is an estimate (likely citation readiness) from what is genuinely measured (which requires actually querying the engines), and it labels every number accordingly.

## What it does

- **Audit** a site's AI search readiness across the levers that actually move citations, with each finding tagged DETERMINISTIC, ESTIMATE, or MEASURED.
- **Citability**: assess whether a page answers questions in the self-contained, sourced, decision-stage way AI engines lift, judged semantically, not by a word-count regex.
- **Crawlers**: read robots.txt and flag the costly mistake of blocking the search-index bots (OAI-SearchBot, PerplexityBot, Googlebot, Bingbot) that actually gate citations, while training bots (GPTBot, ClaudeBot, Google-Extended) cost nothing for visibility.
- **llms.txt**: check it honestly. It is a nice-to-have, not a ranking lever; this skill says so instead of selling it.
- **Schema**: check structured data as a disambiguation and agentic-commerce aid, not as a magic citation booster.
- **Off-site**: map the evidence layer that actually drives brand citations (reviews, comparisons, roundups, forums, docs), since a brand's own domain is only a fraction of what gets cited.
- **Report**: produce a client-ready audit with an honest presence read and a prioritized action plan, and with no fabricated ROI and no outcome guarantees.

## How it is different

| Typical GEO tool | ai-visibility-optimizer |
|---|---|

View full repository on GitHub →