Components: URL Slug
Guides creation of SEO-friendly URL slugs for blog posts, articles, and content pages. Research on 11.8M Google results shows shorter URLs tend to rank higher; position #1 URLs average 50–60 characters.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Scope
- URL slug: The path segment after the base (e.g.,
ai-people-search in /blog/ai-people-search)
- Applies to: Blog posts, articles, guides, category pages, product pages
Best Practices
Length
| Guideline |
Target |
| Slug length |
Under 60 characters total (including path prefix) |
| Word count |
3–5 words |
| Principle |
Shorter = easier to read, share, remember; less truncation in SERPs; see serp-features |
Example: "The Complete Guide to AI Search Engine for Finding People" → ai-people-search (3 words) or ai-search-finding-people (4 words), not ai-search-engine-finding-people-speed-discovery-outreach (9 words, 51 chars).
Format
| Rule |
Do |
Avoid |
| Separators |
Hyphens (-) |
Underscores (_), spaces, periods |
| Case |
Lowercase only |
Mixed case (causes duplicate content) |
| Characters |
Letters (a-z), numbers (0-9), hyphens |
Special chars |
| Stop words |
Remove when possible: the, a, and, or, to |
Keep when needed: "how-to" |
Content
| Rule |
Guideline |
| Primary keyword |
Include near start; one focus per URL |
| Descriptive |
Clear what page is about from slug alone |
| No keyword stuffing |
One keyword mention is enough |
| No dates |
Omit unless time-specific (news, annual roundups) |
Non-ASCII Characters
| Scenario |
Rule |
| Accented letters |
Convert to ASCII: é→e, ü→u, ñ→n, ç→c |
| Non-Latin scripts |
Use UTF-8 percent-encoding if required; prefer ASCII for compatibility |
| Example |
jalapeno not jalapeño; cafe not café |
Common Mistakes
- Copy-pasting full title: Summarize instead — long title → short slug
- Auto-generated IDs:
/post/12847 — always customize
- Tracking params in slug: UTM, session IDs — use query params separately
- Changing without redirect: Always 301 from old to new slug
Slug Generation Workflow
- Extract primary keyword from title or target keyword
- Summarize in 3–5 words (don't copy full title)
- Remove stop words (the, a, and, or) unless needed for readability
- Lowercase, hyphenate, validate length < 60 chars
- Check uniqueness — no duplicate slugs site-wide
Examples
| Title / Topic |
❌ Too long |
✅ Recommended |
| AI Search Engine for Finding People: Speed vs. Discovery |
ai-search-engine-finding-people-speed-discovery-outreach |
ai-people-search or ai-search-finding-people |
| The Ultimate SEO Checklist for 2025 |
the-ultimate-seo-checklist-for-2025 |
seo-checklist-2025 |
| How to Increase Website Traffic |
how-to-increase-the-traffic-to-your-website |
increase-website-traffic |
| Best Running Shoes for Marathon Training |
best-running-shoes-for-marathon-training-in-2025 |
best-running-shoes-2025 |
Output Format
When creating or auditing a slug:
Recommended slug (3–5 words)
Character count (slug only)
Primary keyword included
Alternatives if multiple valid options
Reference: Alignify URL optimization
Related Skills
- url-structure: URL hierarchy, site structure; references this skill for slug conventions
- canonical-tag: When changing slugs, set up 301 redirects
- article-page-generator: Article URL slugs
- blog-page-generator: Blog post URL slugs
- glossary-page-generator: Glossary term slugs
- products-page-generator: Product page slugs
- customer-stories-page-generator: Case study page slugs
- resources-page-generator: Resource page slugs
- features-page-generator: Per-feature page slugs
1---2name: url-slug-generator3description: When the user wants to create, optimize, or validate URL slugs for content pages. Also use when the user mentions "URL slug," "URL path," "blog URL," "article URL," "short URL," "clean slug," "permalink," "slug optimization," "URL structure," "SEO-friendly URL," "create URL slug," or "SEO slug." For site-wide URL policy, use url-structure.4---5
6# Components: URL Slug
7
8Guides creation of SEO-friendly URL slugs for blog posts, articles, and content pages. Research on 11.8M Google results shows shorter URLs tend to rank higher; position #1 URLs average 50–60 characters.
9
10**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
11
12## Scope
13
14- **URL slug**: The path segment after the base (e.g., `ai-people-search` in `/blog/ai-people-search`)
15- **Applies to**: Blog posts, articles, guides, category pages, product pages
16
17## Best Practices
18
19### Length
20
21| Guideline | Target |
22|-----------|--------|
23| **Slug length** | Under 60 characters total (including path prefix) |
24| **Word count** | 3–5 words |
25| **Principle** | Shorter = easier to read, share, remember; less truncation in SERPs; see **serp-features** |
26
27**Example**: "The Complete Guide to AI Search Engine for Finding People" → `ai-people-search` (3 words) or `ai-search-finding-people` (4 words), not `ai-search-engine-finding-people-speed-discovery-outreach` (9 words, 51 chars).
28
29### Format
30
31| Rule | Do | Avoid |
32|------|-----|-------|
33| **Separators** | Hyphens (`-`) | Underscores (`_`), spaces, periods |
34| **Case** | Lowercase only | Mixed case (causes duplicate content) |
35| **Characters** | Letters (a-z), numbers (0-9), hyphens | Special chars |
36| **Stop words** | Remove when possible: the, a, and, or, to | Keep when needed: "how-to" |
37
38### Content
39
40| Rule | Guideline |
41|------|-----------|
42| **Primary keyword** | Include near start; one focus per URL |
43| **Descriptive** | Clear what page is about from slug alone |
44| **No keyword stuffing** | One keyword mention is enough |
45| **No dates** | Omit unless time-specific (news, annual roundups) |
46
47### Non-ASCII Characters
48
49| Scenario | Rule |
50|----------|------|
51| **Accented letters** | Convert to ASCII: é→e, ü→u, ñ→n, ç→c |
52| **Non-Latin scripts** | Use UTF-8 percent-encoding if required; prefer ASCII for compatibility |
53| **Example** | `jalapeno` not `jalapeño`; `cafe` not `café` |
54
55### Common Mistakes
56
57- **Copy-pasting full title**: Summarize instead — long title → short slug
58- **Auto-generated IDs**: `/post/12847` — always customize
59- **Tracking params in slug**: UTM, session IDs — use query params separately
60- **Changing without redirect**: Always 301 from old to new slug
61
62## Slug Generation Workflow
63
641. **Extract primary keyword** from title or target keyword
652. **Summarize** in 3–5 words (don't copy full title)
663. **Remove stop words** (the, a, and, or) unless needed for readability
674. **Lowercase, hyphenate**, validate length < 60 chars
685. **Check uniqueness** — no duplicate slugs site-wide
69
70## Examples
71
72| Title / Topic | ❌ Too long | ✅ Recommended |
73|---------------|-------------|-----------------|
74| AI Search Engine for Finding People: Speed vs. Discovery | `ai-search-engine-finding-people-speed-discovery-outreach` | `ai-people-search` or `ai-search-finding-people` |
75| The Ultimate SEO Checklist for 2025 | `the-ultimate-seo-checklist-for-2025` | `seo-checklist-2025` |
76| How to Increase Website Traffic | `how-to-increase-the-traffic-to-your-website` | `increase-website-traffic` |
77| Best Running Shoes for Marathon Training | `best-running-shoes-for-marathon-training-in-2025` | `best-running-shoes-2025` |
78
79## Output Format
80
81When creating or auditing a slug:
82
83- **Recommended slug** (3–5 words)
84- **Character count** (slug only)
85- **Primary keyword** included
86- **Alternatives** if multiple valid options
87
88- **Reference**: [Alignify URL optimization](https://alignify.co/zh/seo/url-optimization)
89
90## Related Skills
91
92- **url-structure**: URL hierarchy, site structure; references this skill for slug conventions
93- **canonical-tag**: When changing slugs, set up 301 redirects
94- **article-page-generator**: Article URL slugs
95- **blog-page-generator**: Blog post URL slugs
96- **glossary-page-generator**: Glossary term slugs
97- **products-page-generator**: Product page slugs
98- **customer-stories-page-generator**: Case study page slugs
99- **resources-page-generator**: Resource page slugs
100- **features-page-generator**: Per-feature page slugs
gabrielmoreira