Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GEO Audit — a Claude skill

Audit any website's GEO (Generative Engine Optimization) and get a scored report with copy-paste fixes — so AI answer engines (ChatGPT, Claude, Perplexity, Google AI Overviews / AI Mode, Gemini) actually cite your site.

Search is moving from "rank #1, get the click" to "be the source the AI quotes." Google AI Overviews just rolled out in France (it's been live in the US for months): fewer clicks, more AI citations. This Claude skill checks whether your site is ready to be cited — and tells you exactly what to fix.

Built from real-world experience optimizing production sites, by @minosdevs.


🇬🇧 English

What it does

You give it a URL. Claude fetches the raw signals, scores your site against an 8-part checklist, and writes a GEO-REPORT.md with a grade, evidence, and prioritized copy-paste fixes.

It checks:

  1. AI crawler access — does robots.txt welcome GPTBot, ClaudeBot, PerplexityBot, Google-Extended… or silently block them?
  2. Structured data (JSON-LD) — Organization, WebSite, Product/App, Article, FAQPage, BreadcrumbList.
  3. llms.txt — the AI-native summary file engines read first.
  4. Metadata / canonical / hreflang — titles, descriptions, multilingual signals, Open Graph.
  5. Answer-first & citable content — is the answer quotable and up top?
  6. Crawlability & rendering — is your content in the raw HTML, or hidden behind JS?
  7. Entity clarity & E-E-A-T — who you are, sources, authorship.
  8. Performance & mobile.

Install

git clone https://github.com/minosdevs/geo-audit ~/.claude/skills/geo-audit

That's it. Any Claude Code session will now discover the skill.

Use

Just ask, in plain language:

Audit the GEO of https://mysite.com

Claude runs the skill and drops a GEO-REPORT.md in your folder. To also apply the fixes, say so:

Now apply the quick-win fixes.

🇫🇷 Français

Ce que ça fait

Tu donnes une URL. Claude récupère les signaux bruts, note ton site sur une grille en 8 points, et écrit un GEO-REPORT.md avec une note, les preuves, et des correctifs prêts à copier-coller, classés par priorité.

Ce qu'il vérifie :

  1. Accès des crawlers IA — ton robots.txt accueille-t-il GPTBot, ClaudeBot, PerplexityBot, Google-Extended… ou les bloque-t-il sans que tu le saches ?
  2. Données structurées (JSON-LD) — Organization, WebSite, Product/App, Article, FAQPage, BreadcrumbList.
  3. llms.txt — le fichier résumé que les moteurs IA lisent en premier.
  4. Métadonnées / canonical / hreflang — titres, descriptions, signaux multilingues, Open Graph.
  5. Contenu « réponse d'abord » et citable — la réponse est-elle nette et en haut de page ?
  6. Crawlabilité & rendu — ton contenu est-il dans le HTML brut, ou caché derrière du JS ?
  7. Clarté d'entité & E-E-A-T — qui tu es, tes sources, l'auteur.
  8. Performance & mobile.

Installation

git clone https://github.com/minosdevs/geo-audit ~/.claude/skills/geo-audit

C'est tout. N'importe quelle session Claude Code détecte le skill.

Utilisation

Demande simplement, en langage normal :

Audite le GEO de https://monsite.com

Claude lance le skill et dépose un GEO-REPORT.md dans ton dossier. Pour qu'il applique aussi les correctifs, dis-le :

Maintenant applique les quick-wins.

What's inside

geo-audit/
├── SKILL.md                     # the skill Claude follows
└── references/
    ├── checklist.md             # the 8-category scoring grid (weights → /100)
    ├── report-template.md       # the report format
    └── fixes.md                 # proven copy-paste fixes (Next.js + generic HTML)

Note

GEO is young and the engines change fast. This encodes what worked in practice, not a guarantee of citations. Treat the report as a prioritized to-do list, not gospel.

License

MIT — do whatever, no warranty. See LICENSE.

Made by @minosdevs. If it helps, a follow or a repost goes a long way.

About

Claude skill: audit any website's GEO (Generative Engine Optimization) and get a scored report + copy-paste fixes so AI answer engines cite your site.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors