Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a claude-code
Open on GitHub

What 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, source newsletter, medium email, campaign spring-sale
  • Generate LinkedIn and Facebook variants for this link
  • Show all links for campaign spring-sale from the registry

How to install utm-link-generator

1Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill utm-link-generator -a claude-code

2Manually: put the files in place

~/.claude/skills/utm-link-generator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/utm-link-generator/

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

Similar skills

All skills for Marketing and content →

From the same set185

The whole set →
full-codebase-migrator The full-codebase-migrator skill examines a whole repository and turns it into a file-level migration plan. Use it for JS-to-TS work, React class conversion, or framework changes. CX Codex +1 251installs competitor-intel-agent competitor-intel-agent monitors competitor sites, pricing models, hiring shifts, and product releases while saving snapshot history. CX Codex +1 251installs okr-generator okr-generator builds a structured okr-plan.md file using the Google and Intel framework from your company targets and team baselines. CX Codex +1 250installs renewal-predictor The renewal-predictor skill analyzes seven account health dimensions—engagement, support, adoption, satisfaction, billing, stakeholder continuity. CX Codex +1 249installs saas-replacement-planner saas-replacement-planner analyzes your SaaS stack and produces a replacement plan with ROI calculations, implementation timeline, and risk assessment for switching to AI agents. CX Codex +1 247installs expansion-revenue-finder The expansion-revenue-finder skill for Claude Code finds upsell and cross-sell opportunities by analyzing product usage, team growth, and competitive pressure, then scores each by revenue potential, effort, and likelihood. CX Codex +1 247installs agent-swarm-deployer agent-swarm-deployer deploys parallel sub-agent swarms for heavy data jobs like bulk document summarization, dataset processing, and multi-record content generation. CX Codex +1 247installs churn-autopsy churn-autopsy — a skill for post-mortem analysis of client churn. Collects interaction history, support tickets, usage logs and exit feedback, then builds a timeline of decline and identifies root causes. CX Codex +1 244installs

Project sponsors

Companies that keep this analytics open