brand-kit
You turn whatever the user has about their brand (logo files, a guidelines PDF, a website, a
few hex codes, "we use green") into one brand.json that other skills build from:
the Word and PowerPoint converters, md-to-docx and md-to-pptx. Capturing the brand once means nobody answers the same questions for every deck,
and every document matches.
How to respond
Ask for everything in one message, and take what they already gave. Never ask for something the user already supplied.
To set up your brand kit, send whatever you have. Anything you skip I'll either take from what you sent or leave for you to confirm:
- Brand name, and a tagline if you use one
- Logo files. The main logo, plus a white or light version for dark backgrounds if you have one. PNG is best; SVG works for flyers, but PowerPoint needs PNG.
- Colours as hex codes (
#0E5A46), or a guidelines PDF or website I can read them from - Fonts for headings and body text
- Voice: how you sound, and words you always or never use
- Imagery: the kind of photos or illustrations you use, and what to avoid
- A PowerPoint template (
.potxor.pptx) if your company has one - Contact and legal: website, email, phone, and any footer line such as "© 2026 …"
Read the sources the user points to. From a guidelines PDF or website, extract colour hex codes, font names, logo usage rules and voice. Tag every value with where it came from in
sources:[explicit]when the source states it,[inferred]when you derived it (a colour sampled from the logo, a tone read from the About page). Never present an inferred value as the brand's own rule.Fill the five colour roles. The roles are
primary(main brand colour; slide title bars, flyer bands),secondary(supporting),accent(highlights, calls to action),backgroundandtext. If the user gave one or two colours, derive the rest and say which roles you filled. Usuallybackgroundis white or a near-white tint of the primary,textis a near-black, andsecondaryis a lighter or darker step of the primary.Write the files next to the logo files, so relative paths resolve:
brand.json, in the shape oftemplates/brand.json. Leave a field out instead of guessing it.BRAND.md: one page with the name, colour swatches as a table (role, hex, use), fonts, voice, imagery rules and logo rules, readable by a person who never opens the JSON.
Check it.
# Claude Code python3 "${CLAUDE_SKILL_DIR}/scripts/check_brand.py" ./brand/brand.json # Other IDEs (from the skill folder) python3 scripts/check_brand.py ./brand/brand.jsonIt fails on a malformed hex code, text-on-background contrast below 4.5:1, a missing logo file or template. It warns when white text on the primary is hard to read, when the accent is too light for text, when a logo is SVG or EPS, or when fonts aren't set. Fix the failures. Report each warning with what it means for the deck or document.
Hand off. Tell the user the path to
brand.json, and that the Word and PowerPoint converters apply it with--brand brand.json.
Non-interactive runs (subagent, CI, headless): never invent a brand colour, font or logo.
Use only what the input supplies, tag derived colours [inferred], and list missing fields
at the top of the response. With no brand material at all, emit BLOCKED: need at least a brand name and either a logo file or one brand colour.
Useful references in this skill
templates/brand.json— the full shape, with every field filled in for a sample brandscripts/check_brand.py— the checker: hex format, contrast, logo files and formats, templateexamples/northwind-brand.md— worked example: a logo, two hex codes and a website become a brand kit
Quality bar
- Every colour is a hex code with a role. "Our green" is not a brand colour;
#0E5A46used for title bars is. - Text on background passes 4.5:1, checked by the script rather than by eye.
- Every value says where it came from, and inferred values are marked as inferred.
- Logo files are real paths that exist, with a PNG for PowerPoint and an on-dark version when the brand has one.
- Nothing is invented. A field the user didn't supply and couldn't be read from their sources is left out and listed, not guessed.
- BRAND.md fits on one page. A person checks the brand from it without opening the JSON.
When to use this skill
- ✅ Before the first branded deck or flyer, so both come out in the same brand
- ✅ The user hands over brand guidelines, a logo, or a website and asks for things "in our style"
- ✅ A brand has changed and the old
brand.jsonneeds updating
When NOT to use this skill
- ❌ Designing a new brand from scratch: this captures a brand, it doesn't invent one
- ❌ Building the deck itself; convert its Markdown with
md-to-pptx - ❌ A one-off document where the user only wants the default look
Anti-patterns to avoid
- ❌ Asking eight separate questions instead of one message with everything.
- ❌ Sampling a colour from a JPEG and recording it as the official hex without the
[inferred]tag. - ❌ Accepting an SVG logo for PowerPoint use without saying a PNG is needed.
- ❌ Picking a pale accent as the text colour because it is "on brand". It fails contrast and nobody can read it.
- ❌ Filling the voice section with adjectives ("innovative, passionate"). Words to use and words to avoid are what a writer can act on.