Brand skill

Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

by nextlevelbuilder·MIT license·★ 129,643 Stars on the repo·GitHub ↗

Use now

Files of Brand

nextlevelbuilder/main1 file shown
SKILL.md
Show the full text109 lines

Brand

Brand identity, voice, messaging, asset management, and consistency frameworks.

When to Use

  • Brand voice definition and content tone guidance
  • Visual identity standards and style guide development
  • Messaging framework creation
  • Brand consistency review and audit
  • Asset organization, naming, and approval
  • Color palette management and typography specs

Script Paths

Script paths in this skill and its references/ are relative to the directory that contains this SKILL.md, not to the project: scripts/<file> is this skill's own scripts/ folder, and ../<skill>/scripts/<file> is a sibling sub-skill installed alongside it. Build the full path from that directory (Claude Code reports it as the skill's base directory when the skill loads) and keep the working directory at the project root — the scripts read and write project files such as docs/brand-guidelines.md, assets/design-tokens.json or src/ relative to it.

Quick Start

Inject brand context into prompts:

node scripts/inject-brand-context.cjs
node scripts/inject-brand-context.cjs --json

Validate an asset:

node scripts/validate-asset.cjs <asset-path>

Extract/compare colors:

node scripts/extract-colors.cjs --palette
node scripts/extract-colors.cjs <image-path>

Brand Sync Workflow

# 1. Edit docs/brand-guidelines.md (or use /brand update)
# 2. Sync to design tokens
node scripts/sync-brand-to-tokens.cjs
# 3. Verify
node scripts/inject-brand-context.cjs --json | head -20

The sync stops when it detects existing token files, :root custom properties or Tailwind v4 @theme variables in common CSS entry points and their local CSS imports, or Tailwind theme colors and presets. Review the reported source before proceeding. If the detected files are the managed assets/design-tokens.* outputs from an earlier sync and replacing them is intentional, re-run with --force.

Files synced:

  • docs/brand-guidelines.md → Source of truth
  • assets/design-tokens.json → Token definitions
  • assets/design-tokens.css → CSS variables

Subcommands

Subcommand Description Reference
update Update brand identity and sync to all design systems references/update.md

References

Topic File
Voice Framework references/voice-framework.md
Visual Identity references/visual-identity.md
Messaging references/messaging-framework.md
Consistency references/consistency-checklist.md
Guidelines Template references/brand-guideline-template.md
Asset Organization references/asset-organization.md
Color Management references/color-palette-management.md
Typography references/typography-specifications.md
Logo Usage references/logo-usage-rules.md
Approval Checklist references/approval-checklist.md

Scripts

Script Purpose
scripts/inject-brand-context.cjs Extract brand context for prompt injection
scripts/sync-brand-to-tokens.cjs Sync brand-guidelines.md → design-tokens.json/css
scripts/validate-asset.cjs Validate asset naming, size, format
scripts/extract-colors.cjs Extract and compare colors against palette

Templates

Template Purpose
templates/brand-guidelines-starter.md Complete starter template for new brands

Routing

  1. Parse subcommand from $ARGUMENTS (first word)
  2. Load corresponding references/{subcommand}.md
  3. Execute with remaining arguments
