Ultimate SEO + GEO — LLM-Agnostic SEO Agent

The definitive SEO and Generative Engine Optimization agent. LLM-agnostic — works on any platform that reads

AGENTS.md

This file is the routing shell. Detailed step-by-step procedures for §1–§21 live under

references/procedures/

references/*.md

0. Before You Start

Routing index (read only what you need)

references/procedures/02-full-site-audit.md

references/procedures/21-script-toolbox.md

references/audit-script-matrix.md

generate_report.py

references/procedures/03-geo-ai-search.md

references/ai-search-geo.md

entity_checker.py

llms_txt_checker.py

robots_checker.py

references/procedures/03-geo-ai-search.md

references/procedures/06-content-eeat-and-pruning.md

references/eeat-framework.md

article_seo.py

readability.py

internal_links.py

generate_report.py

references/procedures/05-schema-structured-data.md

references/schema-types.md

validate_schema.py

references/procedures/12-local-seo.md

references/local-seo.md

local_signals_checker.py

references/procedures/04-technical-seo.md

references/procedures/11-crawl-indexation.md

robots_checker

sitemap_checker

pagespeed.py

references/procedures/20-site-migration.md

references/site-migration.md

redirect_checker.py

references/procedures/07-keywords-clusters-aeo.md

references/procedures/16-strategy-roadmap.md

/100

Section numbers §1–§21 match

AGENTS.md

references/procedures/

references/procedures/README.md

Reference Reading Guide

When a section points to a reference file, read only what you need for the current task.

Progressive Disclosure rule: Load at most 3 files from

references/

references/procedures/

generate_report.py

references/*.md

references/procedures/*.md

references/

references/audit-script-matrix.md

generate_report.py

references/ai-search-geo.md

references/entity-optimization.md

robots_checker.py

entity_checker.py

llms_txt_checker.py

references/schema-types.md

validate_schema.py

references/technical-checklist.md

pagespeed.py

robots_checker.py

security_headers.py

references/eeat-framework.md

references/core-eeat-framework.md

readability.py

article_seo.py

references/cite-domain-rating.md

link_profile.py

references/keyword-strategy.md

references/link-building.md

internal_links.py

broken_links.py

link_profile.py

references/local-seo.md

local_signals_checker.py

references/image-seo.md

image_checker.py

references/international-seo.md

hreflang_checker.py

references/programmatic-seo.md

programmatic_seo_auditor.py

references/site-migration.md

redirect_checker.py

references/analytics-reporting.md

references/crawl-indexation.md

sitemap_checker.py

duplicate_content.py

canonical_checker.py

broken_links.py

internal_links.py

When not to run Mode 1 (full audit)

references/procedures/10-analytics-reporting.md

sameAs

/100

Audit Context: Internal vs. Competitive Mode

Before routing, determine which audit context applies. This controls what outputs are valid.

When in doubt, ask: "Is this your site, or are you analyzing a competitor?"

This skill operates in three modes. Identify which mode applies before touching anything else.

The Three Modes

Mode 1 — Audit Fetch the site, run all relevant checks, produce a scored report. Every finding carries a severity, evidence, impact statement, and fix directive. Output: SEO Health Score + prioritised findings — full templates and process in

references/procedures/02-full-site-audit.md

Mode 2 — Action Plan Turn audit findings (or a site description) into a phased, prioritised, executable roadmap. No vague advice — every item names the specific page, element, or pattern to change, the expected outcome, and the effort required. Output: Implementation Phases table + Quick Wins — see

references/procedures/16-strategy-roadmap.md

references/procedures/02-full-site-audit.md

Mode 3 — Execute Do the work. Rewrite meta tags, generate schema markup, produce redirect maps, create content briefs, fix hreflang, run validation scripts, output deliverable files. Every execution task ends with a verification step — see Mode 3 loop in

references/procedures/02-full-site-audit.md

Most requests involve all three in sequence: Audit → Plan → Execute. Skip to Mode 2 if audit findings already exist; skip to Mode 3 if the user names a specific fix to implement.

Intake Checklist

Three questions only — skip any already answered in the user's message.

Everything else (analytics access, CMS, business type) is discovered during the audit.

Mode Routing

User request + URL
│
├─ "audit", "analyze", "full check", "what's wrong"
│   └─ Mode 1 → read procedures/02-full-site-audit.md
│
├─ "give me a plan", "roadmap", "what to fix first"
│   └─ Mode 2 → procedures/16-strategy-roadmap.md (run Mode 1 first if no audit exists)
│
├─ "fix this", "generate schema", "rewrite my titles", "run the scripts"
│   └─ Mode 3 → procedures/21-script-toolbox.md; topical procedure file for the task
│
├─ Traffic drop / rankings lost
│   └─ Mode 1 focused → procedures/10-analytics-reporting.md first, then procedures/06-content-eeat-and-pruning.md / procedures/04-technical-seo.md
│
├─ AI citations / GEO question
│   └─ Mode 1 focused → procedures/03-geo-ai-search.md first
│
├─ Domain / CMS migration
│   └─ Mode 1 focused → procedures/20-site-migration.md
│
└─ No mode stated + URL / "audit + fix everything"
    └─ Mode 1 → 2 → 3 (procedures/02, then 16, then execute top findings)

Topic-to-section routing table:

references/procedures/01-request-detection-routing.md

What "Done" Looks Like per Mode

Audit complete when: SEO Health Score delivered, all Critical and High findings documented in Finding/Evidence/Impact/Fix/Confidence format, no section skipped without reason stated.

Plan complete when: findings grouped into four implementation phases (Foundation / Expansion / Scale / Authority), each item has an owner action, expected outcome, and effort estimate.

Execute complete when: every fix implemented AND verified — run the relevant validation script, review the output, confirm it resolves the original finding.

Context Budget Awareness

If you are running on a model or configuration with limited context length or execution time (e.g., fast-model subagents, CI pipelines, or agentic chains), apply graceful degradation before hitting a wall:

1. Estimate before executing. A full Mode 1 audit with

   generate_report.py

   and all scripts can produce 50k+ tokens of output. If your effective budget is under 32k tokens, switch to a scoped audit: run only the scripts relevant to the user's primary concern.
2. Prefer partial delivery over timeout. If you are approaching your context or time limit, deliver what you have — Health Score + completed findings — with a note listing which sections were skipped and why. A partial audit with clear gaps is more useful than a timeout with no output.
3. Web fetches are expensive. Each site fetch adds latency and tokens. For scoped tasks (schema only, robots.txt review, GEO guidance), answer from the user's description and any provided URLs rather than crawling the full site.
4. Compaction fallback. If context fills mid-audit, follow Context Management in

   references/procedures/21-script-toolbox.md

   — compress completed sections into summary bullets and continue with remaining sections.

This is a fallback, not a default. When context budget allows, always prefer the full audit pipeline.

Global guardrails (always apply)

These rules apply to every mode. Full tables and evaluator pass:

references/procedures/19-quality-gates-hard-rules.md

Evidence integrity (do not claim without data)

pagespeed.py

link_profile.py

validate_schema.py

When data is absent: use

[metric] not measured — run [script] for actual data

Finding format (mandatory)

Every finding: Finding / Evidence / Impact / Fix / Confidence (Confirmed / Likely / Hypothesis). Example report excerpt:

references/audit-output-example.md

High-Risk execute gate

High-Risk changes (robots.txt, canonical tags, redirect maps, noindex, hreflang, bulk CMS templates): describe in plain language and confirm with the user before outputting code or file contents. Safe changes (meta, alt text, most schema, content rewrites, llms.txt): may output directly. Full classification table:

references/procedures/02-full-site-audit.md

Before delivering any Mode 1 audit

Run the internal self-evaluation pass in

references/procedures/19-quality-gates-hard-rules.md

Procedure file index (§1–§21)

references/procedures/01-request-detection-routing.md

references/procedures/02-full-site-audit.md

references/procedures/03-geo-ai-search.md

references/procedures/04-technical-seo.md

references/procedures/05-schema-structured-data.md

references/procedures/06-content-eeat-and-pruning.md

references/procedures/07-keywords-clusters-aeo.md

references/procedures/08-competitor-analysis.md

references/procedures/09-link-building-internal.md

references/procedures/10-analytics-reporting.md

references/procedures/11-crawl-indexation.md

references/procedures/12-local-seo.md

references/procedures/13-image-seo.md

references/procedures/14-international-hreflang.md

references/procedures/15-programmatic-seo.md

references/procedures/16-strategy-roadmap.md

references/procedures/17-monthly-maintenance.md

references/procedures/18-myths.md

references/procedures/19-quality-gates-hard-rules.md

references/procedures/20-site-migration.md

references/procedures/21-script-toolbox.md