Brand voice, visual identity, messaging frameworks, asset management, and consistency. Use for branded content, tone of voice, marketing assets, brand compliance, and style guides.
Brand identity, voice, messaging, asset management, and consistency frameworks.
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>
node scripts/validate-asset.cjs <asset-path> --json
Extract/compare colors:
node scripts/extract-colors.cjs --palette
node scripts/extract-colors.cjs <image-path>
| Topic | File | Description |
|---|---|---|
| Voice Framework | references/voice-framework.md | Brand voice development and testing |
| Visual Identity | references/visual-identity.md | Core visual elements and guidelines |
| Messaging | references/messaging-framework.md | Value props and messaging architecture |
| Consistency | references/consistency-checklist.md | Channel and material auditing |
| Guidelines Template | references/brand-guideline-template.md | Comprehensive template for brand docs |
| Asset Organization | references/asset-organization.md | Directory structure and naming |
| Color Management | references/color-palette-management.md | Color systems and accessibility |
| Typography | references/typography-specifications.md | Fonts, scales, and implementation |
| Logo Usage | references/logo-usage-rules.md | Logo variants and placement rules |
| Approval Checklist | references/approval-checklist.md | Asset review and approval process |
| 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 |
When updating brand identity, always sync all files:
# 1. Edit docs/brand-guidelines.md (or use /brand:update command)
# 2. Sync to design tokens
node scripts/sync-brand-to-tokens.cjs
# 3. Verify
node scripts/inject-brand-context.cjs --json | head -20
Files synced:
docs/brand-guidelines.md → Source of truth (human-readable)assets/design-tokens.json → Token definitionsassets/design-tokens.css → CSS variables| Template | Purpose |
|---|---|
templates/brand-guidelines-starter.md | Complete starter template for new brands |
Assets in assets/ (designs, banners, logos, videos, generated). Metadata in .assets/manifest.json.
Naming: {type}_{campaign}_{description}_{timestamp}_{variant}.{ext}
Example: banner_launch_hero-image_20251209_16-9.png
| Workflow | Steps |
|---|---|
| Voice Development | Define personality → tone spectrum → do's/don'ts → examples → doc |
| Asset Approval | Create → validate → check colors → approval checklist → register |
| Brand Audit | Collect → assess consistency → identify gaps → prioritize → update |
Skills: ai-multimodal (image generation/analysis), content-marketing (voice application), social-media Agents: content-creator, social-media-manager, email-wizard, ui-ux-designer
| # | Mistake | Fix |
|---|---|---|
| 1 | Creating brand assets without running validate-asset.cjs | Always validate naming, size, and format before registering in manifest |
| 2 | Updating brand-guidelines.md without syncing tokens | Run sync-brand-to-tokens.cjs after every brand update |
| 3 | Using wrong color hex values in generated content | Always inject brand context first with inject-brand-context.cjs |
| 4 | Inconsistent voice across channels | Voice adapts tone, not personality — document channel-specific variations |
| 5 | Storing generated assets outside assets/generated/ | AI-generated assets must go in generated/ with timestamp naming |
| 6 | Skipping asset registration in manifest.json | Every published asset must be registered for tracking/versioning |
Consistency > perfection. Voice adapts tone, not personality. Show examples, not just rules. Update quarterly. Register all assets in manifest. Use naming conventions strictly.