# Dub

> Read and write Dub: manage short links and read their click analytics; record lead or sale conversions. Trigger phrases: dub, short links.

- Skill: `anil-matcha/dub` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add anil-matcha/dub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anil-matcha/dub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: Anil-matcha (https://skillmd.com/u/anil-matcha)
- Updated: 2026-11-12
- Page: https://skillmd.com/skills/anil-matcha/dub

---


# Dub

## Purpose
Manage Dub short links: list links, create new ones, update or delete them, read click analytics, and record lead or sale conversions against a click. Use when the user mentions Dub or short links.

## Tooling
All commands go through `bin/dub.py`:

```bash
bin/dub.py auth                                                  # verify the API key
bin/dub.py links --limit 25                                      # list links
bin/dub.py create --url "https://example.com/long" --key "launch"  # new short link
bin/dub.py update --id "clvabc123" --url "https://example.com/new"  # edit a link
bin/dub.py delete --id "clvabc123"                               # delete a link
bin/dub.py analytics --link-id "clvabc123"                       # click analytics
bin/dub.py track-lead --click-id "abc123"                        # record a lead
bin/dub.py track-sale --click-id "abc123" --amount 4900          # record a sale
```

Dub paths are unversioned: the base is `https://api.dub.co` with no `/v2`. The link id for `update` and `delete` is the `id` field from `links`. `--amount` on `track-sale` is in cents.

## Auth
- Provider id: `dub` (credential is collected as `custom.dub`)
- Collection: API key (`dub_...`) via the secure credential flow (`credentials.request_api_access`); created in the Dub dashboard under API keys
- Allowed hosts: `api.dub.co`
- Status check: `bin/dub.py auth` (must return `"ok": true`)

## Operating Rules
1. `create`, `update`, `delete`, `track-lead`, and `track-sale` are writes: confirm with the user first, unless standing permission exists. Deleting a link breaks its short URL.
2. Dub keys are per workspace; a key from one workspace cannot touch another.
3. On HTTP 429, back off and honor the `Retry-After` header before retrying.
4. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the key value.

## Files
- SKILL.md
- bin/dub.py

## Maturity
🧪 Draft: written from Dub's public API docs; not yet live-tested end-to-end.

