Skip to main content
skill CX Codex

utm-builder · manojbajaj95 — Claude Code skill: what it does, how to install

utm-builder generates consistent UTM tracking links for Google Analytics and HubSpot campaigns. Useful when planning multi-channel marketing launches and A/B tests.

MIT 228 installs ★ 114 updated 2026-09-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manojbajaj95/claude-gtm-plugin --skill utm-builder -a claude-code
Open on GitHub

What utm-builder does

The skill enforces consistent marketing attribution across campaign links. It takes a landing URL, campaign details, and target channels to build clean URLs with utm_source, utm_medium, utm_campaign, utm_term, and utm_content. Built-in naming standards keep sources lowercase and map mediums specifically for paid, organic, or direct channels.

It handles bulk generation across search ads, paid social, email newsletters, and organic posts, formatting the final output into a markdown spreadsheet. When setting up A/B experiments, it automatically populates utm_content variants like control and treatment flags for straightforward filtering in analytics tools.

For ad platforms like Google Ads, LinkedIn, and Meta, the output injects native macros such as {keyword} or {{campaign.name}}. These placeholders require matching support inside your ad platform URL configuration to resolve dynamically.

What it helps with

  • generate batch UTM links for multi-channel launches with a tracking spreadsheet
  • tag landing page variants for A/B conversion tracking
  • insert dynamic platform macros for Google Ads and Meta campaigns
  • enforce uniform campaign naming across paid and organic channels

Example prompts for the agent

  • Create a UTM link for https://example.com/pricing targeting a LinkedIn spring campaign
  • Generate UTM links for https://example.com/demo across Google Ads, newsletter, and organic Twitter
  • Build A/B test tracking URLs for two homepage variants in Google Ads

How to install utm-builder

1Skills CLI (Vercel)

npx skills add manojbajaj95/claude-gtm-plugin --skill utm-builder -a claude-code

2Manually: put the files in place

~/.claude/skills/utm-builder/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about utm-builder

How to install utm-builder in Claude Code?

Run npx skills add manojbajaj95/claude-gtm-plugin --skill utm-builder -a claude-code in your terminal.

What does utm-builder do?

It creates structured, tag-compliant UTM campaign URLs for analytics platforms and outputs ready-to-use tracking spreadsheets.

Does utm-builder work with dynamic ad parameters?

Yes, it supports Google Ads ValueTrack tags like {keyword} along with campaign macros used by Meta and LinkedIn.

Source text

SKILL.md · MIT
---
name: utm-builder
description: Generate UTM-tagged URLs for campaign tracking. Create consistent, organized tracking links for Google Analytics, HubSpot, and other analytics platforms. Supports bulk generation, naming conventions, and campaign documentation. Use when creating tracking links, campaign URLs, or organizing marketing attribution.
---

# UTM Builder

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.



Generate consistent, well-organized UTM tracking links for marketing campaigns.

## UTM Parameters

| Parameter | Required | Purpose | Example |
|-----------|----------|---------|---------|
| `utm_source` | Yes | Traffic source | google, linkedin, newsletter |
| `utm_medium` | Yes | Marketing medium | cpc, email, social, organic |
| `utm_campaign` | Yes | Campaign name | spring-sale-2025 |
| `utm_term` | No | Paid search keywords | project+management |
| `utm_content` | No | Differentiate variants | cta-button, hero-image |

## Naming Conventions

### Recommended Format
```
utm_source:    {platform}
utm_medium:    {channel-type}
utm_campaign:  {yyyy-mm}-{campaign-name}
utm_term:      {keyword} (paid search only)
utm_content:   {ad-variant}-{placement}
```

### Source Values (lowercase, no spaces)
```
Paid:
  - google
  - linkedin
  - meta (facebook + instagram)
  - tiktok
  - twitter
  - bing

Organic Social:
  - linkedin-organic
  - twitter-organic
  - facebook-organic

Email:
  - mailchimp
  - hubspot
  - sendgrid
  - newsletter

Referral:
  - partner-{name}
  - affiliate-{name}
  - referral
```

