Ultimate SEO + GEO — LLM-Agnostic SEO Agent

The definitive SEO and Generative Engine Optimization agent for AI coding tools. LLM-agnostic — works on any platform that reads AGENTS.md. Runs full site audits with scored findings, generates ready-to-deploy fixes, and optimizes content for both Google Search and AI search engines (Google AI Overviews, AI Mode, ChatGPT Search, Perplexity). Exports HTML and Excel reports.

Works with any AGENTS.md-compatible tool: Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, Windsurf, Cline, Aider, Devin, and more.

Author: Myk Pono · Lab · LinkedIn

---

What It Does

Give it a URL and it returns a scored audit, prioritized action plan, and executable fixes — not vague advice.

Three modes, one skill:

| Mode | What It Does | Output | |---|---|---| | Audit | Fetches site, runs all checks, scores findings | SEO Health Score (0–100) + prioritized findings | | Plan | Converts findings into phased roadmap | Implementation table with effort/impact/owner | | Execute | Produces the actual fixes + verifies them | JSON-LD, meta rewrites, redirect maps, robots.txt |

Most requests run all three in sequence. Skip to Mode 2 if you already have audit findings; skip to Mode 3 if you know exactly what to fix.

Who it’s for and what the bundled report does

Built for developers, founders, and marketers using AI coding agents who want scripted checks plus guided fixes. python scripts/generate_report.py <url> aggregates many diagnostics in one HTML/Excel export; by default several checks use the seed URL and modest crawl limits (not a full-site Screaming Frog–style crawl). For broader link and canonical coverage, use --crawl-deep (capped depth/pages; slower and more load on the target host). For JS-rendered sites or very large audits, optional extensions (Firecrawl, DataForSEO) are documented in references/optional-extensions-mcp.md. Setup: pip install -r requirements.txt (optional API keys for PageSpeed and extensions).

---

Coverage

SEO (21 Modules)

• Technical SEO — Core Web Vitals (LCP/INP/CLS), crawlability, indexability, JavaScript rendering, security headers, mobile-first
• On-Page SEO — Title tags, meta descriptions, H1s, URLs, canonicals
• Content & E-E-A-T — Content quality scoring, author credentials, experience signals, readability, thin content detection, content pruning/refresh
• Schema Markup — All active Schema.org types, deprecation-aware (HowTo, SpecialAnnouncement removed), JSON-LD generation and validation
• Keywords & Content Strategy — Keyword research, topic clusters, content gaps, funnel mapping (TOFU/MOFU/BOFU)
• Link Building — Internal link audit, orphan page detection, anchor text analysis, external link quality hierarchy
• Local SEO — Google Business Profile, NAP consistency, review strategy, LocalBusiness schema, citation building
• International SEO — Hreflang audit, language code validation, bidirectional return tags
• Programmatic SEO — Quality gates for pages at scale, thin content safeguards, template optimization
• Site Migrations — Pre/during/post migration checklists, redirect map validation, Change of Address tool
• Analytics & Reporting — GA4/GSC setup, traffic drop diagnostics, CTR benchmarks, monthly maintenance

GEO (AI Search Optimization)

• Platform Coverage — Google AI Overviews, Google AI Mode, ChatGPT Search, Perplexity, Bing Copilot
• Citability Scoring — Passage-level optimization (134–167 word answer blocks), answer placement in first 60 words
• Brand Mention Strategy — YouTube/Reddit/Wikipedia/LinkedIn correlation data, Wikidata entity setup
• AI Crawler Management — robots.txt configuration for GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot
• llms.txt — Template generation for the emerging AI content standard
• RSL 1.0 — Machine-readable AI licensing (December 2025 standard)

---

Platform Compatibility

| Platform | How It Loads Instructions | Script Execution | Setup | |---|---|---|---| | OpenAI Codex | AGENTS.md auto-loaded (32 KiB limit) | Full (shell access) | Clone repo, start coding | | Google Gemini CLI | GEMINI.md → imports AGENTS.md | Full (shell access) | Clone repo, start coding | | Claude Code | Plugin marketplace + SKILL.md | Full (shell access) | /plugin install (see below) | | Cursor IDE | AGENTS.md + .cursor/rules/ + skill auto-discovery | Full (shell access) | Clone repo or install skill | | GitHub Copilot | AGENTS.md + .github/copilot-instructions.md | Full (agent mode) | Clone repo, start coding | | Windsurf | AGENTS.md auto-loaded | Full (shell access) | Clone repo, start coding | | Cline | AGENTS.md auto-loaded | Full (shell access) | Clone repo, start coding | | Aider / Devin / Goose / Amp | AGENTS.md auto-loaded | Full (shell access) | Clone repo, start coding | | ChatGPT Custom GPT | Uploaded instructions + knowledge files | Limited (no scripts) | See chatgpt/README.md | | Claude Desktop (claude.ai) | Upload SKILL.md to Project Knowledge | No shell access | Manual upload |

