What is seo-architecture?

A guide for mapping how pages on a website connect through links and navigation. It shows how users and approved search crawlers discover important pages, including pages that may be hard to reach or isolated.

Use it to review menus, internal links, page hubs, breadcrumbs, pagination, filters, URL patterns, templates, and coverage of topics or entities across a site.

It helps uncover orphan pages, excessive click depth, weak navigation, and gaps between website content and the searches it should serve. It requires a captured map of pages and links instead of relying on guesses.

seo-architecture — Skill for Claude Code and Codex by oegeyilmaz9

Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code

/plugin marketplace add oegeyilmaz9/seo-aeo-geo-ultimate

Claude Code

/plugin install seo-aeo-geo-ultimate

Made for: Claude Code, Codex.

Or install seo-aeo-geo-ultimate, the plugin that ships this one along with the rest of its 27 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture/github.svg)](https://agentmods.dev/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture)

Your own site

<a href="https://agentmods.dev/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture"><img src="https://agentmods.dev/badge/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture"><img src="https://agentmods.dev/badge/skills/oegeyilmaz9/seo-aeo-geo-ultimate/seo-architecture.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 71 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 687 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00071	$0.00687
Opus 5	$0.00036	$0.00344
Sonnet 5	$0.00014	$0.00137
Haiku 4.5	$0.00007	$0.00069

Measured 12d ago against content hash 9cbaecd24438, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

seo-architecture scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/seo-architecture/SKILL.md · 31 lines

How it starts

The opening of the file, as written. The whole thing — 31 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SEO Architecture

Create and audit a bounded site-graph.json that explains how users and permitted crawlers discover important pages, how templates connect, and where query/entity coverage lives.

Read site-graph-protocol.md before a formal architecture audit.

Procedure

Define domain/subdomain scope, environments, URL patterns, crawl authorization, seed pages, locale, user tasks, business-critical templates, exclusions, and collection limits.
Capture nodes and crawlable link edges with source/target URLs, link location, anchor or accessible name, follow state, template/context classification, and observation time. A supported crawler CSV can be normalized with python "<suite-root>/scripts/import_seo_exports.py" crawler-csv ... using <suite-root>/docs/DATA-IMPORT-ADAPTERS.md, but that observation envelope is not a Site Graph: bind every node and edge to the raw captures and metadata required by the Site Graph contract.
Let <suite-root> mean ${CLAUDE_PLUGIN_ROOT} in Claude Code. In Codex, read .seo-suite-runtime.json beside this SKILL.md when present and use its suite_root value; otherwise use the absolute repository checkout. Validate the graph with python "<suite-root>/scripts/validate_site_graph.py" validate-graph <bundle>/site-graph.json --bundle <bundle>.
Inspect disconnected/orphan nodes, inbound-path evidence, hubs, crawl paths, pagination, facets, filters, parameter spaces, taxonomy, duplicate routes, canonical/index conflicts, and locale clusters.
Map the formal Query Corpus and entity/page ownership to nodes. Do not create a page or link merely because a keyword exists.
Propose the smallest user-meaningful navigation/contextual-link change. Avoid sitewide boilerplate links, manipulative anchors, hidden links, or arbitrary depth/count thresholds.
Route crawl/index defects to seo-technical, page/content ownership to seo-page/seo-content, programmatic templates to seo-programmatic, and authority work to seo-authority.
Package findings as SEO Findings 1.1.0 with site_graph, site, template, or web_page targets and architecture, technical, content, or international categories.

Read the full file on GitHub · 31 lines

Files

What ships with it

7 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

12d ago First seen · 31 lines · 71 tokens per session scan A 9cbaecd24438

Subscribe to this mod's changes

seo-architecture is a skill published in the GitHub repository oegeyilmaz9/seo-aeo-geo-ultimate (2 stars, last pushed 23d ago), licensed Apache-2.0. It adds 71 tokens to every session and 687 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Marketing and SEO aeo agent-skills ai-agents ai-search answer-engine-optimization anthropic

ansvisor-aeo-coach-standalone

Standalone (no-MCP) version of the Ansvisor AEO Coach. Use this only when the user's Claude client cannot connect to the Ansvisor MCP server (e.g. claude.ai web without a Connector configured). Fetches live data from the Ansvisor REST API directly with the user's API key via code execution. For clients that support…

ansvisor/ansvisor · 124 tokens

seo-vertical-detect

Classify a website as ecommerce, local-business, blog-publisher, saas, docs, or generic (multiple may apply), and report detected locales, from the persisted PageSnapshot plus the platform detector's vertical hints. Used by seo-orchestrator to decide which conditional modules to run and how to reweight the scores.

Hainrixz/claude-seo-ai · 71 tokens

ansvisor-aeo-coach

Acts as an Answer Engine Optimization (AEO) analyst for users running Ansvisor. Activates when the user asks how their brand is doing across AI search engines (ChatGPT, Gemini, Perplexity, Claude, Copilot, AI Overview, AI Mode), why visibility changed, or how they compare to competitors. Uses the Ansvisor MCP server…

ansvisor/ansvisor · 178 tokens

seo-fix-apply

Writer protocol preloaded into the seo-fixer-writer agent — how confirmed SEO/AI-search fixes are applied (git pre-flight, backup, Edit/Write for local diffs, ticketed adapter CLIs for remote targets, re-verify, publish only on a second ticket, rollback) and the findings-array output contract. Used only by the fix…

Hainrixz/claude-seo-ai · 91 tokens

audit

Audit a website or web codebase for SEO and AI-search (GEO/AEO) — produces two independent 0-100 scores (Search SEO + AI Visibility) plus a prioritized, evidence-backed report persisted on disk. Read-only; never writes to the project. Use when the user asks to audit, analyze, check, or score a site's SEO, structured…

Hainrixz/claude-seo-ai · 127 tokens

orangeo-ai-visibility-skill

Audit brand AI visibility readiness and prepare OranGEO-style GEO, AEO, LLM SEO, and AI search optimization action plans. Use when asked for a Claude Code skill, Codex skill, GEO skill, generative engine optimization skill, answer engine optimization skill, AI visibility audit, AI search visibility checker, llms.txt…

OranAi-Ltd/orangeo-ai-visibility-skill · 119 tokens