# Shortlink Qr

> Create joel.dev shortlinks and QR assets. Use when Joel asks for a QR code, stage/demo shortlink, joel.dev redirect, link label that looks good in phone camera UI, or a copyable QR asset.

- Skill: `joelhooks/shortlink-qr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joelhooks/shortlink-qr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joelhooks/shortlink-qr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: joelhooks (https://skillmd.com/u/joelhooks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joelhooks/shortlink-qr

---


# shortlink-qr

Use when Joel asks for a QR code, stage/demo shortlink, joel.dev redirect, link label that looks good in phone camera UI, or a copyable QR asset.

## Default workflow

Prefer the Pi tool when available:

```ts
shortlink_qr({
  slug: "cascadia-example",
  url: "https://example.com/source",
  title: "Example source",
  push: true,
  background: "transparent"
})
```

The tool should:

1. Add/update `/<slug>  <target-url>` in `/Users/joel/Code/joelhooks/joel-dev-link-shortener/_redirects`.
2. Generate native HiDPI QR assets from vector source, not by upscaling a tiny PNG.
3. Default to a 1500×1500 PNG plus matching SVG in `resources/qr/`.
4. Copy the PNG to the macOS clipboard unless `clipboard: false`.
5. With `push: true`, commit the shortener change as `shitratgit[bot]`, then fetch/reset the shortener checkout to `origin/master`.
6. Add/update `.brain/resources/shortlinks.svx` as the local project Brain resource list.
7. Return the shortlink, target URL, QR paths, commit URL, Brain file path, and local Brain URL when available through portless/pi-notes.

## Background variants

Use `background` intentionally:

- `transparent` — default for slides and design tools.
- `white` — black QR on white background when transparency renders poorly.
- `black` — white QR on black background for dark slides.

Example:

```ts
shortlink_qr({
  slug: "cascadia-dark-demo",
  url: "https://example.com",
  push: true,
  background: "black"
})
```

## Why shortlinks

Phone camera UIs usually show the encoded URL/domain, not a custom QR label. Encode a friendly `https://joel.dev/<slug>` URL so the scanner display is readable.

## Brain resource rule

Every generated shortlink belongs in the local project Brain as a resource list entry at:

```text
.brain/resources/shortlinks.svx
```

This gives Joel a local pi-notes/portless review page for easy copy/paste of:

- short URL
- target URL
- PNG path
- SVG path
- background style

When a local Document Host is running, include the clickable Brain URL in the final answer. The extension tries `portless get pi-notes` and maps the note to:

```text
<pi-notes-url>/notes/resources/shortlinks
```

## Fallbacks

If Netlify deploy is stale or shortlink routing is suspect, generate a direct raw-URL QR for stage safety and say so. Do not silently hand Joel a QR that depends on an unverified redirect.

If ShitRat cannot access the shortener repo, do not push with Joel's identity. Return the local file changes and ask for the missing ShitRat/auth step.