
Url Slug Generator
Create short, readable permalinks for blog posts and content pages that match SEO length research.
Overview
url-slug-generator is an agent skill for the Launch phase that creates and validates SEO-friendly URL slugs for content pages.
Install
npx skills add https://github.com/kostja94/marketing-skills --skill url-slug-generatorWhat is this skill?
- Length targets: slug under 60 characters, 3–5 words, aligned with SERP truncation guidance
- Cites research framing: position #1 URLs average 50–60 characters across large-result samples
- Scope covers blog posts, articles, guides, category and product path segments
- Before/after title-to-slug shortening examples in SKILL.md
- Cross-reference to serp-features and url-structure for site-wide policy
- Target slug length under 60 characters including path prefix
- 3–5 word slugs recommended
- Research note: position #1 URLs average 50–60 characters (11.8M-result sample cited in SKILL.md)
Adoption & trust: 762 installs on skills.sh; 586 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your article titles produce bloated permalinks that truncate in search results and are hard to share.
Who is it for?
Indie publishers and marketers shipping blog posts, guides, or category URLs who want research-backed slug rules in one pass.
Skip if: Defining entire site hierarchy, canonical domains, or trailing-slash policy—use url-structure instead.
When should I use this skill?
User wants to create, optimize, or validate URL slugs, or mentions URL slug, permalink, SEO-friendly URL, or blog URL.
What do I get? / Deliverables
You get a concise, keyword-focused slug under roughly 60 characters with 3–5 words ready to paste into your CMS or route config.
- Proposed SEO slug string
- Length and word-count validation against guidelines
- Short rationale tying slug to primary keyword
Recommended Skills
Journey fit
How it compares
Single-page slug generator, not a full URL architecture or redirect manager.
Common Questions / FAQ
Who is url-slug-generator for?
Solo builders publishing SEO content who want consistent permalink rules without manually re-reading SEO checklists each post.
When should I use url-slug-generator?
At Launch/SEO when naming new posts; when the user says URL slug, permalink, SEO-friendly URL, or slug optimization.
Is url-slug-generator safe to install?
It provides text guidance only; verify the package source using the Security Audits panel on this Prism catalog page.
SKILL.md
READMESKILL.md - Url Slug Generator
# 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 2. **Summarize** in 3–5 words (don't copy full title) 3. **Remove stop words** (the, a, and, or) unless needed for readability 4. **Lowercase, hyphenate**, validate length < 60 chars 5. **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 -