К основному содержанию
скилл CX Codex

site-architecture · fcakyon — скилл для Claude Code и Codex

Скилл site-architecture для Claude Code и Codex, который помогает спланировать или перестроить структуру сайта: иерархию страниц, навигацию, URL-паттерны, хлебные крошки и внутренние ссылки.

MIT ★ 1 216 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install seo-skills@claude-settings
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/site-architecture/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/site-architecture/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

site-architecture coreyhaines31 Скилл site-architecture для Claude Code помогает планировать иерархию страниц, URL-структуру, навигацию и внутренние ссылки при создании или переструктурировании сайта. CX Codex +1 135 700установок site-architecture Alireza Rezvani Скилл site-architecture для Claude Code проверяет структуру сайта, URL, навигацию и внутренние ссылки. Разбирает структурные задачи аудита, редизайна и SEO. CX Codex +1 623установок site-architecture alinaqi Скилл site-architecture настраивает техническое SEO сайта: файлы robots.txt, XML-карты, метатеги и индексацию страниц поисковиками и поисковыми ИИ-ботами. CX Codex +1 342установок site-crawlability kostja94 Скилл site-crawlability для технического SEO: чинит редирект-цепочки, битые ссылки, страницы-сироты и подсказывает, как отдавать контент краулерам. CX Codex +1 1 200установок site-structure-optimizer aaron-he-zhu Скилл site-structure-optimizer планирует структуру сайта и разбирает внутренние ссылки: иерархия страниц, URL, хабы, страницы-сироты. Выдаёт оценку структуры из 100. CX Codex +1 1 500установок pillar-content-architecture rampstackco Скилл pillar-content-architecture для Claude Code проектирует контент-хабы: выбирает pillar-темы, планирует кластеры и выстраивает перелинковку и URL-структуру. Помогает структурировать контент, когда отдельные статьи не ранжируются. CX Codex +1 333установок url-link-extractor davila7 Субагент url-link-extractor сканирует проект и собирает полный каталог ссылок: от внутренних маршрутов и ассетов до внешних URL и API-эндпоинтов. Пригодится при миграциях доменов, аудитах безопасности и SEO. CX Codex 799установок website-structure kostja94 Скилл website-structure помогает решить, какие страницы строить и в каком порядке, для нового или уже существующего сайта. CX Codex +1 1 400установок navigation-patterns Owl-Listener Скилл navigation-patterns помогает подобрать схемы переходов между разделами интерфейса: от таббаров до боковых панелей. Полезен при проектировании мобильных и десктопных экранов. CX Codex +1 2 300установок

Из того же набора113

Весь набор →
ultralytics-platform Скилл ultralytics-platform для Claude Code помогает управлять ресурсами Ultralytics Platform, обучать модели и запускать hosted inference. Подключается к запросам об отправке моделей и датасетов, облачном обучении и развёртывании endpoint. CX Codex +1 ★ 1 216звёзд репо ultralytics-branding Скилл ultralytics-branding загружает правила фирменного стиля Ultralytics: цвета, шрифты, правила логотипа и тон для PDF, презентаций, документов, email-рассылок и соцсетей. CX Codex +1 ★ 1 216звёзд репо email-design Скилл email-design для Claude Code и Codex помогает оформлять транзакционные письма приложений. Настраивает вёрстку подтверждений почты, сброса паролей и счетов под стиль продукта. CX Codex +1 ★ 1 216звёзд репо commit-creator Субагент commit-creator разбирает подготовленные к коммиту изменения, предлагает логичное разбиение и создаёт коммиты с понятными сообщениями. Работает с Claude Code и Codex. CX Codex ★ 1 216звёзд репо derive-client Скилл derive-client записывает сетевой трафик сайта через браузер в HAR-файл и генерирует автономный API-клиент или CLI без повторного запуска браузера. CX Codex +1 ★ 1 216звёзд репо polar-local-environment Скилл polar-local-environment помогает запускать и обслуживать локальное окружение Polar через dev docker. Он пригодится для отладки сервисов и работы с несколькими изолированными worktree. CX Codex +1 ★ 1 216звёзд репо yolo-training Скилл yolo-training диагностирует графики обучения YOLO26 и results.csv, объясняет переобучение и низкий mAP, подсказывает, какой параметр менять. CX Codex +1 ★ 1 216звёзд репо supabase-cli Скилл учит агента управлять проектами через Supabase CLI: поднимать локальный стек, писать миграции, тестировать edge functions и генерировать типы TypeScript. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой