geo-audit

Audits web projects for LLM and AI-agent discoverability across 17 GEO and AEO checks.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/MohamedSayedK/omnigrid --skill geo-audit-mohamedsayedk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo-audit
Source: https://github.com/MohamedSayedK/omnigrid/tree/main/assets/core/skills/geo-audit
Command: npx skills add https://github.com/MohamedSayedK/omnigrid --skill geo-audit-mohamedsayedk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web projects optimized only for Googlebot are invisible to LLM chatbots and coding agents that increasingly drive discovery. This Skill audits a site's readiness for generative engines (ChatGPT, Claude, Perplexity) and agentic coding tools, surfacing concrete gaps in discovery files, citation metadata, and token economics. ## Core Features & Use Cases - 17-check audit across 6 buckets: Discovery (llms.txt, AGENTS.md, AI-crawler robots.txt directives), capability-signaling (skill.md manifest), content-format (JSON-LD citation metadata, Q&A shape, heading hierarchy), token economics, analytics, and UX. - GEO vs AEO split: Findings are grouped so you can tell whether the generative-engine half or the agent-facing half needs work, without re-running anything. - Graded severity output: Each check reports PASS / WARN / FAIL with severity, ending in a readiness verdict table sent to chat only — no files written, no auto-fixes. - Use Case: Before a product launch, run the audit to discover that llms.txt is missing, JSON-LD lacks dateModified, and your API reference exceeds the 25K-token threshold — then fix the three high-severity items before declaring the docs LLM-ready. ## Quick Start Run a GEO and AEO audit on this web project and report which discovery files, citation metadata, and token-economics checks pass or fail.

Frequently Asked Questions about geo-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my website for LLM discoverability?▼

Run a GEO audit that checks for llms.txt and llms-full.txt files, AI-crawler directives in robots.txt, JSON-LD citation metadata, and snippet-extractable content structure. The audit reports PASS, WARN, or FAIL per check with severity ratings.

What is the difference between GEO and AEO optimization?▼

GEO (Generative Engine Optimization) targets LLM chatbots like ChatGPT and Perplexity citing your pages in answers. AEO (Agentic Engine Optimization) targets coding agents like Claude Code and Cursor preferring your docs over training data when writing code against your product.

What is llms.txt and do I need one?▼

llms.txt is a discovery file at your site root listing key URLs for LLM crawlers, with llms-full.txt as its companion. Missing llms.txt is a high-severity FAIL in GEO audits because it is the primary entry point for AI discovery.

Does geo-audit work on backend API projects?▼

No. The skill is gated to web projects with a public content surface such as pages, docs directories, or web-framework markers like Next.js or Astro. Backend-only APIs report PASS immediately since there is nothing for LLM crawlers to index.

How are page token counts estimated for LLM readiness?▼

Token counts are estimated as character count divided by 4, a cross-vendor heuristic. Thresholds flag Quick Starts over 15K tokens, API references over 25K, and conceptual guides over 20K as failures, since oversized pages exceed practical LLM context budgets.

Does the audit automatically fix the issues it finds?▼

No. The audit only reports findings to chat with severity grades; it does not generate llms.txt, scaffold AGENTS.md, or split oversized pages. The operator decides which gaps to address.