SEO Optimizer
ailabs-393/ai-labs-claude-skills
This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.
A skill your agent uses when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking.
Install Site Architecture
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install fcakyon/claude-codex-settings site-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .claude/skills/site-architecture && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .claude/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install fcakyon/claude-codex-settings site-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .agents/skills/site-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .agents/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install fcakyon/claude-codex-settings site-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .cursor/skills/site-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .cursor/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/fcakyon/claude-codex-settings.git --path plugins/seo-skills/skills/site-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install fcakyon/claude-codex-settings site-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .gemini/skills/site-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .gemini/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install fcakyon/claude-codex-settings site-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .github/skills/site-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .github/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add fcakyon/claude-codex-settings --skill site-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install fcakyon/claude-codex-settings site-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/seo-skills/skills/site-architecture .opencode/skills/site-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "site-architecture" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/seo-skills/skills/site-architecture into .opencode/skills/site-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "site-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
site-architecture- GitHub stars
- 1.2k
- Token cost
- ~1.3k tokens
- SKILL.md length
- 711 words
- Files
- 2 (incl. references)
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking.
- Restructuring what pages a site has and how they connect: hierarchy
- SKILL.md covers Depth, Site types as starting points, URLs and Navigation, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Internal linking
What it does
Site Architecture is an agent skill from fcakyon/claude-codex-settings. Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/patterns.md`).
It sits in Marketing & SEO, covering Technical SEO, On-page SEO and SEO audit. The repository describes itself as: Battle-tested Claude Code, OpenAI Codex, Cursor configs, plugins, hooks and agents with Kimi, MiniMax and GLM API support. The licence is MIT.
When your agent uses it
- Restructuring what pages a site has and how they connect: hierarchy
- Internal linking
Example prompts
- “/site-architecture”
What it can do on your machine
Read from SKILL.md and the folder at commit 7a519d8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
developers.google.comnngroup.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Site Architecture loads about 1.3k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 711 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from fcakyon/claude-codex-settings at commit 7a519d8, republished under its MIT licence (© fcakyon). 711 words, ~1,343 tokens.
Download SKILL.mdSave it as
.claude/skills/site-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- site-architecture
- description
- Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Not for XML sitemaps, which are in seo-audit.
- license
- MIT
Site architecture
Architecture is one decision repeated: how does someone get from the homepage to the page that answers their question, and how does a crawler follow the same path. Depth, navigation, URLs, and internal links are four views of that one structure, so change them together or they drift.
Depth
Aim to put any page that matters within three clicks of the homepage. It isn't a law, but a critical page four or more levels down is a symptom worth chasing.
| Shape | Fits | Costs |
|---|---|---|
| Flat, 2 levels | Small sites, portfolios | Stops scaling once a nav item has 20 children |
| Moderate, 3 levels | Most SaaS and content sites | Usually the right answer |
| Deep, 4 or more | Large catalogs, big docs | Scales, but buries things without strong linking |
Go as flat as the navigation tolerates. When a dropdown passes roughly 20 items, that's the signal to add a level rather than keep the list flat.
Levels: L0 is the homepage, L1 is a primary section (/features, /blog), L2 is a page within it (/features/analytics), L3 and beyond are detail pages (/docs/api/authentication).
Site types as starting points
| Type | Depth | Sections | URL shape |
|---|---|---|---|
| SaaS marketing | 2 to 3 | Home, Features, Pricing, Blog, Docs | /features/{name}, /blog/{slug} |
| Content site | 2 to 3 | Home, Blog, Categories, About | /blog/{slug}, /blog/category/{slug} |
| Ecommerce | 3 to 4 | Home, Categories, Products | /{category}/{subcategory}/{product} |
| Documentation | 3 to 4 | Home, Guides, Reference | /docs/{section}/{page} |
| SaaS plus content | 3 to 4 | Home, Product, Blog, Resources, Docs | /product/{feature}, /blog/{slug} |
| Small business | 1 to 2 | Home, Services, About, Contact | /services/{name} |
URLs
Readable, lowercase, hyphenated, mirroring the hierarchy, with one trailing-slash policy enforced everywhere. Short but still descriptive: /blog/landing-page-conversions beats /blog/how-to-improve-your-landing-page-conversion-rates.
The mistakes that cost the most:
- Dates in blog URLs.
/blog/2026/07/25/titleadds nothing and ages the post visibly. - IDs or query strings carrying content.
/product/12345and/blog?id=123should be slugs. - Over-nesting past what the hierarchy needs.
- Mixing parents for the same kind of page, like
/features/analyticsalongside/product/automation. - Changing a URL without a 301. Every old URL needs one, or the links pointing at it stop counting and anyone who bookmarked it gets a 404. This is the single most common cause of traffic loss after a redesign.
references/patterns.md has the URL pattern per page type, navigation layouts, and the diagram formats to hand back.
Navigation
Primary navigation holds 4 to 7 items, ordered by importance, with the logo linking home and the call to action rightmost. Past 7, people stop reading the list and start hunting.
Footers group into columns: product, resources, company, legal. Sidebars carry within-section navigation for docs and long content. Breadcrumbs mirror the URL path exactly, with every segment linked except the current page, and they pair with BreadcrumbList schema.
Breadcrumbs are the cheapest structural win available: they add internal links on every page, they make hierarchy legible to a crawler, and they can earn a richer result.
Show full SKILL.md (237 more words)Show less
Internal linking
- No orphans. Every page needs at least one internal link pointing at it, and the sitemap is not a link.
- Anchor text describes the destination. Never "click here" or "read more".
- How many contextual links a single page carries is a decision for whoever owns that page's format, so recommend the connections worth making rather than a density target.
- Link the pages that matter more often. Inbound internal links are how you tell a crawler what's important.
- Hub and spoke for content clusters: one comprehensive hub, spokes covering sub-topics, each spoke linking back to the hub, the hub linking to all spokes, and spokes cross-linking where a reader would actually want it.
Hub and spoke is what makes a set of posts add up to more than its pages, because it concentrates the signal on the hub rather than spreading it across a dozen equal posts competing with each other.
What to hand back
An ASCII tree of the hierarchy with the URL at each node, a URL map table (page, URL, parent, where it appears in navigation, priority), the redirect list when anything moves, and a Mermaid diagram when the structure is worth seeing rather than reading. references/patterns.md has the formats.
Sources
- Google Search Central, URL structure best practices: https://developers.google.com/search/docs/crawling-indexing/url-structure
- Google Search Central, Redirects and Google Search: https://developers.google.com/search/docs/crawling-indexing/301-redirects
- Google Search Central, Breadcrumb structured data: https://developers.google.com/search/docs/appearance/structured-data/breadcrumb
- Nielsen Norman Group, Flat vs deep website hierarchies: https://www.nngroup.com/articles/flat-vs-deep-hierarchy/
© fcakyon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in plugins/seo-skills/skills/site-architecture of fcakyon/claude-codex-settings.
- SKILL.md
- references/patterns.md
Open the folder on GitHubat commit 7a519d8
Compare with similar skills
Site Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Site Architecture this skillfcakyon/claude-codex-settings | 1.2k | — | ~1.3k | Automated safety check: Pass | MIT | |
| SEO Optimizerailabs-393/ai-labs-claude-skills | 454 | 1 repos | ~3.2k | Automated safety check: Pass | MIT | |
| SEO Drift MonitorAgriciDaniel/claude-seo | 19k | 1 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Universal SEO AnalysisAgriciDaniel/claude-seo | 19k | — | ~4.9k | Automated safety check: Pass | MIT | |
| E2E SEO Assistantirinabuht12-oss/marketing-skills | 4k | — | ~1.9k | Automated safety check: Pass | None | |
| SEO Auditandrew-yangy/gru-ai | 155 | — | ~731 | Automated safety check: Pass | MIT |
Similar skills
SEO Drift Monitor
AgriciDaniel/claude-seo
Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.
Universal SEO Analysis
AgriciDaniel/claude-seo
Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.
E2E SEO Assistant
irinabuht12-oss/marketing-skills
Full SEO workflow covering technical audits, content gaps, backlink opportunities, on-page fixes, and content briefs.
SEO Audit
andrew-yangy/gru-ai
Full website SEO audit with parallel subagent delegation. An agent skill from andrew-yangy/gru-ai.
Geo Meta Tags Audit
thedaviddias/Front-End-Checklist
Audits and fixes geo.region, geo.placename and geo.position meta tags on regional pages, noting where they help (Bing) and where they do not (Google).
More from fcakyon/claude-codex-settings
All 44 skills in this repoSlides
fcakyon/claude-codex-settings
Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.
Dokploy Deploy
fcakyon/claude-codex-settings
This skill should be used when user asks to "deploy with Dokploy", "use Dokploy Cloud", "manage self-hosted Dokploy", "deploy Docker Compose on Dokploy", "manage Dokploy databases", "configure…
Openobserve API
fcakyon/claude-codex-settings
This skill should be used when user asks to "query OpenObserve", "create OpenObserve dashboard", "edit OpenObserve panel", "fetch OpenObserve logs", "run OpenObserve search", "list OpenObserve…
Openship Config
fcakyon/claude-codex-settings
This skill should be used when the user asks to "create openship.json", "configure an OpenShip deployment", "make a repo deployable on OpenShip", or fix "openship config validate" errors.
Python Guidelines
fcakyon/claude-codex-settings
This skill should be used when writing, reviewing, or refactoring Python code.
Hetzner Deploy
fcakyon/claude-codex-settings
This skill should be used when user asks to "deploy to Hetzner", "create Hetzner server", "manage Hetzner Cloud", "hcloud CLI", or works with Hetzner Cloud infrastructure including servers…
Related
Categories
Questions about Site Architecture
What does Site Architecture do?
A skill your agent uses when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking. Site Architecture is an agent skill from fcakyon/claude-codex-settings. Use when planning or restructuring what pages a site has and how they connect: hierarchy, navigation, URL patterns, breadcrumbs, and internal linking.
When should I use Site Architecture?
Site Architecture fits situations like: restructuring what pages a site has and how they connect: hierarchy; internal linking.
How do I install Site Architecture in Claude Code?
Run `npx skills add fcakyon/claude-codex-settings --skill site-architecture -a claude-code`. Or copy the skill folder (plugins/seo-skills/skills/site-architecture in fcakyon/claude-codex-settings) into .claude/skills/site-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Site Architecture in Codex?
Run `npx skills add fcakyon/claude-codex-settings --skill site-architecture -a codex`. Or copy the skill folder (plugins/seo-skills/skills/site-architecture in fcakyon/claude-codex-settings) into .agents/skills/site-architecture in your project. Codex loads it when a task matches its description.
Can I use Site Architecture in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fcakyon/claude-codex-settings --skill site-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/site-architecture, .gemini/skills/site-architecture, .github/skills/site-architecture and .opencode/skills/site-architecture in your project.
What does Site Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Site Architecture is instructions for the agent only.
Does Site Architecture access the network?
SKILL.md names 2 domains. As links in the text: developers.google.com and nngroup.com. This is read from the text; nothing was executed.
Is Site Architecture safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Site Architecture use?
Site Architecture is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Site Architecture use?
About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.
What are the alternatives to Site Architecture?
Skills that share tags, products or a category with Site Architecture: SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars), SEO Drift Monitor (AgriciDaniel/claude-seo, 19k stars), Universal SEO Analysis (AgriciDaniel/claude-seo, 19k stars) and E2E SEO Assistant (irinabuht12-oss/marketing-skills, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Site Architecture?
fcakyon (a GitHub user) maintains it in fcakyon/claude-codex-settings, which has 1,171 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 8, 2026.
Source: fcakyon/claude-codex-settings on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.