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
- 1. 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 | INLINECODE12 | INLINECODE13 or INLINECODE14 |
| 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
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
组件:URL 别名
指导为博客文章、文章和内容页面创建对 SEO 友好的 URL 别名。对 1180 万条谷歌搜索结果的研究表明,较短的 URL 排名往往更高;排名第一的 URL 平均长度为 50–60 个字符。
调用时:在首次使用时,如有帮助,可用 1–2 句话介绍此技能涵盖的内容,然后提供主要输出。在后续使用或用户要求跳过时,直接进入主要输出。
范围
- - URL 别名:基础路径后的路径段(例如,/blog/ai-people-search 中的 ai-people-search)
- 适用于:博客文章、文章、指南、分类页面、产品页面
最佳实践
长度
| 指南 | 目标 |
|---|
| 别名长度 | 总计不超过 60 个字符(包括路径前缀) |
| 单词数量 |
3–5 个单词 |
|
原则 | 越短 = 越易读、易分享、易记忆;在搜索结果页中截断更少;参见
serp-features |
示例:The Complete Guide to AI Search Engine for Finding People → ai-people-search(3 个单词)或 ai-search-finding-people(4 个单词),而非 ai-search-engine-finding-people-speed-discovery-outreach(9 个单词,51 个字符)。
格式
| 规则 | 执行 | 避免 |
|---|
| 分隔符 | 连字符(-) | 下划线(_)、空格、句点 |
| 大小写 |
仅小写 | 混合大小写(导致内容重复) |
|
字符 | 字母(a-z)、数字(0-9)、连字符 | 特殊字符 |
|
停用词 | 尽可能移除:the、a、and、or、to | 必要时保留:how-to |
内容
| 规则 | 指南 |
|---|
| 主要关键词 | 靠近开头包含;每个 URL 一个焦点 |
| 描述性 |
仅从别名即可清楚页面内容 |
|
不要堆砌关键词 | 提及一次关键词即可 |
|
不要日期 | 除非是时效性内容(新闻、年度总结),否则省略 |
非 ASCII 字符
| 场景 | 规则 |
|---|
| 带重音字母 | 转换为 ASCII:é→e、ü→u、ñ→n、ç→c |
| 非拉丁文字 |
必要时使用 UTF-8 百分号编码;为兼容性优先使用 ASCII |
|
示例 | 使用 jalapeno 而非 jalapeño;使用 cafe 而非 café |
常见错误
- - 直接复制粘贴完整标题:应进行总结——长标题 → 短别名
- 自动生成的 ID:/post/12847——始终自定义
- 别名中包含跟踪参数:UTM、会话 ID——应单独使用查询参数
- 更改后不设置重定向:始终从旧别名到新别名设置 301 重定向
别名生成工作流程
- 1. 提取主要关键词:从标题或目标关键词中提取
- 总结:用 3–5 个单词总结(不要复制完整标题)
- 移除停用词(the、a、and、or),除非为可读性需要保留
- 小写、加连字符,验证长度小于 60 个字符
- 检查唯一性——全站无重复别名
示例
| 标题 / 主题 | ❌ 过长 | ✅ 推荐 |
|---|
| AI Search Engine for Finding People: Speed vs. Discovery | ai-search-engine-finding-people-speed-discovery-outreach | ai-people-search 或 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 |
输出格式
创建或审核别名时:
- - 推荐别名(3–5 个单词)
- 字符数(仅别名)
- 包含的主要关键词
- 备选方案(如有多个有效选项)
相关技能
- - url-structure:URL 层级结构、网站结构;引用此技能了解别名规范
- canonical-tag:更改别名时,设置 301 重定向
- article-page-generator:文章 URL 别名
- blog-page-generator:博客文章 URL 别名
- glossary-page-generator:术语表词条别名
- products-page-generator:产品页面别名
- customer-stories-page-generator:案例研究页面别名
- resources-page-generator:资源页面别名
- features-page-generator:每个功能页面别名