Skip to main content
command CX Codex

brand — Claude Code command: what it does, how to install

Generates a 14-chapter editorial brand guidelines document from any live URL. Produces a standalone HTML book, markdown summary, and design tokens.

MIT ★ 5,183 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Manavarya09/design-extract
/plugin install designlang@designlang
Open on GitHub

What brand does

The command runs npx designlang brand against a target address. It inspects the page and writes artifacts into ./design-extract-output/: a print-ready *.brand.html with a dark mode toggle and table of contents, a snapshot summary in *.brand.md, and data in *.brand.json.

The generated manual spans fourteen chapters. It details brand archetype, typography specimens, color palettes with HEX and HSL values, spacing units, icon libraries, motion timings, and WCAG accessibility contrast scores. It also exports ready-to-use CSS custom properties and Tailwind configuration blocks.

Execution relies on an environment where npx is available in your shell. If you omit the URL parameter, the agent prompts you to provide the target website before continuing.

What it helps with

  • extract a complete brand stylebook from a live website
  • export design tokens into CSS variables and Tailwind config
  • audit color contrast and accessibility issues against WCAG standards
  • generate a markdown design snapshot to track visual diffs over time

Example prompts for the agent

  • Generate a brand guidelines book and open it: /brand <url> --open
  • Export structured design data only: /brand <url> --format json
  • Save generated guidelines into a custom folder: /brand <url> --out ./brand-docs

How to install brand

1Plugin marketplace

/plugin marketplace add Manavarya09/design-extract
/plugin install designlang@designlang

2Manually: put the files in place

.claude/commands/brand.md

Call it with /brand. For all projects use ~/.claude/commands/

Questions about brand

How to install brand in Claude Code?

Run /plugin marketplace add Manavarya09/design-extract and then /plugin install designlang@designlang. This registers the command within your Claude Code setup.

What outputs does the brand command produce?

By default, it writes three files to ./design-extract-output/: an editorial *.brand.html, a summary *.brand.md, and raw design data in *.brand.json.

What flags are available for the command?

You can pass --open to launch the HTML file in your browser, --format to select output formats, --out to pick a destination directory, or -n to set a custom file prefix.

Source text

brand.md · MIT
---
description: Generate a full editorial brand-guidelines book for any URL. 14 chapters covering brand essence/archetype, colour, typography, spacing, shape, iconography, motion, components, voice, accessibility, tokens, and how-to-use guidance. Print-ready, dark-mode toggle, hand-off-ready single HTML.
argument-hint: <url> [--open]
---

Build a self-contained, hand-off-ready brand-guidelines book from any live URL.

```bash
npx designlang brand $ARGUMENTS
```

If no URL is provided, ask the user which site to document.

Output goes to `./design-extract-output/`:

- `*.brand.html` — the editorial book (open this — it's a self-contained, print-ready document with TOC, smooth-scroll, dark-mode toggle)
- `*.brand.md` — terse markdown summary (good for diffing snapshots)
- `*.brand.json` — structured slice of the design with the surfaces the book renders

After the run completes:

1. Read `*.brand.md` to summarise what was captured (host, page intent, material language, tone, palette size, type families, WCAG score)
2. Tell the user the headline numbers (`X tokens · Y fonts · grade Z`)
3. Offer to open the HTML book (`--open` does this automatically)
4. Suggest pairing: `/pack <url>` if they want a developer-facing bundle to drop into a project, `/grade <url>` for the audit, `/theme-swap <url>` to derive a recoloured variant

## What's in the book

| § | Chapter | What it documents |
|---|---|---|
| 00 | Essence | Synthesized brand personality: positioning statement, archetype (1 of 12 Jungian, with confidence), adjectives, and a four-axis meter (warmth · energy · weight · era) — every call traced to extracted signals |
| 01 | About | Page intent, material language, imagery style, component library, stack, voice tone |
| 02 | Logo | Extracted SVG logo + clearspace + dimensions |
| 03 | Colour | Brand colours with HEX/RGB/HSL/usage, neutrals grid, full palette, A11y callout |
| 04 | Typography | Display + body families, weights, scale table, large specimen |
| 05 | Spacing | Base unit, scale length, visual rhythm bars |
| 06 | Shape | Border radii visualised, shadow elevation system |
| 07 | Iconography | Icon library detection + captured icons grid |
| 08 | Motion | Feel, durations (animated dots), easings, spring presence, scroll-linked flag |
| 09 | Components | Detected components with slots/variants/sizes |
| 10 | Voice & tone | Tone, pronoun posture, heading case, top CTA verbs, sample headings |
| 11 | Accessibility | WCAG score, failing pairs table, suggested replacements |
| 12 | Tokens | Drop-in code blocks (CSS vars, Tailwind config) + cross-ref to `pack` |
| 13 | How to use | Six rules of thumb for derivative work |

## Useful flags

| Flag | Effect |
|---|---|
| `--format html\|md\|json\|all` | Pick the output(s). Default `all`. |
| `--out <dir>` | Output directory. Default `./design-extract-output`. |
| `-n, --name <name>` | Output file prefix. Default derived from URL. |
| `--open` | Open the HTML book in your default browser. |

## Pairs nicely with

- `/pack <url>` — when the recipient wants files to drop into a project, not a guidelines doc
- `/grade <url>` — when the recipient wants the audit/score, not the full book
- `/theme-swap <url> --primary <hex>` — when the recipient wants the same system in their brand colour
- `/remix <url> --as <vocab>` — when the recipient wants a vocabulary swap (brutalist, swiss, etc.)

© Manavarya Singh · MIT · Manavarya09/design-extract

Similar slash commands

All slash commands for Design →

From the same set16

The whole set →

Project sponsors

Companies that keep this analytics open