1---
2name: brand
3description: Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.
4argument-hint: "[update|review|create] [args]"
5metadata:
6 author: claudekit
7 version: "1.0.0"
8---
9 
10# Brand
11 
12Brand identity, voice, messaging, asset management, and consistency frameworks.
13 
14## When to Use
15 
16- Brand voice definition and content tone guidance
17- Visual identity standards and style guide development
18- Messaging framework creation
19- Brand consistency review and audit
20- Asset organization, naming, and approval
21- Color palette management and typography specs
22 
23## Script Paths
24 
25Script paths in this skill and its `references/` are relative to the directory that contains this SKILL.md, not to the project: `scripts/<file>` is this skill's own `scripts/` folder, and `../<skill>/scripts/<file>` is a sibling sub-skill installed alongside it. Build the full path from that directory (Claude Code reports it as the skill's base directory when the skill loads) and keep the working directory at the project root — the scripts read and write project files such as `docs/brand-guidelines.md`, `assets/design-tokens.json` or `src/` relative to it.
26 
27## Quick Start
28 
29**Inject brand context into prompts:**
30```bash
31node scripts/inject-brand-context.cjs
32node scripts/inject-brand-context.cjs --json
33```
34 
35**Validate an asset:**
36```bash
37node scripts/validate-asset.cjs <asset-path>
38```
39 
40**Extract/compare colors:**
41```bash
42node scripts/extract-colors.cjs --palette
43node scripts/extract-colors.cjs <image-path>
44```
45 
46## Brand Sync Workflow
47 
48```bash
49# 1. Edit docs/brand-guidelines.md (or use /brand update)
50# 2. Sync to design tokens
51node scripts/sync-brand-to-tokens.cjs
52# 3. Verify
53node scripts/inject-brand-context.cjs --json | head -20
54```
55 
56The sync stops when it detects existing token files, `:root` custom properties
57or Tailwind v4 `@theme` variables in common CSS entry points and their local
58CSS imports, or Tailwind theme colors and presets. Review the reported source
59before proceeding. If the detected files are the managed
60`assets/design-tokens.*` outputs from an earlier sync and replacing them is
61intentional, re-run with `--force`.
62 
63**Files synced:**
64- `docs/brand-guidelines.md` → Source of truth
65- `assets/design-tokens.json` → Token definitions
66- `assets/design-tokens.css` → CSS variables
67 
68## Subcommands
69 
70| Subcommand | Description | Reference |
71|------------|-------------|-----------|
72| `update` | Update brand identity and sync to all design systems | `references/update.md` |
73 
74## References
75 
76| Topic | File |
77|-------|------|
78| Voice Framework | `references/voice-framework.md` |
79| Visual Identity | `references/visual-identity.md` |
80| Messaging | `references/messaging-framework.md` |
81| Consistency | `references/consistency-checklist.md` |
82| Guidelines Template | `references/brand-guideline-template.md` |
83| Asset Organization | `references/asset-organization.md` |
84| Color Management | `references/color-palette-management.md` |
85| Typography | `references/typography-specifications.md` |
86| Logo Usage | `references/logo-usage-rules.md` |
87| Approval Checklist | `references/approval-checklist.md` |
88 
89## Scripts
90 
91| Script | Purpose |
92|--------|---------|
93| `scripts/inject-brand-context.cjs` | Extract brand context for prompt injection |
94| `scripts/sync-brand-to-tokens.cjs` | Sync brand-guidelines.md → design-tokens.json/css |
95| `scripts/validate-asset.cjs` | Validate asset naming, size, format |
96| `scripts/extract-colors.cjs` | Extract and compare colors against palette |
97 
98## Templates
99 
100| Template | Purpose |
101|----------|---------|
102| `templates/brand-guidelines-starter.md` | Complete starter template for new brands |
103 
104## Routing
105 
1061. Parse subcommand from `$ARGUMENTS` (first word)
1072. Load corresponding `references/{subcommand}.md`
1083. Execute with remaining arguments
109 

Discussion

Alternatives

Audience belief mapperUse when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present) — each item sourced from interviews or win-loss notes (User-provided) and labeled Measured / User-provided / Estimated, with any unverified quote or comparative claim marked "[needs source]" and routed to the claims candidates, never adjudicated here. Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer. 受众信念/异议地图/切换四力/流失语言Marketing · Apache-2.0Brand Voice Analysis and Guidelines GenerationPaste in your website and marketing copy, and get back a clear guide anyone on your team can follow to sound like your brand every time.Content & docs · MITBrand voice enforcerAnalyze and rewrite content to strict brand voice guidelines, scoring adherence across tone, vocabulary, syntax patterns, and persona alignment for CPG and retail brands.Marketing · Apache-2.0Product Marketing ContextWhen the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing skills — it creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context.Marketing · MIT