Brand Guidelines Skill Example

A complete example of a skill that maintains consistent brand identity across AI-generated content.

Use Case

This skill helps ensure all AI-generated content follows your company's brand guidelines, including:

  • Color palette usage
  • Typography rules
  • Tone of voice
  • Messaging guidelines

Complete SKILL.md

markdown
---
name: Acme Corp Brand Guidelines
description: Ensure all content follows Acme Corp brand standards
version: 2.0.0
author: Acme Design Team
platforms:
  - claude-code
  - codex
  - chatgpt
categories:
  - marketing
  - design
tags:
  - brand
  - content
  - style
---

# Acme Corp Brand Guidelines

## Brand Overview

Acme Corp is a modern technology company that values innovation,
simplicity, and customer success. Our brand reflects these values
through clean design and clear communication.

## Visual Identity

### Colors

Primary Colors:
- Acme Blue: #1A56DB (primary actions, headers)
- Acme Dark: #1F2937 (body text)
- Acme Light: #F9FAFB (backgrounds)

Accent Colors:
- Success Green: #10B981
- Warning Yellow: #F59E0B
- Error Red: #EF4444

### Usage Rules
- Always use sufficient contrast (WCAG AA minimum)
- Primary Blue for CTAs and important actions
- Never use more than 3 colors in a single component

### Typography

Font Family: Inter (sans-serif)

Sizes:
- Heading 1: 36px/48px bold
- Heading 2: 24px/32px semibold
- Body: 16px/24px regular
- Small: 14px/20px regular

## Voice and Tone

### We Are
- Professional but approachable
- Clear and concise
- Helpful and empowering
- Confident but not arrogant

### We Are Not
- Formal or stuffy
- Overly casual or slangy
- Condescending
- Vague or ambiguous

### Writing Guidelines

1. Use active voice
2. Keep sentences short (max 25 words)
3. Avoid jargon unless necessary
4. Address the reader directly (you/your)
5. Lead with benefits, not features

## Messaging Framework

### Tagline
"Innovation Made Simple"

### Value Propositions
1. Save time with automated workflows
2. Reduce costs with intelligent optimization
3. Scale confidently with enterprise reliability

### Common Phrases
- "Get started in minutes" (not "Quick setup")
- "24/7 support" (not "Always available support")
- "Trusted by thousands" (not "Many customers")

## Do's and Don'ts

### Do
- Use the Oxford comma
- Capitalize product names (Acme Platform, Acme API)
- Include alt text for all images
- End CTAs with action verbs

### Don't
- Use exclamation points excessively
- Make promises we can't keep
- Use competitor names
- Include dates that will become outdated

## Examples

### Good: Product Description
"Acme Platform helps teams ship faster with automated testing
and deployment. Get started in minutes and scale to millions."

### Bad: Product Description
"Our amazing solution is the best in the market! Sign up now
for an incredible experience that will blow your mind!"

### Good: Error Message
"We couldn't save your changes. Please check your internet
connection and try again."

### Bad: Error Message
"Error 500: Internal server error occurred during operation."

Line-by-Line Explanation

Frontmatter

yaml
name: Acme Corp Brand Guidelines

Clear, company-specific name that identifies this as a brand skill.

yaml
description: Ensure all content follows Acme Corp brand standards

Explains the skill's purpose in one sentence.

yaml
platforms:
  - claude-code
  - codex
  - chatgpt

Works across all major platforms.

Content Sections

Brand Overview: Establishes the company's core values upfront.

Visual Identity: Specific color codes and usage rules the AI can reference.

Voice and Tone: Personality guidelines with clear "we are/we are not" structure.

Messaging Framework: Concrete phrases and value propositions.

Do's and Don'ts: Quick reference for common decisions.

Examples: Shows the difference between good and bad content.

Customization Tips

  1. Replace colors: Use your actual brand colors with hex codes
  2. Update voice: Adjust personality traits to match your brand
  3. Add examples: Include real content samples from your company
  4. Include assets: Link to your brand assets or style guide

Next Steps