Voice Reviewer

Review content against the project's voice guidelines. This skill reads the project's voice guide and lint rules, then audits content files for violations.

How It Works

1. Find the voice guide: Look for docs/brand-voice-guidelines.md, .voice-lint.json, or similar files in the project root.
2. Read the rules: Extract sentence limits, forbidden words, tone requirements, bilingual policies, and structural patterns.
3. Audit the content: Check each file against every rule.
4. Report: List violations with line numbers, the rule violated, and a suggested fix.

What to Check

Sentence Structure

• Maximum sentence length (word count per the guide, typically 20-30 words)
• One observation per sentence
• Prefer contractions
• Short to medium sentences

Forbidden Patterns

• Superlatives (best, top, must-visit, amazing, incredible)
• Exclamation points
• Emojis
• Trend slang (hits different, no cap, lowkey, vibe check as a verb)
• Hashtag energy
• Adjective stacking (cozy, intimate, must-visit spot)
• Expert/authority claims (everyone knows, locals say, the best)

Tone

• Observational over promotional
• Specific over vague
• Curious before confident
• Human, not performative
• "It felt like..." not "The best..."

Bilingual Policy (if applicable)

• Check the EN:ES ratio target (e.g., 85:15 for loops, 95:5 for rituals)
• Spanish asides stay under the word limit (typically 6 words max)
• No full content repetition in Spanish
• No Spanish in H1/H2 headings

Structural Patterns

• Arrival -> Detail -> Shift -> Release arc
• Show instead of tell
• At least one concrete sensory detail per section
• Could this paragraph exist in another city unchanged? (if yes, it needs rewriting)

Output Format

## Voice Review: [filename]

### Violations

1. **Line 23**: "This amazing, must-visit hidden gem is perfect for date night!"
   - **Rule**: No superlatives, no adjective stacking
   - **Fix**: "The place looks quiet until you sit down."

2. **Line 45**: Sentence is 31 words (max: 24)
   - **Rule**: Max sentence length
   - **Fix**: Split into two sentences.

3. **Line 67**: Spanish aside "entonces vamos a intentar algo nuevo juntos" (7 words)
   - **Rule**: Spanish asides max 6 words
   - **Fix**: Trim to "vamos a intentar algo nuevo" (5 words)

### Summary
- 3 violations found
- 0 critical (forbidden terms)
- 2 structural (sentence length, adjective stacking)
- 1 bilingual (Spanish aside too long)

Usage as a Subagent

When dispatching as a subagent, provide:

1. The file(s) to review
2. The path to the voice guide
3. The path to .voice-lint.json (if it exists)

The reviewer should read the voice guide first, then audit each file independently.