### Medium Values
```
Paid:
  - cpc (cost per click)
  - cpm (cost per impression)
  - display
  - video
  - retargeting

Organic:
  - organic
  - social
  - referral

Direct:
  - email
  - sms
  - push

Content:
  - blog
  - pr
  - podcast
  - webinar
```

### Campaign Naming
```
Format: {date}-{name}-{segment}

Examples:
  - 2025-03-spring-promo
  - 2025-q1-product-launch
  - 2025-04-webinar-ai-trends
  - 2025-03-ebook-marketing-guide
  - evergreen-demo-request
```

## How to Use

### Single URL

```
Create a UTM link for:
URL: https://example.com/pricing
Campaign: Spring promotion on LinkedIn
```

**Output**:
```
https://example.com/pricing?utm_source=linkedin&utm_medium=cpc&utm_campaign=2025-03-spring-promo
```

### Bulk Generation

```
Create UTM links for a multi-channel campaign:
URL: https://example.com/demo
Campaign: Q2 Product Launch

Channels:
- Google Search Ads
- LinkedIn Sponsored Content
- Email newsletter
- Twitter organic post
```

**Output**:
```
═══════════════════════════════════════════════════════════════
CAMPAIGN: Q2 Product Launch
BASE URL: https://example.com/demo
DATE: 2025-Q2
═══════════════════════════════════════════════════════════════

GOOGLE SEARCH ADS:
──────────────────────────────────────────────────────────────
https://example.com/demo?utm_source=google&utm_medium=cpc&utm_campaign=2025-q2-product-launch&utm_term={keyword}

Use {keyword} placeholder for dynamic keyword insertion.

LINKEDIN SPONSORED:
──────────────────────────────────────────────────────────────
Variant A (Image):
https://example.com/demo?utm_source=linkedin&utm_medium=cpc&utm_campaign=2025-q2-product-launch&utm_content=image-a

Variant B (Video):
https://example.com/demo?utm_source=linkedin&utm_medium=cpc&utm_campaign=2025-q2-product-launch&utm_content=video-b

EMAIL NEWSLETTER:
──────────────────────────────────────────────────────────────
Header CTA:
https://example.com/demo?utm_source=newsletter&utm_medium=email&utm_campaign=2025-q2-product-launch&utm_content=header-cta

Footer CTA:
https://example.com/demo?utm_source=newsletter&utm_medium=email&utm_campaign=2025-q2-product-launch&utm_content=footer-cta

TWITTER ORGANIC:
──────────────────────────────────────────────────────────────
https://example.com/demo?utm_source=twitter-organic&utm_medium=social&utm_campaign=2025-q2-product-launch

═══════════════════════════════════════════════════════════════
TRACKING SPREADSHEET
═══════════════════════════════════════════════════════════════
| Channel | Source | Medium | Campaign | Content | Full URL |
|---------|--------|--------|----------|---------|----------|
| Google | google | cpc | 2025-q2-product-launch | - | [url] |
| LinkedIn | linkedin | cpc | 2025-q2-product-launch | image-a | [url] |
| LinkedIn | linkedin | cpc | 2025-q2-product-launch | video-b | [url] |
| Email | newsletter | email | 2025-q2-product-launch | header-cta | [url] |
| Email | newsletter | email | 2025-q2-product-launch | footer-cta | [url] |
| Twitter | twitter-organic | social | 2025-q2-product-launch | - | [url] |
```

### A/B Test Links

```
Create UTM links for A/B testing two landing pages:
URL A: https://example.com/landing-v1
URL B: https://example.com/landing-v2
Campaign: Homepage redesign test
Channel: Google Ads
```

