gooseworks-ai/brand-voice-extractor

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, how often, what language]

---

## Audience & Persona

### Target Reader
[Role, seniority, industry, pain points they address]

### Knowledge Assumptions
[What they assume the reader already knows]

### Point of View
[I/we/you usage and what it signals]

---

## Writing Guidelines (Actionable)

Use these guidelines when writing content, outreach, or campaigns for [Company]:

### Do
- [Guideline 1 with example]
- [Guideline 2 with example]
- [Guideline 3 with example]

### Don't
- [Anti-pattern 1]
- [Anti-pattern 2]
- [Anti-pattern 3]

### Voice Samples

**Their style:**
> [2-3 representative quotes from their content that exemplify the voice]

**How to match it:**
> [2-3 example sentences written in their voice about a neutral topic]

Tips

• 15 pages is the sweet spot. Fewer than 10 won't capture enough variation. More than 25 adds cost without much signal.
• Blog posts are the best voice signal. Landing pages are more formulaic. Blog posts show the authentic voice.
• Look for consistency AND inconsistency. If their tone shifts dramatically between content types, note it — they may have multiple voice modes.
• Check for ghost-written content. If some posts feel dramatically different, they may use external writers. Flag this in the analysis.
• This skill has no code script. It's an agent-executed skill — the AI agent reads the content via WebFetch and performs the analysis directly. The structured output template above guides the analysis.

Dependencies

• Web fetch capability (for reading content pages)
• Optional: site-content-catalog output (for selecting which content to analyze)
• No API keys or paid tools required