utm-link-generator — Claude Code skill: UTM link builder
utm-link-generator builds UTM-tagged links under unified naming rules, tracks duplicates, and outputs variants for LinkedIn, email, social, and ads.
MIT 249 installs ★ 440 updated 2026-10-20
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a claude-codeWhat utm-link-generator does
The skill constructs links with UTM parameters enforced by a single schema: source, medium, campaign — always lowercase, spaces replaced with hyphens, unknown values rejected with a suggestion for the closest match. All links are recorded in utm-registry.json, where the skill detects exact and near duplicates, blocks naming conflicts (same campaign name, different casing), and maintains stats. For each link, you can immediately generate platform-specific variants: LinkedIn, email, social networks, ad platforms.
The skill supports registry commands: audit all links, add new source or medium values, generate a campaign report, export to CSV. Parameter length is capped at 50 characters. When the base URL already contains query parameters, the skill appends UTM tags with &, preserving what is there.
What it helps with
- build a UTM link with naming-rule validation
- check for duplicates and campaign naming conflicts
- generate variants for LinkedIn, email, and ads
- maintain a registry of all project UTM links
- export a campaign report or CSV dump
Example prompts for the agent
- Create a UTM link for the newsletter: base
landing.com/promo, sourcenewsletter, mediumemail, campaignspring-sale - Generate LinkedIn and Facebook variants for this link
- Show all links for campaign
spring-salefrom the registry
How to install utm-link-generator
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a claude-code2Manually: put the files in place
~/.claude/skills/utm-link-generator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/utm-link-generator/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a codex2Manually: put the files in place
.agents/skills/utm-link-generator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a cursor2Manually: put the files in place
.cursor/skills/utm-link-generator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OneWave-AI/claude-skills utm-link-generator2Manually: put the files in place
.github/skills/utm-link-generator/SKILL.md1Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/OneWave-AI/claude-skills --path utm-link-generatorManually: put the files in place
.devin/skills/utm-link-generator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about utm-link-generator
How to install utm-link-generator in Claude Code?
Run npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a claude-code, then open ~/.claude/skills/utm-link-generator/SKILL.md.
What does utm-link-generator do?
It generates UTM-tagged links under unified rules, writes them to utm-registry.json, checks for duplicates and conflicts, creates platform variants, and produces campaign reports.
Which parameters are required to generate a link?
Source, medium, and campaign are required. Term and content are optional. All values are lowercased, spaces become hyphens, and each parameter is limited to 50 characters.
Source text
SKILL.md · MIT
---
name: utm-link-generator
description: Generates properly tagged UTM links with consistent naming conventions. Maintains a UTM registry file (utm-registry.json) to enforce naming consistency, prevent duplicates, generate short links, and output ready-to-copy links for LinkedIn, email, social, and ads.
tools: Read, Write, Bash
user_invocable: true
---
# UTM Link Generator
Generate UTM-tagged links under a single naming-governance system: a `utm-registry.json` that enforces canonical conventions, prevents duplicates and naming drift, and outputs platform-ready links for LinkedIn, email, social, and ads.
## Contents
- `references/naming-conventions.md` -- enforced rules, UTM parameter reference, canonical source/medium lists, campaign naming pattern.
- `references/platform-variants.md` -- per-platform link templates (LinkedIn, email, social, paid ads).
- `references/registry-schema.md` -- utm-registry.json structure plus validation-report and output-summary templates.
- `references/bulk-and-registry-ops.md` -- bulk generation, registry commands (audit/add/report/export), error handling, integrations, best practices.
## Capabilities
1. Generate UTM-tagged URLs with validated, consistent parameters.
2. Maintain `utm-registry.json` tracking all links and enforcing conventions.
3. Prevent duplicates -- warn when a similar link already exists.
4. Format platform-specific variants (LinkedIn, email, social, ads).
5. Bulk-generate variants for A/B testing or multi-channel campaigns.
6. Validate -- reject malformed URLs, empty parameters, and convention violations.
7. Report -- generate campaign tracking summaries from the registry.
## Workflow
1. **Accept input.** Collect destination URL, source, medium, campaign (all required) plus optional term, content, and target platforms. Extract these from a natural-language brief when not given explicitly.
2. **Validate and normalize.** Lowercase, replace spaces with hyphens, strip non-`[a-z0-9-]` characters, auto-correct known aliases, reject unknown source/medium values (suggest closest match), validate URL form, enforce the 50-character limit. Report corrections using the template in `references/registry-schema.md`. Full rules in `references/naming-conventions.md`.
3. **Check registry for duplicates.** Read `utm-registry.json` (create if missing). Return existing link on exact duplicates, allow-with-warning on near duplicates, block on naming conflicts (same campaign, different casing/hyphenation).
4. **Generate links.** Build `{base_url}?utm_source=&utm_medium=&utm_campaign=[&utm_term=][&utm_content=][&utm_id=]`. Append with `&` if the base URL already has query params, URL-encode values, and preserve existing query params and fragment.
5. **Generate platform variants.** Produce optimized links per requested platform using `references/platform-variants.md`.
6. **Update registry.** Append all generated links to `utm-registry.json` per the schema in `references/registry-schema.md`, refreshing stats and timestamps.
7. **Output summary.** Present a copy-paste-ready summary using the template in `references/registry-schema.md`.
For bulk runs, registry commands (audit, add source/medium, campaign report, CSV export), error handling, and integration notes, see `references/bulk-and-registry-ops.md`.
© OneWave-AI · MIT · OneWave-AI/claude-skills