**Output**:
```
VARIANT A (Control):
https://example.com/landing-v1?utm_source=google&utm_medium=cpc&utm_campaign=2025-03-homepage-test&utm_content=control-v1

VARIANT B (Treatment):
https://example.com/landing-v2?utm_source=google&utm_medium=cpc&utm_campaign=2025-03-homepage-test&utm_content=treatment-v2

TRACKING NOTE:
Compare conversion rates in Google Analytics:
Acquisition → Traffic Acquisition → Filter by utm_content
```

## Platform-Specific Tips

### Google Ads
```
Use ValueTrack parameters for dynamic insertion:
- {keyword} - Search keyword
- {matchtype} - Match type (e, p, b)
- {device} - Device (m, t, c)
- {adposition} - Ad position

Example:
?utm_source=google&utm_medium=cpc&utm_campaign=brand&utm_term={keyword}&utm_content={adposition}
```

### LinkedIn Ads
```
Use LinkedIn macros:
- {{CAMPAIGN_NAME}}
- {{CREATIVE_NAME}}
- {{CAMPAIGN_GROUP_NAME}}

Note: LinkedIn auto-appends some tracking; combine carefully.
```

### Meta (Facebook/Instagram)
```
Use URL parameters in ad setup:
- {{ad.name}}
- {{adset.name}}
- {{campaign.name}}

Example:
?utm_source=meta&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_content={{ad.name}}
```

### HubSpot Integration
```
HubSpot auto-recognizes UTM parameters.
Ensure consistency with HubSpot campaign naming.

Best practice:
- Create HubSpot campaign first
- Use exact campaign name in utm_campaign
- Tag all assets (emails, pages, ads) with same campaign
```

## Short URL Integration

For social media, use URL shorteners that preserve UTM:
- **Bitly** - Tracks clicks, preserves UTMs
- **Rebrandly** - Custom branded domains
- **Short.io** - Team features

Example workflow:
1. Generate full UTM URL
2. Shorten with Bitly
3. Use short URL in social posts
4. UTMs still tracked in Google Analytics

## Common Mistakes to Avoid

| Mistake | Problem | Solution |
|---------|---------|----------|
| Inconsistent capitalization | Creates duplicate campaigns in GA | Always use lowercase |
| Spaces in parameters | Breaks URL | Use hyphens or underscores |
| Missing utm_medium | Poor channel attribution | Always include medium |
| Generic campaign names | Hard to analyze | Use date + descriptive name |
| Not documenting | Lost tracking context | Maintain spreadsheet |
| Duplicate utm_source | Confusion in reporting | Standardize naming |

## UTM Audit

### Checklist
- [ ] All lowercase (no mixed case)
- [ ] No spaces (use hyphens)
- [ ] Consistent naming across team
- [ ] Campaign includes date prefix
- [ ] Medium matches channel type
- [ ] Content differentiates variants
- [ ] Documented in tracking spreadsheet

### Analytics Verification
After launching, verify in GA4:
1. Go to Reports → Acquisition → Traffic acquisition
2. Add secondary dimension: Session source/medium
3. Filter by campaign name
4. Confirm data is populating correctly

## Template Library

### Email Campaigns
```
Newsletter:
?utm_source=newsletter&utm_medium=email&utm_campaign={date}-{topic}&utm_content={position}

Drip Sequence:
?utm_source=hubspot&utm_medium=email&utm_campaign={sequence-name}&utm_content=email-{number}

Transactional:
?utm_source=transactional&utm_medium=email&utm_campaign=order-confirmation
```

### Social Media
```
Organic Post:
?utm_source={platform}-organic&utm_medium=social&utm_campaign={date}-{topic}

Paid Social:
?utm_source={platform}&utm_medium=cpc&utm_campaign={date}-{campaign}&utm_content={creative-name}
```

### Content Marketing
```
Blog Post:
?utm_source=blog&utm_medium=organic&utm_campaign={post-slug}

Guest Post:
?utm_source={publication}&utm_medium=referral&utm_campaign=guest-post-{date}

Podcast:
?utm_source={podcast-name}&utm_medium=podcast&utm_campaign={episode}
```

