What is brand-book?

This repository is an agent skill that takes a brand's raw materials and turns them into two things: a polished brand guidelines document and a companion skill that helps keep a product visually and verbally on-brand during development. You give it a logo, some colors, fonts, and a sense of the brand's voice. It produces a complete brand book plus token files and an enforcement hook so a coding agent can follow those guidelines in code. The repo ships two skills that produce the same book but render it differently. The default, brand-book-html, outputs a single self-contained HTML file you can open in any browser, print to PDF, or publish as a Claude Artifact. The other, brand-book-paper, renders to an editable design canvas using the Paper desktop app. The content is identical either way. You only need the Paper version if you want to hand-edit on a canvas. Everything derives from a single machine-readable file called brand.json, which holds the brand's colors, typography, logo rules, voice, and layout values. Colors are defined as seven semantic roles like background, foreground, and accent, rather than named by hue. This means a rebrand becomes a value change, not a full rename. The skill can measure a live website to pull real colors and fonts instead of guessing, which avoids the generic defaults that models tend to fall back on. The brand book itself is an 11-spread landscape document built incrementally with a self-review step after each spread. The companion skill generates real tokens.css and tokens.json files, an enforceable voice definition, and an optional lint hook that warns when an edit drifts off-brand. The skill works with Claude Code or any agent that loads skills, and the scripts only need Python 3 with no external dependencies. The full README is longer than what was shown.