Skip to main content
skill CX Codex

brand-kit · aykutucesai — Claude Code skill: video brand settings

The brand-kit Claude Code skill builds and checks brand settings for video projects. It activates when a video needs consistent colors, fonts, logos, or voice.

MIT ★ 128 updated 2026-11-03

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add aykutucesai/motionforge
/plugin install motionforge@motionforge
Open on GitHub

What brand-kit does

The skill creates, loads, and validates a brand.json containing color roles, font licenses, logo files, watermark and outro settings, plus voice and style rules. It comes into play for branded videos and when a site, repository, logo, or screenshots provide the visual reference.

A Python 3 script extracts a draft from a site, repository, or CSS and HTML files; repository contents are read without execution. The checker flags missing required fields, invalid colors, and broken logo paths. It cannot see CSS added by JavaScript at runtime or resolve Tailwind palette classes. Screenshot colors are sampled manually.

What it helps with

  • draft brand.json from a site or CSS
  • catch missing fields and invalid logo paths
  • derive brand colors from screenshots
  • define video colors, fonts, and voice rules

Example prompts for the agent

  • Create a brand.json draft from this website.
  • Check brand/<id>/brand.json and list any errors.
  • Choose brand colors for this video from these screenshots.

How to install brand-kit

1Plugin marketplace

/plugin marketplace add aykutucesai/motionforge
/plugin install motionforge@motionforge

This installs the whole motionforge plugin with all its skills

2Skills CLI (Vercel)

npx skills add aykutucesai/motionforge --skill brand-kit -a claude-code

3Manually: put the files in place

~/.claude/skills/brand-kit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/brand-kit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about brand-kit

How do I install brand-kit in Claude Code?

Add the marketplace with /plugin marketplace add aykutucesai/motionforge, then install the skill with /plugin install motionforge@motionforge.

What does brand-kit do?

It creates, loads, and validates video brand settings in brand.json, covering color roles, fonts, logos, watermark, outro, and voice rules.

What does brand-kit need to run?

Python 3 is needed for extraction and validation. Brand details can come from a website, repository, CSS and HTML files, or manual review of screenshots.

Source text