### Partnerships
```
Co-Marketing:
?utm_source=partner-{name}&utm_medium=referral&utm_campaign={joint-campaign}

Affiliate:
?utm_source=affiliate-{name}&utm_medium=referral&utm_campaign=affiliate-program
```

## Integration

Works well with:
- **data-and-funnel-analytics** - Analyze UTM performance
- **ad-campaign-management** - Track paid campaign ROI
- **social-media-management** - Measure social campaign results
- **marketing-automation** - Add tracking to email campaigns

© manojbajaj95 · MIT · manojbajaj95/claude-gtm-plugin

Similar skills

All skills for Marketing and content →

utm-builder by other authors comes first.

utm-builder Cogny AI utm-builder — a skill for building correct UTM parameters, checking them against GA4 channel rules, and auditing live data from Google Ads and analytics platforms. Built for marketers and analysts who track attribution. CX Codex +1 ★ 116repo stars utm-parameter-generator OneWave-AI utm-parameter-generator — a skill for Claude Code, Codex, Cursor and other AI editors that generates UTM parameters for campaigns and enforces consistent naming across the team. Activates on requests for tracking links or UTM reports. CX Codex +1 338installs utm-link-generator OneWave-AI utm-link-generator builds UTM-tagged links under unified naming rules, tracks duplicates, and outputs variants for LinkedIn, email, social, and ads. CX Codex +1 249installs marketing-brain Cogny AI marketing-brain builds a shared marketing context tree for AI agents by interviewing founders and pulling customer facts from CRM, store, and Stripe records. CX Codex +1 ★ 116repo stars customer-language Cogny AI customer-language extracts verbatim customer pain points from CRMs, support chats, and community threads into weekly reports for marketing prompts. CX Codex +1 ★ 116repo stars suppress-global-unsubscribes tomgranot suppress-global-unsubscribes finds globally unsubscribed HubSpot contacts, audits their status, and guides the manual move to non-marketing status. CX Codex +1 ★ 81repo stars create-segment-lists tomgranot create-segment-lists builds a library of HubSpot segment lists — customers, partners, competitors, employees, ICP tiers, industries. Feeds targeting, suppression and reporting. CX Codex +1 ★ 81repo stars

From the same set41

The whole set →
product-market-fit-analysis product-market-fit-analysis is a Claude Code skill that assesses product-market fit through retention, customer surveys, and demand signals. It helps weigh iteration against scaling. CX Codex +1 251installs community-building community-building is a Claude Code skill that guides an agent through building online communities, from platform selection to ambassador programs. It covers channel architecture, onboarding, and moderation. CX Codex +1 246installs sales-and-revenue-operations sales-and-revenue-operations is a Claude Code skill for planning sales workflows, defining an ICP, qualifying deals, and structuring lead operations. CX Codex +1 246installs customer-success-and-retention customer-success-and-retention — a skill for designing customer retention flows from first value to churn prevention. Maps onboarding milestones, health scoring models, and risk-driven interventions across the full customer lifecycle. CX Codex +1 239installs ph-community-outreach ph-community-outreach is a Claude Code skill that finds communities for Product Hunt launches and adapts posts to each platform’s norms. CX Codex +1 228installs user-onboarding user-onboarding maps product first-time user experiences, pins down the aha moment, and drafts activation plans. Built for growth teams fixing signup drop-offs. CX Codex +1 227installs pr-specialist A skill for Claude Code, Codex, Cursor, GitHub Copilot, and other AI agents that gives the agent a PR specialist role. Covers press release writing, journalist pitches, crisis communication, and earned media strategy. CX Codex +1 226installs challenge-funnel Builds multi-day challenge funnels: five-day bootcamps, launches with live sessions, daily tasks, and a flagship offer pitch at the end. CX Codex +1 224installs

More in the catalog

Project sponsors

Companies that keep this analytics open