본문으로 건너뛰기
cccskills
무료GitHub에 공개

site-architecture

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.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(2)

  • SKILL.md5.2 KB
  • references/patterns.md5.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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.

ShapeFitsCosts
Flat, 2 levelsSmall sites, portfoliosStops scaling once a nav item has 20 children
Moderate, 3 levelsMost SaaS and content sitesUsually the right answer
Deep, 4 or moreLarge catalogs, big docsScales, 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

TypeDepthSectionsURL shape
SaaS marketing2 to 3Home, Features, Pricing, Blog, Docs/features/{name}, /blog/{slug}
Content site2 to 3Home, Blog, Categories, About/blog/{slug}, /blog/category/{slug}
Ecommerce3 to 4Home, Categories, Products/{category}/{subcategory}/{product}
Documentation3 to 4Home, Guides, Reference/docs/{section}/{page}
SaaS plus content3 to 4Home, Product, Blog, Resources, Docs/product/{feature}, /blog/{slug}
Small business1 to 2Home, 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 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.

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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

This skill should be used when the user asks for "ADHD output", "fewer output tokens", "short numbered steps", "limited working memory formatting", or explicitly invokes "adhd-output-style".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

Agent-browser usage guide. Read this before running any agent-browser commands. Covers the snapshot-and-ref workflow, navigating pages, interacting with elements (click, fill, type, select), extracting text and data, taking screenshots, managing tabs, handling forms and auth, waiting for content, running multiple browser sessions in parallel, and troubleshooting common failures. Use when the user asks to interact with a website, fill a form, click something, extract data, take a screenshot, log into a site, test a web app, or automate any browser task.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

Build, debug, or review Cloudflare Agents SDK applications using the agents package.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

This skill should be used when user asks to "query Azure resources", "list storage accounts", "manage Key Vault secrets", "work with Cosmos DB", "check AKS clusters", "use Azure MCP", or interact with any Azure service.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

basin

무료

Build and troubleshoot Cloudflare Basin analytics workflows with Basin Pipelines, Basin Catalog, and Basin SQL. Use for streaming data into R2 Iceberg tables, managing catalogs, or querying those tables; also use for requests using the former Data Platform, Pipelines, R2 Data Catalog, or R2 SQL names.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

fcakyon/claude-codex-settings1.2천2026년 10월 20일 업데이트

fcakyon의 스킬 모두 보기

이 스킬의 문제 신고