SKILL.md · MIT
---
name: brand-kit
description: Create, load or check a brand.json (color roles, fonts with licenses, logo files, watermark, outro, voice and tone, do/don't) for videos made for a company, product or creator. Use when a video is for a brand, when the user shares a website, repository, logo or screenshots to match, or when brand colors/fonts/logos need to be applied consistently across videos.
license: MIT
---

# Brand kit

A brand kit is decided once and reused in every video. It lives in a `brand/` folder next to the video projects (one subfolder per brand when there are several) and is copied into each `videos/<slug>/brand.json`.

```
brand/<brand-id>/
  brand.json
  BRAND.md          # short human summary: tone, sample lines, what to avoid
  logo/             # logo files exactly as supplied (svg preferred)
  fonts/            # only fonts whose license allows shipping them
```

When a brand has its own rules, they **override** the default style rules for color, ground, fonts and logo. Rules about honesty, hooks, banned phrases, real logos/screens and consent for paid steps still apply.

## 1. Find out what exists
Ask, in this order, and stop at the first that gives enough:
1. An existing `brand/<id>/brand.json` from an earlier video → reuse it; re-check only if the user says the brand changed.
2. A brand guide (PDF, Figma, notes) → read it and fill brand.json by hand.
3. The brand's own website or front-end code → run the extractor (step 2).
4. Only screenshots or a logo → sample colors from them (step 2, manual path).
5. Nothing → ask for colors, fonts and logo. **Never invent a brand identity for a real company.**

## 2. Extract a draft
```bash
python3 skills/brand-kit/scripts/brand.py extract --url https://brand.example -o brand/<id>/brand.json
python3 skills/brand-kit/scripts/brand.py extract --repo ../their-app/web -o brand/<id>/brand.json   # read only, nothing executed
python3 skills/brand-kit/scripts/brand.py extract --css theme.css --html index.html -o brand/<id>/brand.json
```
How the draft is built (standard-library Python, no installs):
- Reads CSS custom properties, `:root`/`body` colors, `@font-face`, `font-family` declarations, Google Fonts links, `@fontsource/*` dependencies, `theme-color` and `og:*` meta, and logo-like files or `<img>` tags in the header.
- Assigns color roles from variable names (`--background`, `--foreground`, `--primary`, `--border`, …), resolving `var()` chains; falls back to `body`/`:root` declarations; the accent fallback is the most used saturated color and is marked as a guess.
- Records the **source** of every value. Anything not found is `null` and listed in `missing`.
- Limits: CSS injected by JavaScript at runtime is not seen; Tailwind default palette classes are not resolved; a site that blocks scripts returns nothing. Then use screenshots.

**Screenshots only (manual path):** open the image, pick background, text and the one strong brand color by eye, confirm with a color picker or `ffmpeg -i shot.png -vf "scale=1:1" -f rawvideo -pix_fmt rgb24 - | xxd` for an average, and mark each value `"source": "sampled from <file>"`.

## 3. Complete it with the user
Show the draft as a short table (role, hex, where it came from) and ask the user to:
- confirm or correct each color role and say what it **means** (`use`);
- pick the logo files (one for dark grounds, one for light grounds, a square icon);
- name the font license (OFL/Apache/commercial). Commercial fonts are used only from the user's own licensed files and never committed to a public repo;
- set the voice: register (informal/formal address), tone words, typical call to action, words to prefer and avoid;
- decide the watermark and the outro;
- list do/don't rules.

## 4. brand.json schema
| Field | Required | Content |
|---|---|---|
| `name` | yes | brand name as written |
| `colors.<role>` | `bg`, `ink`, `accent` | `{hex, name, use, source?}`; other roles: `surface`, `accent_2`, `muted`, `line`, `bg_light`, `ink_on_light` |
| `gradients[]` | no | `{name, stops[], angle, use}`; say where it may appear |
| `ground` | no | how backgrounds look (`dark`, `light`, `never[]`) |
| `fonts.display/body/mono` | display + body | `{family, weights[], license, subsets[], files[], fallback, usage}`; include `latin-ext` when any Latin language beyond English is used |
| `logo` | yes for brands | `primary_on_dark`, `primary_on_light`, `icon`, `min_width_px`, `clearspace` |
| `watermark` | no | `{file, corner: top-left|top-right|bottom-left, size_px, margin_px, opacity, from_s, hide_during[]}` |
| `outro` | no | `{duration_s, layout, handle, site, cta{lang: text}, icons[]}` |
| `captions` | no | `{font, weight, size_px, active_word, zone_y[], stroke}` |
| `voice` | yes | `{register, tone[], audience, goal, cta, words_prefer[], words_avoid[]}` |
| `do[]`, `dont[]` | yes | short, testable rules |

See `examples/northwind.brand.json` (a fictional agency) for a complete kit with a corner watermark and an outro with handle and site.

## 5. Check it
```bash
python3 skills/brand-kit/scripts/brand.py check brand/<id>/brand.json
```
FAIL: missing name/bg/ink/accent, invalid hex, a font without license, a logo path that does not exist, an invalid watermark corner or opacity. WARN: contrast below 4.5:1 (ink/bg) or 3:1 (accent/bg), no `use` for a color, no latin-ext subset, a bottom-right watermark (sits under the platform buttons), an outro under 1.5 s, empty `dont`.
Low contrast is reported, never "fixed" by changing the brand color: use the accent on larger elements or on another surface instead.

## 6. Apply it in scenes
- HyperFrames: generate CSS variables from `brand.json` (`--bg`, `--ink`, `--accent`, …) and `@font-face` rules for each file and subset; scenes use only the variables, never raw hex.
- Remotion: import `brand.json` and read colors and fonts from it in one theme module.
- Watermark: one fixed layer for the whole video at the given corner, size and opacity; hidden in the windows listed in `hide_during`.
- Outro: logo for the ground in use, handle and site in the body font, the CTA line in the video language, held at least 1.5 s; the last spoken sentence (the CTA) lands on it.
- Captions: active word in the brand's `captions.active_word` color.
- Words: run `voice.words_avoid` through the banned-phrase scan in `script-and-hooks` together with the language list.

© motionforge contributors · MIT · aykutucesai/motionforge

Similar skills

All skills for Design →

brand-kit by other authors comes first.

brand-kit dotslashsimran This Claude Code skill captures a company's visual identity from its website and saves a reusable brand kit. It runs before creating branded videos, stickers, or graphics. CX Codex +1 ★ 541repo stars brand-kit Cogny AI Writes a brand-kit.json holding your product's colors, type and voice so other skills can read them. Useful when the site's source code isn't at hand. CX Codex +1 ★ 116repo stars brand-guidelines official anthropics brand-guidelines applies Anthropic's official brand colors and fonts to documents, slides and other artifacts. Useful whenever something needs to match the company look. CX Codex +1 109,043installs brand claudekit Keeps brand voice, visual rules and design tokens in one markdown file, then feeds them to your agent's prompts and to your CSS variables. CX Codex +1 51,100installs brand-landingpage Travis D. Elliott The brand-landingpage skill interviews you about the product and its visual direction, then builds a landing page through Stitch. Use it when there’s no established design yet. CX Codex +1 39,476installs experience-cms-brand-apply forcedotcom experience-cms-brand-apply finds existing brands in Salesforce CMS, retrieves their guidelines, and uses them when generating content. Useful when output needs to follow a specific brand. CX Codex +1 5,000installs Brand Guidelines Generator claude-office-skills Brand Guidelines Generator generates brand style guides, typography rules, and color palettes. Helpful when you need to document visual identity and communication standards. CX Codex +1 4,900installs brand-intake charlie947 brand-intake is a Claude Code skill that turns a brand interview and reference frames into project guidelines. Start it at the beginning of a motion project or ask it to write MOTION.md. CX Codex +1 3,600installs

From the same set8

style-library The style-library Claude Code skill selects, adapts, or defines a visual style for a motionforge video before scene work begins. It activates for a named look, topic, or reference. CX Codex +1 ★ 128repo stars qa-review The qa-review Claude Code skill checks motion-design videos before delivery and after revisions. It reviews frame sheets, runs text, technical and audio checks, then calls an independent critic. CX Codex +1 ★ 128repo stars script-and-hooks The script-and-hooks Claude Code skill writes narration and on-screen copy for short videos. It activates for a new script, a voice-over draft, a rewrite, or a review for clichés and unsupported claims. CX Codex +1 ★ 128repo stars voice-and-timing The voice-and-timing Claude Code skill creates video narration, assigns word timings, and prepares captions. It fits workflows for narrated clips, word-driven animation, or audio-level adjustments. CX Codex +1 ★ 128repo stars motion-director motion-director — a skill for Claude Code that guides coded motion-design videos from brief to checked MP4. It starts on requests for a reel, animated explainer, product clip, or video cover and captions. CX Codex +1 ★ 128repo stars faceless-ugc The faceless-ugc Claude Code skill builds videos around a talking avatar or faceless visuals. It activates for requests about UGC ads, lip-sync, or making a picture speak. CX Codex +1 ★ 128repo stars motionforge The motionforge Claude Code plugin creates motion-design videos from text briefs. It builds scenes, syncs captions to speech, then checks the render. ★ 128repo stars

Project sponsors

Companies that keep this analytics open