skill-short-link · Short Links & UTM Tracking

Append UTM tracking parameters (source/medium/campaign) to content and campaign links, then shorten them — so traffic from Xiaohongshu, Douyin, WeChat Official Accounts and other channels is attributable.

Uses key-free public shorteners (TinyURL / is.gd / v.gd), pure standard-library implementation, zero dependencies. Three operations: UTM-only, shorten-only, or both in one step; is.gd / v.gd support custom aliases.

Example invocation: "Generate a short link for this product URL for our Xiaohongshu campaign, campaign name 618."

Full brief

Positioning

skill-short-link is a tracking tool for campaign links: it appends UTM parameters and shortens URLs so every channel's traffic is attributable. It answers "where did this link come from and how did it perform" — it doesn't do the performance analysis itself.

Core capabilities

UTM parameter assembly: utm_source / medium / campaign / term / content, following the GA universal tracking standard.
URL shortening: TinyURL (default, most reliable), is.gd / v.gd (support --alias custom codes).
Three operations: utm for parameters only, short for shortening only, both in one step.
Pure standard library: no third-party dependencies.
Multi-asset A/B: --content distinguishes creatives within one campaign (e.g. "video A" vs. "graphic B").

Workflow

Provide the landing/product/form URL
Specify the three UTM elements: source (platform), medium, campaign
Run shortlink.py (both is the common path) → tracked short link
Multi-platform campaigns: generate one short link per platform (different source) for per-platform attribution

Inputs & outputs

Input	Required	Notes
URL	Yes	Landing / product / form link
source	Required for UTM	Platform, e.g. xiaohongshu / douyin / wechat
medium	Required for UTM	e.g. social / video / cpc
campaign	Required for UTM	e.g. 618 / newproduct
provider	No	tinyurl (default) / isgd / vgd

Output: shortened URL with UTM parameters.

Boundaries with adjacent skills

This skill handles source tagging at the link level; spend-performance computation lives in roi-calculator; scheduling and logging live in skill-publish-scheduler / skill-publish-log.

Fit

Attributing traffic per channel in multi-platform campaigns
Channels where long URLs don't fit (Xiaohongshu, Douyin, WeChat)
A/B comparison of multiple creatives in one campaign
Distributing identity-tagged promo links to KOLs/KOCs

Before you start

No API key; key-free public shorteners.
Rules: one short link per channel (distinct utm_source) or per-platform attribution is impossible; use consistent campaign naming for later aggregation.
Note: shorteners are third-party public services — mission-critical campaigns deserve a self-hosted short domain; is.gd / v.gd blacklist some domains.

skill-short-link is part of the Aiglade Skill library. Invoke it from the Aiglade chat box in plain language.

← All 155 skills