skills/campaign-link-qr-builder/SKILL.md

---
name: campaign-link-qr-builder
description: Build a clean campaign URL with deliberate UTM parameters and encode it as a QR code. Use when the user wants a marketing, poster, flyer, social, email, or event QR with tracking parameters, or wants an existing campaign URL cleaned up before QR creation. Do not use for link shortening, analytics reporting, destination reputation checks, or non-HTTP links.
---

# Campaign Link QR Builder

## Gather the inputs

Require an HTTP or HTTPS destination URL. Collect only the tracking dimensions the user needs:

- `utm_source`
- `utm_medium`
- `utm_campaign`
- Optional `utm_content`
- Optional `utm_term`

Infer a value only when it is unambiguous from the request. Ask for a missing value when the user explicitly wants tracking and the omission would make the campaign attribution unclear.

## Construct the final URL

1. Trim surrounding whitespace and require an `http:` or `https:` scheme.
2. Preserve the destination host, path, fragment, and unrelated query parameters.
3. Preserve existing UTM parameters unless the user asks to replace them. Resolve conflicting requested values before creating the QR.
4. Normalize newly supplied UTM values consistently within the URL. Prefer concise lowercase values separated by hyphens unless the user has an established naming convention.
5. Percent-encode query values using normal URL semantics; do not manually double-encode them.
6. Show the exact final URL when it materially differs from the supplied destination.

If the result is unusually long, warn that it may produce a denser QR. Do not substitute an unrequested shortener or redirect.

## Create the QR code

Call `qr-code` with only:

- `qrCodeInformation.kind` set to `url`.
- `qrCodeInformation.url` set to the final URL.
- `qrCodeInformation.encodedText` set to an empty string.

Treat the normalized `structuredContent.qrCodeInformation` returned by the tool as authoritative.

## Deliver the result

Return:

- The exact encoded campaign URL.
- A compact mapping of each UTM parameter to its purpose.
- Any preserved pre-existing query parameters worth noting.
- Confirmation that the QR is editable and exportable in the widget.

## Boundaries

Do not claim the destination was opened, verified, or found safe. Do not claim that analytics are configured or receiving traffic. Do not shorten the link, create a redirect, or modify a remote website; those capabilities are not exposed by the app.