Julian lechnerandClaude Opus 5.5
c14101e60d
Keep the decision steps in SKILL.md and move catalogs, examples, and checklists verbatim to references/ to reduce the context cost of loading the skill. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.3 KiB
2.3 KiB
URL Structure
Design Principles
- Readable by humans —
/features/analyticsnot/f/a123 - Hyphens, not underscores —
/blog/seo-guidenot/blog/seo_guide - Reflect the hierarchy — URL path should match site structure
- Consistent trailing slash policy — pick one (with or without) and enforce it
- Lowercase always —
/Aboutshould redirect to/about - Short but descriptive —
/blog/how-to-improve-landing-page-conversion-ratesis too long;/blog/landing-page-conversionsis better
URL Patterns by Page Type
| Page Type | Pattern | Example |
|---|---|---|
| Homepage | / |
example.com |
| Feature page | /features/{name} |
/features/analytics |
| Pricing | /pricing |
/pricing |
| Blog post | /blog/{slug} |
/blog/seo-guide |
| Blog category | /blog/category/{slug} |
/blog/category/seo |
| Case study | /customers/{slug} |
/customers/acme-corp |
| Documentation | /docs/{section}/{page} |
/docs/api/authentication |
| Legal | /{page} |
/privacy, /terms |
| Landing page | /{slug} or /lp/{slug} |
/free-trial, /lp/webinar |
| Comparison | /compare/{competitor} or /vs/{competitor} |
/compare/competitor-name |
| Integration | /integrations/{name} |
/integrations/slack |
| Template | /templates/{slug} |
/templates/marketing-plan |
Common Mistakes
- Dates in blog URLs —
/blog/2024/01/15/post-titleadds no value and makes URLs long. Use/blog/post-title. - Over-nesting —
/products/category/subcategory/item/detailis too deep. Flatten where possible. - Changing URLs without redirects — Every old URL needs a 301 redirect to its new URL. Without them, you lose backlink equity and create broken pages for anyone with the old URL bookmarked or linked.
- IDs in URLs —
/product/12345is not human-readable. Use slugs. - Query parameters for content —
/blog?id=123should be/blog/post-title. - Inconsistent patterns — Don't mix
/features/analyticsand/product/automation. Pick one parent.
Breadcrumb-URL Alignment
The breadcrumb trail should mirror the URL path:
| URL | Breadcrumb |
|---|---|
/features/analytics |
Home > Features > Analytics |
/blog/seo-guide |
Home > Blog > SEO Guide |
/docs/api/auth |
Home > Docs > API > Authentication |