shipwright-brandlisted
Install: claude install-skill app-vitals/shipwright
# shipwright-brand skill
## Purpose
Produce **on-brand Shipwright Harness marketing artifacts** by deriving everything from the locked
brand system — never by hand-picking colors, fonts, or copy. The system lives in:
- **`brand/tokens.json`** — canonical machine-readable tokens (colors, type scale, radii, gradients). The single source of truth.
- **`brand/BRAND.md`** — the human narrative: voice, logo rules, component patterns, content rules.
- **`brand/brand.css`** — generated stylesheet (CSS custom properties + utility classes) derived from `tokens.json`.
- **`brand/templates/`** — starting points: `one-pager.html`, `deck.html`, `social-card.html`.
## The lock (non-negotiable)
1. **Never write a raw hex, font name, or radius into an artifact.** Use `brand.css` variables (`var(--sw-color-brand-default)`) and utility classes (`.sw-btn`, `.sw-card`, `.sw-callout`, `.sw-pill`, `.sw-container`, `.sw-display`, `.sw-label`, `.sw-gradient-text`).
2. **If you need a value, read it from `tokens.json`** — don't recall it from memory.
3. **Green `#34C77B` is the hero; Patriot navy `#002244` is a support surface (never link text); `#4F8EF7` is the readable blue.** CTAs are green-fill / navy-text. Body copy uses `--sw-color-text-body` (80%), not the 50% editorial tone.
## Workflow (every artifact)
1. **Refresh the stylesheet** so it matches current tokens:
`bun brand/build-brand-css.ts` → writes `brand/brand.css`.
2. **Start from the matching template** in `brand/templates/` (