/brand-voice-extractor

name: brand-voice-extractor
description: >
  Analyze a company's published content to extract their brand voice, writing style,
  and tone guidelines. Reads 10-20 of their best content pieces and produces a
  brand voice profile covering tone, vocabulary level, sentence structure, formatting
  patterns, CTAs, and target persona. Useful before writing outreach, content, or
  campaigns that should match a client's existing voice.
tags: [brand]

Brand Voice Extractor

Analyze a company's published content to extract their brand voice and writing style. Reads their top content pieces and produces actionable guidelines for matching their voice in future content, outreach, or campaigns.

Quick Start

Extract brand voice for [company]. Use their blog at [url].

Or with content already cataloged:

Extract brand voice for [client]. Use the content inventory at clients/[client]/research/content-inventory.json.

Inputs

| Input | Required | Source | |-------|----------|--------| | **Content URLs** | Yes | User provides, or pulled from site-content-catalog output | | **Company name** | Yes | For context in the analysis | | **Number of pages** | No | Default: 15. How many pages to analyze. |

Process

Phase 1: Select Content to Analyze

If content URLs are provided directly, use those. Otherwise:

1. Read the content inventory from `site-content-catalog` output 2. Select a diverse sample of 10-20 pages, prioritizing:

• **Blog posts** (primary voice indicator)
• **Landing pages** (marketing voice)
• **Case studies** (storytelling voice)
• Mix of recent and older content (to detect voice evolution)
• Mix of topics (to see consistency across subjects)

**Selection heuristic:**

• 8-10 blog posts (mix of how-to, opinion, product updates)
• 2-3 landing pages (homepage, product page, solutions page)
• 2-3 case studies or customer stories (if available)
• 1-2 comparison/vs pages (if available)

Phase 2: Fetch and Extract Text

For each selected URL: 1. WebFetch the page 2. Extract the main content body (strip nav, footer, sidebar) 3. Store: title, URL, raw text, word count

Phase 3: Analyze Voice Dimensions

Analyze across these dimensions:

A) Tone

• **Formality spectrum:** Casual ↔ Professional ↔ Academic
• **Emotional register:** Excited ↔ Measured ↔ Dry
• **Authority stance:** Peer/friend ↔ Expert/teacher ↔ Institution
• **Humor usage:** Frequent ↔ Occasional ↔ None
• **Directness:** Direct/bold ↔ Hedged/diplomatic

B) Vocabulary & Language

• **Reading level:** Approximate grade level (simple vs. complex)
• **Jargon usage:** Heavy industry jargon ↔ Plain language
• **Technical depth:** Assumes expertise ↔ Explains everything
• **Power words:** Common persuasion/action words they favor
• **Banned patterns:** Words or phrases they conspicuously avoid
• **Unique vocabulary:** Distinctive terms or phrases they use repeatedly

C) Sentence Structure

• **Average sentence length:** Short/punchy ↔ Long/complex
• **Paragraph length:** 1-2 sentences ↔ 3-4 ↔ 5+
• **Opening patterns:** How they start articles (question, stat, story, bold claim)
• **Transition style:** How they connect ideas
• **Use of fragments:** Do they use incomplete sentences for emphasis?

D) Formatting Patterns

• **Headers:** Frequency, style (question-based, how-to, numbered)
• **Lists:** Bullets vs. numbered, frequency
• **Bold/italic:** How they use emphasis
• **Images/media:** Frequency, types (screenshots, illustrations, photos)
• **CTAs:** Placement, style, frequency, language used
• **Pull quotes/callouts:** Do they use them?

E) Content Structure

• **Typical article length:** Short (<800), Medium (800-1500), Long (1500+)
• **Introduction style:** Hook type, length
• **Conclusion style:** Summary, CTA, open question
• **Use of data/stats:** Frequent ↔ Rare
• **Use of examples:** Frequent ↔ Rare
• **Storytelling:** Narrative-driven ↔ Information-driven

F) Persona & Audience

• **Who they write for:** Inferred target reader (role, seniority, industry)
• **Assumed knowledge level:** Beginner ↔ Intermediate ↔ Expert
• **Point of view:** First person singular (I) ↔ First person plural (we) ↔ Second person (you) ↔ Third person
• **Reader relationship:** Peer ↔ Teacher ↔ Service provider

Phase 4: Generate Brand Voice Profile

Produce a Markdown document with this structure:

# Brand Voice Profile: [Company Name]
**Analyzed:** [Date] | **Content pieces analyzed:** [N]
**Sources:** [list of URLs analyzed]

---

## Voice Summary (2-3 sentences)

[Company] writes in a [tone] voice that [description]. Their content targets
[audience] and assumes [knowledge level]. The overall feel is [adjectives].

---

## Tone Profile

| Dimension | Position | Evidence |
|-----------|----------|----------|
| Formality | [e.g., Professional-casual] | [Example quote] |
| Emotional Register | [e.g., Measured, occasionally excited] | [Example] |
| Authority | [e.g., Expert/teacher] | [Example] |
| Humor | [e.g., Rare, dry when used] | [Example] |
| Directness | [e.g., Very direct, bold claims] | [Example] |

---

## Language & Vocabulary

### Reading Level
[Grade level estimate and what that means]

### Signature Phrases
- "[phrase 1]" — used frequently to [purpose]
- "[phrase 2]" — recurring pattern in [context]

### Jargon & Technical Depth
[How much industry jargon they use, how they handle technical concepts]

### Words They Love
[List of frequently used power words, adjectives, verbs]

### Words They Avoid
[Notable absences or patterns they steer away from]

---

## Structure & Formatting

### Typical Article Structure
[Outline of how their articles are typically organized]

### Sentence & Paragraph Style
- Average sentence length: [X words]
- Typical paragraph: [X sentences]
- Notable patterns: [fragments, rhetorical questions, etc.]

### Formatting Habits
- Headers: [style]
- Lists: [frequency and style]
- Emphasis: [bold/italic patterns]
- CTAs: [where, h