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
- Replace colors: Use your actual brand colors with hex codes
- Update voice: Adjust personality traits to match your brand
- Add examples: Include real content samples from your company
- Include assets: Link to your brand assets or style guide
Next Steps
- Frontend Design - UI/UX skill example
- Create Skills - Start building your own