# Link creator Human Guide

## What This Is For
Create tracked Dub.co short links for partnerships, creators, and communities. It gives the agent a clearer input/output frame for link creator: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the Link creator agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for link creator.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the Link creator guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- **Partner/creator name**, Who is this link for?
- **Promo code**, The code to embed (for example, `PARTNER-CODE`)
- **Link type**, What kind of partnership? (see Link Types below)
- **Landing page**, Which page should they land on?
- All UTM values: lowercase, hyphens for spaces, no special characters
- Slugs: lowercase-with-hyphens for new links
- Promo codes: UPPERCASE-WITH-HYPHENS as provided by your billing/admin system
- If landing page is main: `https://wisprflow.ai/?promo_code=[PROMO-CODE]`
- If landing page is `/developers`: `https://wisprflow.ai/developers?promo_code=[PROMO-CODE]`
- If no promo code: omit the `?promo_code=` parameter
- **Is the partner through an agency with a dedicated folder?** → use that agency folder.
- **Is it a newsletter/podcast sponsorship, or an agency-mediated creator without a dedicated folder?** → `Sponsorships`.

## Decision Points And Nuance
The original skill emphasizes: Workflow, Step 1: Gather Required Info, Step 2: Determine Link Type, Step 3: Determine Landing Page, Step 4: Apply UTM Standards, Step 5: Build Destination URL, Step 6: Assign to Folder, Tagging (newsletters and podcasts), Step 7: Confirm Before Creating, Step 8: Create in Dub.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- Step 1: Gather Required Info
- | To Sort | `{FOLDER_ID}` | Staging bucket, avoid writing here |
- When in doubt, ask. Never invent folder names, only real folder IDs from your workspace are valid.

## Copy-And-Paste Prompt
```text
Use the Link creator human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the Marketing Engineering Podcast skill entry for `wispr-flow-link-creator`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# Link Creator: Partnership Links

Create properly tracked Dub.co short links with standardized UTM parameters, promo codes, and folder organization.

> Adapt the domains, folder IDs, and tag IDs below to your own Dub workspace. The `{FOLDER_ID}` and `{TAG_ID}` placeholders are where your real Dub IDs go. Keep them in a private lookup, not in a shared skill file.

## Workflow

### Step 1: Gather Required Info

Ask the user for (if not already provided):

1. **Partner/creator name**, Who is this link for?
2. **Promo code**, The code to embed (for example, `PARTNER-CODE`)
3. **Link type**, What kind of partnership? (see Link Types below)
4. **Landing page**, Which page should they land on?

### Step 2: Determine Link Type

If not explicitly stated, infer from context or ask:

| Type | When to use |
|------|------------|
| `community` | Community program, member deal, group partnership |
| `youtube` | YouTube creator sponsorship or integration |
| `linkedin` | LinkedIn creator/influencer partnership |
| `podcast` | Podcast sponsorship (pre-roll, mid-roll, host-read) |
| `newsletter` | Newsletter sponsorship placement (one link per send date) |
| `affiliate` | Ongoing affiliate/referral relationship |
| `influencer` | Regional influencer program |

### Step 3: Determine Landing Page

Ask which landing page to use:

| Page | URL | Best for |
|------|-----|----------|
| Main | `wisprflow.ai/` | General audience, broad appeal |
| Developers | `wisprflow.ai/developers` | Developer/engineer audience |
| Leaders | `wisprflow.ai/leaders` | Executives, managers, business leaders |
| Custom | `wisprflow.ai/[path]` | ICP-specific or campaign landing pages |

### Step 4: Apply UTM Standards

Use this table to generate UTM parameters based on link type:

| Type | utm_source | utm_medium | utm_campaign | utm_content | Slug pattern |
|------|-----------|------------|--------------|-------------|-------------|
| `community` | `[partner-name]` | `community` | `[partner]-[program]` | — | `[program-name]` |
| `youtube` | `youtube` | `creator` | `[creator-slug]` | — | `[creator-slug]` |
| `linkedin` | `linkedin` | `creator` | `[creator-slug]` | — | `[creator-slug]` |
| `podcast` | `[podcast-name]` | `podcast` | `[podcast-slug]` | — | `[podcast-slug]` |
| `newsletter` | `[partner-slug]` | `newsletter` | `[partner]-[publication]-[yyyy]-[mm]` | `[placement-type]-[yyyy-mm-dd]` | `[partner]-[mmm][dd]` |
| `affiliate` | `[partner-name]` | `affiliate` | `[partner]-affiliate` | — | `[partner-slug]` |
| `influencer` | `youtube` | `influencer` | `[creator-slug]` | — | `[creator-slug]` |

**Naming rules:**
- All UTM values: lowercase, hyphens for spaces, no special characters
- Slugs: lowercase-with-hyphens for new links
- Promo codes: UPPERCASE-WITH-HYPHENS as provided by your billing/admin system

### Step 5: Build Destination URL

Construct the destination URL:

```
https://wisprflow.ai/[landing-page]?promo_code=[PROMO-CODE]
```

- If landing page is main: `https://wisprflow.ai/?promo_code=[PROMO-CODE]`
- If landing page is `/developers`: `https://wisprflow.ai/developers?promo_code=[PROMO-CODE]`
- If no promo code: omit the `?promo_code=` parameter

### Step 6: Assign to Folder

Route by relationship and partner agency, not just link type. Keep a private folder inventory that maps each bucket to its Dub folder ID. A typical structure:

| Folder | Folder ID | What goes here |
|--------|-----------|----------------|
| Sponsorships | `{FOLDER_ID}` | Newsletter, podcast, and dedicated creator sponsorships; agency-mediated deals without a dedicated agency folder |