site-architecture · fcakyon — скилл для Claude Code и Codex
Скилл site-architecture для Claude Code и Codex, который помогает спланировать или перестроить структуру сайта: иерархию страниц, навигацию, URL-паттерны, хлебные крошки и внутренние ссылки.
MIT ★ 1 216 обновлён 2026-11-09
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install seo-skills@claude-settingsЧто делает site-architecture
Скилл задаёт единую рамку: глубина иерархии, URL-схема, навигация и внутренние ссылки — это четыре проекции одной структуры, поэтому менять их нужно вместе, иначе они расходятся.
Для каждого типа сайта — SaaS, контентный, интернет-магазин, документация, малый бизнес — скилл даёт отправную точку: рекомендуемую глубину (от 1–2 до 3–4 уровней), набор разделов и форму URL. Первичная навигация — 4–7 пунктов; когда выпадающий список перевалит за ~20 элементов, скилл сигнализирует, что пора добавить уровень. По URL: даты в адресах блога, числовые ID вместо слагов и смена URL без 301-редиректа — это три типичных сценария потери трафика после редизайна, и скилл прямо называет их ошибками.
В итоге агент возвращает ASCII-дерево иерархии с URL на каждом узле, таблицу URL-map (страница, URL, родитель, место в навигации, приоритет), список редиректов при переезде и Mermaid-диаграмму — форматы лежат в references/patterns.md. Страницы без входящих внутренних ссылок скилл считает сиротами: ситкарта за ссылку не считается.
Какие задачи решает
- Спланировать иерархию страниц нового SaaS-сайта с нуля
- Перестроить URL-схему после редизайна и составить список 301-редиректов
- Расставить хлебные крошки с разметкой
BreadcrumbList - Выстроить кластер контента по модели «хаб и спицы»
- Найти страницы без входящих внутренних ссылок и устранить их
Примеры запросов агенту
- Спланируй структуру сайта для SaaS-продукта: разделы, URL-паттерны и первичную навигацию
- Аудит иерархии: найди страницы глубже трёх кликов от главной и предложи, как их поднять
- Составь список 301-редиректов для страниц, у которых меняются URL после редизайна
Как установить site-architecture
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install seo-skills@claude-settingsКоманда ставит плагин seo-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill site-architecture -a claude-code3Вручную: положить файлы
~/.claude/skills/site-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/site-architecture/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill site-architecture -a codex2Вручную: положить файлы
.agents/skills/site-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill site-architecture -a cursor2Вручную: положить файлы
.cursor/skills/site-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/seo-skills/skills/site-architecture2Вручную: положить файлы
.github/skills/site-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill site-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/seo-skills/skills/site-architectureВручную: положить файлы
.devin/skills/site-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о site-architecture
Как установить site-architecture в Claude Code?
Два шага: сначала /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install seo-skills@claude-settings. После этого скилл доступен по пути ~/.claude/skills/site-architecture/SKILL.md.
Что делает скилл site-architecture?
Он помогает агенту проектировать и перестраивать структуру сайта: задаёт глубину иерархии, URL-паттерны, схему навигации, правила хлебных крошек и внутренней перелинковки. На выходе — ASCII-дерево, таблица URL-map, список редиректов и при необходимости Mermaid-диаграмма.
Чем site-architecture отличается от seo-audit?
site-architecture — про структуру страниц: иерархию, навигацию, URL и внутренние ссылки. XML-карты сайта из него выведены намеренно — они лежат в скилле seo-audit.
Исходный текст
SKILL.md · MIT
---
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/title` adds nothing and ages the post visibly.
- IDs or query strings carrying content. `/product/12345` and `/blog?id=123` should be slugs.
- Over-nesting past what the hierarchy needs.
- Mixing parents for the same kind of page, like `/features/analytics` alongside `/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 follow the path a typical user takes to the page, which Google recommends over mirroring the URL, 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.
## 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.
## Checks from live audits
- Fragment routes: Google [generally ignores URL fragments](https://developers.google.com/search/docs/crawling-indexing/url-structure), so client-side routes like `/#/pricing` need real paths through the History API.
- Breadcrumb results: Google shows them [on desktop only](https://developers.google.com/search/docs/appearance/structured-data/breadcrumb), so don't expect them in mobile results.
## 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 · fcakyon/claude-codex-settings
Похожие скиллы
Все скиллы по теме «SEO и GEO» →Сначала — site-architecture от других авторов.