url-structure

# SEO On-Page: URL Structure Guides URL structure optimization for SEO: readability, hierarchy, and best practices. **When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Scope (On-Page SEO) - **URL hierarchy**: Path structure, categories, depth - **URL format**: Static vs dynamic; omit file extensions - **URL slug**: See **url-slug-generator** for slug creation (3–5 words, under 60 chars) - **Duplicate variants**: See **canonical-tag** for HTTPS, www, trailing slash ## Initial Assessment **Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for site structure. Identify: 1. **Site structure**: Categories, subcategories, content types 2. **Current URLs**: Existing patterns and issues 3. **Multi-language**: URL structure for zh/en (e.g., /zh/, /en/ or subdomains) ## Best Practices ### URL Guidelines | Principle | Guideline | |-----------|-----------| | **Readable** | Use words, not IDs; `/blog/seo-guide` not `/p/12345` | | **Short** | Shorter is generally better; avoid unnecessary depth | | **Keyword** | Include target keyword when natural | | **Lowercase** | Use lowercase; avoid mixed case | | **Hyphens** | Use hyphens to separate words: `seo-guide` | | **Avoid** | Special chars, query params for core content, session IDs | #...