Jump to: Quick start · Other AI tools · What the auditor checks · How it fits together · FAQ · Credits
| Pillar | What it covers |
|---|
| SEO | Site and page audits, technical SEO, schema, sitemaps, hreflang, E-E-A-T, backlinks, local and maps |
| AEO (answer engines) | Answer-first writing, FAQs, featured-snippet structure, structured data |
| GEO (AI search) | AI crawler access, llms.txt, citability, brand mentions, ChatGPT / Perplexity / AI Overviews tuning |
| VEO (voice) | Spoken answers, voice search, local intent |
| Content and growth | Blog production from brief to fact-check, plus CRO, offers, pricing and editorial polish |
Quick start
1. Score any page in 10 seconds (no Claude needed)
npx seo-aeo-geo-kit audit https://your-site.com/page
You get a score out of 100 for SEO, AEO and GEO, a pass/fail list, and the top fixes. Add --summary for just the score and fixes.
2. Use the skills in Claude Code (recommended)
/plugin marketplace add alpit-patel/seo-aeo-geo-kit
/plugin install seo-aeo-geo-kit@seo-aeo-geo-kit
Using Codex, OpenCode or Antigravity instead? See Works with Claude Code, Codex, OpenCode, Antigravity and more. Then ask in plain language: "audit this page for SEO, AEO and GEO", "write a blog post on X and fact-check it", or "check whether AI crawlers can read my site".
3. Or copy just the skills you want
npx seo-aeo-geo-kit install --only seo,geo # into ./.claude/skills
npx seo-aeo-geo-kit install --global # into ~/.claude/skills
npx seo-aeo-geo-kit list --family GEO
install copies skill folders only. The plugin also includes the helper scripts.
Works with Claude Code, Codex, OpenCode, Antigravity and more
All skills use the open Agent Skills format (SKILL.md folders), so they are not tied to one tool. One command installs them for your tool:
| Tool | Install | Where it goes |
|---|
| Claude Code (full kit) | /plugin marketplace add alpit-patel/seo-aeo-geo-kit then /plugin install seo-aeo-geo-kit@seo-aeo-geo-kit | managed by the plugin system |
| OpenAI Codex | npx seo-aeo-geo-kit install --target codex --global | ~/.codex/skills (project: .agents/skills) |
| OpenCode | npx seo-aeo-geo-kit install --target opencode --global | ~/.config/opencode/skills (project: .opencode/skills) |
| Google Antigravity | npx seo-aeo-geo-kit install --target antigravity --global | ~/.gemini/antigravity/skills (project: .agent/skills) |
| Any other Agent Skills tool | npx seo-aeo-geo-kit install --target agents --global | ~/.agents/skills (or use --dest <folder>) |
Drop --global to install into the current project instead. Run npx seo-aeo-geo-kit doctor to see which tools are on your machine. Restart your agent afterwards, then ask in plain language: "audit this page for SEO, AEO and GEO".
For tools other than Claude Code the installer makes each skill portable: it keeps only the standard frontmatter fields (author credits move into metadata, never dropped), installs the helper files next to the skills in a _seo-aeo-geo-kit folder, and points every helper-script path at it. Optional one-time setup for the Python helpers: python <skills-folder>/_seo-aeo-geo-kit/scripts/runtime.py setup.
Good to know
- The full plugin experience (sub-agents and slash commands such as
/seo audit) is Claude Code only. In other tools the same skills work when you ask in plain language, and the agent follows the steps itself.
- Tested for real: the Claude Code plugin install, and the portable output of every other target (valid format, no Claude-only variables, credits kept, helper runtime compiles and runs). I have not run these skills inside the Codex, OpenCode or Antigravity apps themselves. Install paths follow each tool's published conventions, so if one differs on your version, use
--dest <folder>.
How it fits together
Helper scripts (optional)
Many skills call Python helpers (page rendering, Google Search Console and GA4, PageSpeed, schema validation, and more). All 42 that the skills reference are bundled in scripts/, plus 11 standard-library blog helpers (render, preflight gates, prose lint, readability) that run with plain Python and need no setup. They run through a managed, sandboxed Python environment (Python 3.11 to 3.14), created the first time you run /seo setup inside Claude Code. Some use optional services such as Google or Moz and need your own keys. The kit works without them: skills fall back to manual checks.
What the auditor checks
25 deterministic checks: title, meta description, headings, canonical, mobile, image alt text, internal links and Open Graph (SEO); JSON-LD, FAQ markup, answer-first opening, lists and question headings (AEO); AI-crawler access in robots.txt, llms.txt, author and date, external citations, facts and entity schema (GEO).
It reports what is missing. It does not predict rankings, and nothing replaces real content quality.
FAQ
What is GEO?
Generative Engine Optimization: making your content easy for AI systems such as ChatGPT, Perplexity and Google AI Overviews to find, understand and cite.
What is AEO?
Answer Engine Optimization: structuring content so search features and assistants can lift a direct answer, such as featured snippets and voice answers.
Does it guarantee rankings?
No. Nobody can. It gives you a repeatable process and a checklist.
Do I need an API key?
No. The auditor and most skills need none. A few helper scripts use optional services (Google Search Console, GA4, DataForSEO). When a helper script is not bundled, the skills fall back to manual checks and say so.
Is my data sent anywhere?
The auditor only fetches the URL you give it, plus that site's robots.txt and llms.txt. The skills run inside your own agent (Claude Code, Codex, OpenCode or Antigravity) under your own settings.
Credits
Curated and maintained by Alpit Patel, who wrote the auditor, installer, validator and the routing and quality system. The kit also builds on MIT-licensed work by AgriciDaniel, Zubair Trabzada, Corey Haines, Siqi Chen, Guillaume Meyer, puneetindersingh and others. See THIRD_PARTY_NOTICES.md for the full list. Each skill keeps its original license file.
Contributing
See CONTRIBUTING.md. Before a pull request: npm test, npm run validate and claude plugin validate ..
License
MIT. See LICENSE and THIRD_PARTY_NOTICES.md.
