# brand-brief-generating

> Generates a brand brief including tone, audience, topics, content language, visual design, and guidelines based on website analysis. Use after analyzing a website or when the user wants to create/update brand guidelines.

- Author: makkusubaitou
- Repository: makkusubaitou/blogAgent
- Version: 20260126231411
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/makkusubaitou/blogAgent
- Web: https://mule.run/skillshub/@@makkusubaitou/blogAgent~brand-brief-generating:20260126231411

---

---
name: brand-brief-generating
description: Generates a brand brief including tone, audience, topics, content language, visual design, and guidelines based on website analysis. Use after analyzing a website or when the user wants to create/update brand guidelines.
---

# Brand Brief Generator

## Purpose
Create comprehensive brand guidelines for consistent content creation based on website analysis, including **target language and market** and **visual design**.

## When to Use

Use this skill when the user **explicitly requests** brand brief creation:
- "Create brand brief for [domain]"
- "Generate brand guidelines"
- "Build the brand brief"

## DO NOT USE When

- User is asking about existing brand guidelines ("Show me the brand brief")
- User wants to review guidelines without regenerating them
- Website analysis has not been completed yet
- User is checking project status

**If uncertain, ask:** "Would you like me to generate a new brand brief, or are you asking about the existing guidelines?"

## Prerequisites
- Website analysis must be completed first (use website-analyzing skill)
- The file `analysis.md` should exist in the project workspace
- The file `visual-analysis.json` should exist (from visual design analysis)
- The folder `brand-assets/` should exist (extracted reference images)
- Language/market should be confirmed in `config.json`

## Instructions

### Step 1: Read Website Analysis, Visual Data, Brand Assets, and Config
Load the analysis, visual design data, brand assets, and config from the project workspace:
```bash
cat workspace/projects/{domain}/analysis.md
cat workspace/projects/{domain}/visual-analysis.json
cat workspace/projects/{domain}/brand-assets/manifest.json
cat workspace/projects/{domain}/config.json
```

Review the `brand-assets/manifest.json` to understand:
- What types of images the brand uses (photos, illustrations, icons)
- The visual style and mood of existing imagery
- Color patterns across images

### Step 2: Generate Brand Brief Sections

Create a comprehensive brand brief with these sections:

#### Content Language & Market
- **Language**: What language to write content in
- **Country/Market**: Target geographic market for SEO
- **Location** (optional): City for local SEO targeting
- **Cultural Notes**: Any cultural considerations for content

#### Tone & Voice
- **Formality Level**: Formal / Professional / Casual / Friendly
- **Technical Complexity**: How technical should content be?
- **Personality Traits**: 3-5 adjectives (e.g., authoritative, helpful, innovative)
- **Writing Style**: Direct, conversational, academic, etc.

#### Target Audience
- **Primary Persona**: Who is the main reader?
- **Demographics**: Age range, profession, experience level
- **Pain Points**: What problems do they face?
- **Goals**: What are they trying to achieve?
- **Knowledge Level**: Beginner / Intermediate / Expert

#### Content Pillars
- **Primary Topics**: Main themes to write about
- **Secondary Topics**: Supporting themes
- **Topics to Avoid**: What not to cover

#### Voice Guidelines
- **Words to Use**: Preferred terminology and phrases
- **Words to Avoid**: Phrases that don't fit the brand
- **Example Sentences**: Sample sentences in the brand voice

#### Visual Design (from visual-analysis.json)
- **Color Palette**: Primary, secondary, and accent colors with hex codes
- **Typography Style**: Serif/sans-serif, modern/traditional
- **Visual Aesthetic**: Overall design style description
- **Design Elements**: Notable patterns (rounded corners, shadows, etc.)
- **Image Style**: Photography vs illustrations, mood, style preferences

### Step 3: Save Brand Brief

Write to `workspace/projects/{domain}/brand-guidelines.md`:

