Url Structure
- 793 installs
- 787 repo stars
- Updated June 9, 2026
- kostja94/marketing-skills
url-structure is a marketing skill (version 1.1.0) that generates SEO-friendly URL hierarchies, fixes structural issues, and enforces clean readable permalinks across a developer's site.
About
url-structure is an SEO on-page skill from kostja94/marketing-skills at version 1.1.0. It triggers on terms like URL structure, slug, clean URLs, URL hierarchy, permalink structure, dynamic URLs, and URL parameters. The skill guides readability, hierarchy depth, and SEO best practices for path design. It defers per-page slug wording to url-slug-generator and canonical consolidation to canonical-tag. Developers reach for url-structure when migrating routes, auditing messy CMS paths, or planning IA before a site launch or major refactor.
- Analyzes site structure, categories, and current URL patterns
- Recommends optimal hierarchy, depth, and static URL formats
- Handles multi-language URL structures for zh/en deployments
- Distinguishes between URL structure planning and per-page slug generation
- References project-context.md automatically when present
Url Structure by the numbers
- 793 all-time installs (skills.sh)
- +5 installs in the week ending Jul 26, 2026 (Skillselion tracking)
- Ranked #564 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill url-structureAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 793 |
|---|---|
| repo stars | ★ 787 |
| Security audit | 3 / 3 scanners passed |
| Last updated | June 9, 2026 |
| Repository | kostja94/marketing-skills ↗ |
How do you design SEO-friendly URL structure?
Generate SEO-friendly URL hierarchies, fix structural issues, and ensure clean, readable permalinks across their site.
Who is it for?
Developers restructuring site routes or launching a docs or marketing site who need crawlable, human-readable URL hierarchies.
Skip if: Teams needing only a single page slug rewrite should use url-slug-generator instead of full url-structure planning.
When should I use this skill?
The user mentions URL structure, URL hierarchy, slugs, permalinks, clean URLs, dynamic URLs, or URL parameters.
What you get
URL hierarchy plans, slug path recommendations, structural issue fixes, and permalink best-practice audit results.
- url hierarchy plan
- permalink recommendations
- structural seo audit
By the numbers
- Skill metadata version 1.1.0
Files
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 |
Hierarchy
| Pattern | Example | Use |
|---|---|---|
| Flat | /page-name | Simple sites |
| Category | /blog/post-name, /tools/tool-name | Content sites |
| Nested | /category/subcategory/page | Deep hierarchies (keep shallow) |
Multi-language
| Pattern | Example |
|---|---|
| Path prefix | /zh/page, /en/page |
| Subdomain | zh.example.com, en.example.com |
| ccTLD | example.cn, example.com |
Static vs Dynamic vs Pseudo-Static URLs
| Type | Example | Use |
|---|---|---|
| Static | /blog/seo-guide | Direct file; best SEO; content stable |
| Dynamic | /product?id=123 | Program-generated; avoid for indexable content |
| Pseudo-static | /blog/seo-guide (rewritten from .php) | Combines both; common in CMS |
| Rule | Prefer static or pseudo-static; if dynamic, keep params ≤2; use canonical-tag and robots-txt (Clean-param) |
File Extensions
- Omit
.html,.php,.aspx— keeps URLs technology-agnostic, shorter, easier to refactor - Example:
/seo-guidenot/seo-guide.html
URL Parameter Handling
| Scenario | Approach |
|---|---|
| UTM / tracking | Canonical to base URL; params in query string only |
| Search results | Canonical to search page; avoid indexing result URLs |
| Filters / sort | Canonical to base; or robots-txt Clean-param |
| Session IDs | Use cookies; never in indexable URLs |
Use Cases
| Scenario | Focus |
|---|---|
| New site | Plan hierarchy upfront; avoid later restructuring |
| Migration | 301 mapping; canonical; see canonical-tag |
| Large site | Dynamic URLs, params, multi-language — canonical + robots |
| SEO audit | Check structure, params, canonical consistency |
Common Issues
| Issue | Fix |
|---|---|
| Long URLs | Shorten; remove redundant words |
| Dynamic params | Use canonical; clean params in robots (Yandex Clean-param) |
| Mixed case | Redirect to lowercase |
| Changed URLs | 301 redirect old to new |
Output Format
- URL structure recommendation
- Slug conventions
- Hierarchy for key content types
- Redirect plan if changing URLs
- References: Alignify URL optimization; Google URL guidelines
Related Skills
- website-structure: Plan structure and URL paths; apply url-structure rules after structure is defined
- canonical-tag: HTTPS, www, trailing slash — handles duplicate URL variants
- url-slug-generator: Slug creation for content pages; length, keywords, format
- category-page-generator: E-commerce category URL hierarchy, faceted URLs
- products-page-generator: Product URL hierarchy
- services-page-generator: Service URL hierarchy
- robots-txt: Clean-param for query params
- internal-links: URL structure affects link patterns
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67How it compares
Use url-structure for site-wide hierarchy planning; use url-slug-generator for individual page slug copy and canonical-tag for duplicate URL consolidation.
FAQ
What SEO issues does url-structure address?
url-structure addresses URL readability, hierarchy depth, dynamic URL patterns, and permalink best practices. Version 1.1.0 guides developers optimizing path structure; per-page slug wording defers to url-slug-generator.
Which related skills pair with url-structure?
url-structure pairs with url-slug-generator for individual slug wording and canonical-tag for consolidating duplicate URLs. Together they cover hierarchy planning, slug copy, and canonical SEO.
Is Url Structure safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.