AGENTS.md is the cross-tool standard (Linux Foundation, 20+ tools). One file covers all AGENTS.md-compatible platforms.

Installation

Any AGENTS.md-Compatible Tool (Codex, Gemini CLI, Copilot, Windsurf, Cline, Aider, etc.)

Clone the repo into your project or working directory. The tool auto-discovers AGENTS.md:

git clone https://github.com/mykpono/ultimate-seo-geo.git
cd ultimate-seo-geo
pip install -r requirements.txt

That's it. Open the folder in your tool and start asking for SEO audits.

Claude Code — Plugin Marketplace

Use Claude Code (the terminal-based Claude product). The lines below are slash commands you type in the Claude Code chat, not in macOS Terminal or zsh.

In Claude Code, run:

/plugin marketplace add mykpono/ultimate-seo-geo
/plugin install ultimate-seo-geo@ultimate-seo-geo

Or install directly without adding the marketplace first:

/plugin install https://github.com/mykpono/ultimate-seo-geo.git

Updating the plugin after a GitHub release

Claude Code caches the marketplace clone locally — it does not auto-pull new commits. Pick one approach:

Option A — Update the cache (fastest):

cd ~/.claude/plugins/marketplaces/ultimate-seo-geo && git pull

Then restart your Claude session (or run /reload-plugins in Claude Code).

Option B — Full reinstall:

/plugin uninstall ultimate-seo-geo
/plugin marketplace add mykpono/ultimate-seo-geo
/plugin install ultimate-seo-geo@ultimate-seo-geo

For maintainers — before pushing a release, verify plugin sync:

python3 scripts/check-plugin-sync.py

Claude Code — Manual skill install (global)

cp -r ultimate-seo-geo ~/.claude/skills/

Cursor IDE

Cursor reads AGENTS.md automatically from the repo root. For the full skill experience with progressive disclosure, install to the skills directory:

rsync -a --delete --exclude='.git/' --exclude='__pycache__/' --exclude='*.pyc' --exclude='.venv/' \
  /path/to/ultimate-seo-geo/ ~/.claude/skills/seo/

ChatGPT Custom GPT

ChatGPT Custom GPTs cannot read repo files — they need uploaded knowledge files. See chatgpt/README.md for step-by-step setup.

Claude Desktop App (claude.ai)

The Claude desktop app does not load skills from ~/.claude/skills/. Instead:

1. Open a Project in claude.ai
2. Go to Project Knowledge
3. Upload SKILL.md as a file, or paste its contents into custom instructions

---

Usage Examples

Full site audit:

"Audit mysite.com — we've seen a traffic drop over the past 3 months"

Schema generation:

"Generate the complete schema markup for my SaaS product page at app.example.com"

Local SEO:

"I run a plumbing company in Austin, TX. We're not showing up for 'plumber near me'. What's wrong?"

GEO optimization:

"How do I get cited by ChatGPT and Perplexity for our core product keywords?"

Site migration:

"We're moving from Magento to Shopify — 3,000 product pages. What do we need for SEO?"

---

Architecture

ultimate-seo-geo/
├── AGENTS.md             ← Universal entrypoint (24KB, under 32KB Codex limit)
│                           Auto-loaded by Codex, Gemini, Copilot, Windsurf, Cline, etc.
├── GEMINI.md             ← Gemini CLI entrypoint (imports AGENTS.md)
├── SKILL.md              ← Routing shell (~230 lines): §0, guardrails, procedure index
│
├── .github/
│   └── copilot-instructions.md  ← GitHub Copilot supplementary context
│
├── chatgpt/              ← ChatGPT Custom GPT bundle
│   ├── instructions.txt     Condensed instructions (under 8K chars)
│   ├── README.md            Setup guide
│   └── copy-knowledge-files.sh  Copies SKILL + references/ + references/procedures/
│
├── references/            ← Domain knowledge + procedures (load on demand)
│   ├── procedures/        ← Step-by-step §1–§21 (split from former monolithic SKILL.md)
│   ├── ai-search-geo.md     GEO signals, platform data, brand strategy
│   ├── technical-checklist.md  CWV fixes, JS SEO, IndexNow
│   ├── schema-types.md       All Schema.org types + templates
│   ├── eeat-framework.md     E-E-A-T scoring, spam categories
│   ├── core-eeat-framework.md  80-item CORE-EEAT content benchmark
│   ├── cite-domain-r