```markdown
# Brand Guidelines: {domain}

## Quick Reference
- **Tone**: [One-line summary]
- **Audience**: [Primary audience in one line]
- **Key Topics**: [Top 3 topics]
- **Content Language**: [Language] ([Country])
- **Visual Style**: [e.g., Modern minimalist with blue primary color]

---

## Content Language & Market

### Language Settings
- **Write content in**: [e.g., German]
- **Language code**: [e.g., de]
- **Target country**: [e.g., Germany]  
- **Country code**: [e.g., de]
- **Local SEO target**: [e.g., Berlin, Germany or "National"]

### Cultural Notes
- [Any cultural considerations]
- [Spelling variations: e.g., "colour" vs "color"]
- [Date formats: e.g., DD.MM.YYYY vs MM/DD/YYYY]
- [Currency: e.g., € before numbers]

---

## Tone & Voice

### Formality
[Formal / Professional / Casual / Friendly]

### Personality Traits
1. [Trait 1]
2. [Trait 2]
3. [Trait 3]

### Writing Style
[Description of writing style]

---

## Target Audience

### Primary Persona
**Name**: [Persona name]
**Role**: [Job title/role]
**Experience**: [Years/level]

### Pain Points
- [Pain point 1]
- [Pain point 2]
- [Pain point 3]

### Goals
- [Goal 1]
- [Goal 2]

---

## Content Pillars

### Primary Topics
1. **[Topic 1]**: [Brief description]
2. **[Topic 2]**: [Brief description]
3. **[Topic 3]**: [Brief description]

### Secondary Topics
- [Topic]
- [Topic]

### Topics to Avoid
- [Topic]
- [Topic]

---

## Voice Guidelines

### Preferred Phrases
- Use: "[phrase]"
- Use: "[phrase]"

### Avoid
- Don't use: "[phrase]"
- Don't use: "[phrase]"

### Example Sentences
**Good**: "[Example sentence in brand voice]"
**Bad**: "[Same message but wrong tone]"

---

## Visual Design

### Color Palette
| Role | Color | Hex Code | Usage |
|------|-------|----------|-------|
| Primary | [Color name] | [#XXXXXX] | Main brand color, headers, key elements |
| Secondary | [Color name] | [#XXXXXX] | Supporting elements, backgrounds |
| Accent | [Color name] | [#XXXXXX] | CTAs, highlights, interactive elements |
| Background | [Color name] | [#XXXXXX] | Page backgrounds |
| Text | [Color name] | [#XXXXXX] | Body text |

### Typography
- **Style**: [Serif / Sans-serif / Mixed]
- **Aesthetic**: [Modern / Traditional / Technical / Friendly]
- **Notes**: [Any specific typography observations]

### Visual Aesthetic
**Overall Style**: [e.g., Modern minimalist, Bold corporate, Playful colorful]

**Design Elements**:
- [Element 1: e.g., Rounded corners on buttons and cards]
- [Element 2: e.g., Subtle shadows for depth]
- [Element 3: e.g., Generous whitespace]

### Image Guidelines
- **Style**: [Photography / Illustrations / Icons / Mixed]
- **Mood**: [Professional / Casual / Technical / Warm]
- **Subjects**: [People / Products / Abstract / Lifestyle]
- **Color Treatment**: [Full color / Muted / High contrast / Brand-colored overlays]

---

## SEO Guidelines

### Keyword Strategy
- Primary keywords focus: [area]
- Long-tail opportunity: [area]

### Content Structure
- Preferred heading style: [style]
- Paragraph length: [short/medium/long]
- Use of lists: [frequently/sometimes/rarely]

---

*Generated on: {date}*
*Last updated: {date}*
```

### Step 4: Generate Blog Categories

Based on the content pillars, suggest 5-8 blog categories and save to `categories.json`:

```json
{
  "categories": [
    {
      "name": "Category Name",
      "slug": "category-name",
      "description": "What this category covers",
      "keywords": ["keyword1", "keyword2"],
      "priority": 1
    }
  ]
}
```

### Step 5: Flag for Human Review

After generating the brand brief:
1. Summarize key decisions made
2. Highlight any assumptions
3. Ask for human confirmation before proceeding

## Output Files
- `brand-guidelines.md` - Complete brand brief
- `categories.json` - Suggested blog categories

## Quality Checklist
- [ ] Tone is clearly defined with examples
- [ ] Target audience is specific and actionable
- [ ] Content pillars align with business goals
- [ ] Voice guidelines include do's and don'ts
- [ ] Visual design includes color palette with hex codes
- [ ] Image guidelines are specific and actionable
- [ ] Brief is under 1200 words for easy reference