---
name: marketing-brand
description: Audit brand positioning and voice — audience clarity, differentiation, positioning statement, value framing, buzzword discipline and audience-centric tone — producing a 0-100 score, A-F grade and prioritized fixes. Use when the user asks to review, define, or improve brand messaging, positioning, taglines, or about pages.
version: 1.0.0
agent: claude
triggers:
  - "review my brand messaging"
  - "improve my positioning"
  - "is my value proposition clear"
  - "brand voice audit"
  - "write a positioning statement"
---

# Brand Voice & Positioning Audit

Audit brand messaging for positioning clarity, differentiation, value framing
and tone. Produces a **0-100 score**, an **A-F grade**, and **prioritized
recommendations**.

## Prerequisites

```bash
pip install -r requirements.txt
```

(Or, if the repo is installed as a package: `pip install -e .`)

## Procedure

1. **Run the audit** on the brand copy (tagline, homepage, about page):

   ```bash
   python -m marketing_kit.cli brand --file about.txt --format json
   ```

2. **Read the output.** `details` shows `audience_signals`,
   `differentiation_signals`, `positioning_signals`, `value_signals`,
   `buzzword_count`, `you_count` and `we_count`.

3. **Summarize for the user**, ranked highest-severity first:
   - Is the audience named?
   - Is there a clear differentiator versus the alternative?
   - Is there a positioning statement (audience + outcome + proof)?
   - Is the tone audience-centric or company-centric?
   - Are buzzwords standing in for proof?

4. **Offer to rewrite:**
   - Draft a positioning line: "We help [audience] [outcome] by [differentiator]."
   - Replace buzzwords with concrete, verifiable claims.
   - Re-center copy on the reader ("you").

5. **Re-run the audit** after changes to confirm the score improved.

## Notes

- The engine scores the text you give it. Feed it your real homepage and about
  copy, not just a tagline, for a useful reading.
- Pair with `marketing-copy` to polish the wording once the positioning is set.