First release of seoauditor, a read-only SEO and AI-visibility (GEO/AEO) audit skill for Claude Code (/seoauditor) and Codex ($seoauditor). It audits how a codebase makes its website discoverable to search engines and AI answer engines, writes a scored, prioritized, self-contained seoaudit.md, and prints the verdict in chat.
Scores 12 dimensions (10 always-on + 2 conditional, weights sum to 100)
Crawlability and Indexation Control (14%), Rendering and Content-in-HTML (13%), On-Page Content / Headings / Semantic HTML (12%), Canonicalization and Duplicate Content (11%), Structured Data and Rich Results (10%), AI and Generative-Engine Visibility / GEO-AEO (9%), URL Architecture and Technical Configuration (8%), Performance and Core Web Vitals code signals (6%), Social and Sharing Metadata (5%), Analytics / Verification / SEO Observability (3%), plus conditional Internationalization and hreflang (5%) and Feeds / Syndication / Installability / Fast-Indexing (4%).
What makes it different
- Verifies against what actually reaches the crawler, not the markup's intent.
- Hunts paper controls and separates inert theater (remove) from actively harmful controls (fix).
- Ownership map scores each cross-lens defect exactly once.
- Visibility floor caps the grade on sitewide deindexing, CSR-invisibility to no-JS AI crawlers, cloaking, canonical collapse, or self-defeating AI blocks.
- Dual mandate: classic search and AI answer engines, with the training-vs-citation crawler distinction and an honest, aspirational treatment of llms.txt / ai.txt.
- Read-only: never crawls the live site, runs Lighthouse, calls Search Console / the Rich Results Test, or calls a model.
Install
Claude Code: copy skills/seoauditor/SKILL.md to ~/.claude/skills/seoauditor/SKILL.md, or install the repo as a plugin (ships .claude-plugin/plugin.json). Codex: copy to ~/.codex/skills/seoauditor/SKILL.md. See the README for details.
The attached seoauditor-0.1.0.tar.gz is the packaged plugin (README, LICENSE, CHANGELOG, plugin manifest, and the skill).
🤖 Generated with Claude Code