ordinarynerds/brand-book — explained in plain English
Analysis updated 2026-05-18
Generate a polished brand guidelines document from your logo, colors, fonts, and voice.
Create reusable code tokens so a coding agent can keep a product on-brand automatically.
Rebrand a product by swapping values in a single config file instead of renaming everything.
Measure a live website to pull real colors and fonts for an accurate brand book.
| ordinarynerds/brand-book | 0xustaz/streamgate | a-bissell/unleash-lite | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | Python | Python | Python |
| Setup difficulty | easy | hard | hard |
| Complexity | 2/5 | 4/5 | 4/5 |
| Audience | developer | developer | researcher |
Figures from each repo's GitHub metadata at analysis time.
Only needs Python 3 with no external dependencies, works with Claude Code or any agent that loads skills.
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.
A tool that turns your logo, colors, fonts, and brand voice into a complete brand guidelines document plus code tokens that keep a product visually on-brand during development.
Mainly Python. The stack also includes Python 3, Claude Code, HTML.
The explanation does not mention a license, so the licensing terms are unknown.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.