Link-in-Bio Page Builder

---
name: link-in-bio
description: Rules and helper for building a creator's or shop's own link-in-bio page from links.json. A static, accessible page with no scripts or trackers, plus one copy per platform (Instagram, TikTok, Pinterest, YouTube and others) whose links to the user's own domains carry that platform as the UTM source. Checks addresses, https, duplicates, link shorteners, contrast and affiliate disclosure; lists every final URL; and explains free hosting. Use with the link-in-bio-builder commands, or when the user wants a link-in-bio page without a subscription.
---

# Link-in-bio page

## Rules

1. **The user's links only.** Never add links, affiliate tags or tracking the user didn't ask for. The page has no scripts, cookies or third-party trackers.
2. **UTM tags only on the user's own domains** (`utm.domains`). Other sites' links stay exactly as given, so affiliate links and marketplaces keep their own parameters.
3. **Affiliate links are disclosed.** Any link tagged `affiliate` adds a disclosure line to the page. Ask whether any link earns a commission.
4. **Readable.** Text and button colours need a contrast of at least 4.5:1. `check` and `build` enforce it.
5. **Hosting is the user's choice and account.** Explain the options. Don't sign up or publish for them.

## links.json

```json
{
  "name": "Your name or shop",
  "bio": "One line about you",
  "siteUrl": "https://links.yourdomain.com",
  "avatar": "avatar.jpg",
  "avatarAlt": "Describe the image",
  "theme": { "bg": "#fbf6ef", "text": "#2b1d14", "accent": "#9a3f1c", "buttonText": "#ffffff" },
  "links": [{ "title": "Shop the fall collection", "url": "https://yourdomain.com/fall", "tags": ["shop"] }],
  "socials": [{ "platform": "instagram", "label": "Instagram", "url": "https://www.instagram.com/you" }],
  "utm": { "medium": "social", "campaign": "link-in-bio", "domains": ["yourdomain.com"] },
  "platforms": ["instagram", "tiktok", "pinterest"]
}
```

Optional: `lang` (default en), `disclosure` (your own affiliate wording). Order links by importance, because people tap the first few.

## The helper

`node "${CLAUDE_PLUGIN_ROOT}/skills/link-in-bio/scripts/bio.mjs" <command> <links.json> ...`

| Command | Does |
|---|---|
| `check <links.json> [--site <built folder>]` | Fix: missing name, title or links, invalid or http addresses, low contrast, missing avatar file, and built pages that are out of date. Check: duplicate addresses, existing utm_source, over 12 links, no UTM domains. Tip: link shorteners, links not on your domains. Exit 2 when something needs fixing |
| `build <links.json> --out <folder>` | `index.html` (utm_source=bio), `<platform>/index.html` for each platform, and the avatar. Refuses to build while anything needs fixing. Rebuilds only into a folder it made itself (it keeps a `.bio-build.json` list) |
| `links <links.json> [--out links.csv]` | Every final URL on every page, for your records or a UTM sheet |

Each link gets `utm_source` (the platform, or bio), `utm_medium`, `utm_campaign` and `utm_content` (from the link title), so analytics can show which platform and which button sent each visit.