/the_problem /define /decode /practice /lock_it_in /apply /refine

/process

From brand guidelines to brand system

Too often, brand guidelines end up in a PDF nobody opens. I turned mine into a single command that produces brand-perfect pages every time.

/
command
0
steps to get there
0
designers needed

/the_problem

The brand guidelines problem

What often happens

  • Someone builds a beautiful brand book
  • It gets shared as a 60-page PDF
  • People open it once, maybe twice
  • Then they guess from memory
  • Colours drift. Fonts change. Spacing breaks
  • Every presentation looks slightly different
  • The brand slowly dissolves

What could happen instead

  • Brand rules become executable code
  • One command produces brand-perfect output
  • Every hex code, every font weight, enforced
  • Any input format, same output quality
  • Corrections improve the system itself
  • Brand consistency without brand police
  • The guidelines actually work

The best brand guidelines are the ones that execute themselves.

\01 / 06

Define the experience

Start with what the brand should feel like, not what it should look like. The visual identity follows from the experience you want someone to have.

For Run with Foxes, the brief to myself was: it should feel like a well-designed technical manual. Clean, precise, slightly obsessive about detail. The kind of thing you'd find in an architecture studio, not a marketing agency.

That feeling drove every decision. The monospace body font. The dot grid. The terminal-style navigation. Sharp corners, no decoration. Every element earns its place.

background
#FAFAF8
text
#1D1B1B
accent
#F47521
charcoal
#355E4C
cream
#F7EAD9
muted
#8A8A85

\02 / 06

Decode it with Claude Code

Open a terminal. Describe what you want. Claude Code translates the feeling into precise, machine-readable specifications. Every hex code. Every font weight. Every spacing value. Every rule about what never to do.

$ claude
# describe the brand experience
analysing brand assets...
extracting colour palette: 6 values
mapping typography: Space Grotesk + JetBrains Mono
documenting spacing system: 28px grid
cataloguing rules: 14 constraints
writing SKILL.md...
brand spec ready. 298 lines.

The output is a skill file: a structured document that tells Claude Code exactly how to build pages in your brand. Not a PDF that people interpret. A specification that machines execute.

\03 / 06

Practice and iterate

This is where the real work happens. You take a real presentation, run it through the system, and look at what comes out. Some things will be right immediately. Others won't.

The heading weight looks too heavy. The dot grid is competing with the chart. The charcoal sections need more breathing room. The nav links don't feel right on mobile.

Each correction sharpens the spec. The gap between what you want and what you get closes with every iteration. After three or four real pages, the system starts producing output that feels right first time.

1

First attempt

Colours are right but spacing is off. Headings too bold. Dot grid too prominent. Nav doesn't feel terminal-like enough.

2

Second pass

Spacing corrected. Heading weight dropped to 300. Charcoal sections added. But charts don't match the brand palette yet.

3

Third iteration

Charts branded. Scroll animations added. Fox imagery integrated. Mobile breakpoints refined. Getting close.

4

Locked in

Output matches the brand experience. Every correction from the first three rounds is now in the spec. The system remembers what you taught it.

\04 / 06

Lock it in as a skill

Once you're happy with the output, the spec becomes a permanent skill. Type /branded-page and the entire brand system activates. Colours, fonts, spacing, animation rules, fox placement, chart styling, navigation patterns. All of it.

$ claude
> /branded-page convert this presentation to a webpage
reading source: presentation.pptx
extracting 24 slides, 8 charts, 3 data tables
mapping to 9 scrolling sections
applying brand spec: 298 lines
building chart.js visualisations
adding scroll animations: 8 interactive moments
placing fox imagery: 3 positions
running brand compliance check...
done. opening ~/projects/output/index.html

The skill file is the brand guideline. Except it doesn't ask people to follow rules. It follows them itself.

\05 / 06

Apply it to everything

Same command, any input. The system doesn't care whether it's reading a PowerPoint, a PDF, a Word doc, a set of bullet points, or a screenshot. The output is always brand-correct.

.pptx
Presentations
PowerPoint, Google Slides
.pdf
Documents
Reports, research papers
.docx
Word docs
Briefs, strategies
.png
Screenshots
Slides, mockups
.txt
Bullet points
Notes, outlines
.csv
Data
Tables, charts

I've used it for client pitch decks, internal strategy documents, and research summaries. 24 slides became a single scrolling page with animated charts, data tables, and scroll-triggered reveals.

The person writing the presentation doesn't need to know the brand spec. They write their content. The system handles everything else.

\06 / 06

Keep refining

The system isn't finished when you lock in the skill. It's finished when you stop caring about your brand, which is never. Every correction you make gets absorbed back into the spec.

1

Spot something off

"The nav brand text shouldn't use underscores. It's /Runwithfoxes, not /run_with_foxes."

2

Correct it once

Tell Claude Code. It fixes the current page and updates the skill file so it never happens again.

3

It sticks

Every future page gets it right. The brand compliance checklist grows. The system gets sharper with use.

Brand systems should improve with use. Most decay with time. This one doesn't.