Skip to content
This repository was archived by the owner on Apr 27, 2026. It is now read-only.

aptratcn/skill-brand-voice

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Skill Brand Voice

Give your AI agent a consistent brand voice. 8-stage brand therapy, tone calibration, content templates. Zero dependencies.

No more generic AI content

   ╔══════════════════════════════════════════════════════════════╗
   ║               🎯 BRAND THERAPY: 8 STAGES                    ║
   ╠══════════════════════════════════════════════════════════════╣
   ║                                                              ║
   ║   1. 🎯 Purpose ──────── Why does this brand exist?          ║
   ║          │                                                   ║
   ║   2. 🧬 Personality ──── If the brand were a person?        ║
   ║          │                                                   ║
   ║   3. 🎵 Tone ─────────── How does it sound?                 ║
   ║          │                                                   ║
   ║   4. 📖 Vocabulary ───── What words are uniquely ours?       ║
   ║          │                                                   ║
   ║   5. 🎨 Visual Language ─ How does voice connect to visuals? ║
   ║          │                                                   ║
   ║   6. ⚖️ Values ────────── What beliefs guide communication?  ║
   ║          │                                                   ║
   ║   7. 🚧 Boundaries ───── What's off-brand?                  ║
   ║          │                                                   ║
   ║   8. 📖 Story ─────────── What's our narrative arc?          ║
   ║                                                              ║
   ╚══════════════════════════════════════════════════════════════╝

Why This Exists

A brandvoice PR was submitted to anthropics/skills (122K★) but never merged. Kami (2133★) proves content quality is the #1 trending topic. No standalone pure-markdown brand voice skill exists anywhere. This fills that gap.

Before & After

❌ Before: Generic AI Output

Thank you for your inquiry. We would like to inform you that our product offers a comprehensive suite of features designed to enhance your productivity. Our solution leverages cutting-edge technology to deliver world-class results. Please do not hesitate to reach out if you require further assistance.

✅ After: Brand-Aligned Output (Bold voice)

You've got a problem. We built the fix.

Ship 3x faster with tools that actually work. No bloat. No learning curve. Just results.

Try it free →

The difference? Same information. One puts you to sleep. The other makes you click.

Quick Start

1. Create your brand voice profile

brand_voice:
  name: "My Brand"
  personality: ["bold", "direct", "optimistic"]
  tone:
    formality: 40
    warmth: 60
    enthusiasm: 80
  vocabulary:
    preferred: ["ship", "craft", "transform"]
    banned: ["synergy", "leverage", "world-class"]
  taglines:
    primary: "Build fast. Ship faster."

2. Add to your agent workspace

Save as brand-voices/my-brand.yaml in your workspace directory.

3. Reference in SOUL.md

## Brand Voice

See `brand-voices/my-brand.yaml` for complete brand voice guidelines.

Quick reference:
- Personality: bold, direct, optimistic
- Tone: casual-formal, warm, enthusiastic
- Signature words: ship, craft, transform

4. Done

Your AI agent now has a consistent brand voice across all communications.

Custom Brand Voice vs Default Agent Tone

Aspect Default Agent Tone Custom Brand Voice
Personality Helpful, neutral, beige Distinctive, memorable, yours
Consistency Varies per prompt Systematically consistent
Vocabulary Generic English Signature words, banned words
Templates None Brand-voice-ready formats
Scoring No quality check Consistency score 0-100
Multi-brand One-size-fits-all Switch between clients
Audience Same for everyone Adapted per audience
Identity Forgettable Recognizable

Features

  • 🎯 Brand Therapy — 8-stage process to define brand identity
  • 🎭 6 Voice Profiles — Professional, Casual, Bold, Empathetic, Witty, Authoritative
  • 🎚️ Tone Calibration — Adjust formality, warmth, technicality, enthusiasm per channel
  • 📝 5 Content Templates — Email, blog, social, docs, landing page
  • 📖 Vocabulary Governance — Banned words, preferred terms, taglines
  • Consistency Checker — Score any text 0-100 against brand guidelines
  • 👥 Audience Adaptation — Developers, executives, consumers, internal
  • 🔄 Multi-Brand Support — Switch between client brands
  • 5-Minute Quick-Start — Extract brand voice from existing content
  • 🔗 SOUL.md Integration — Persistent brand identity in your agent

Voice Profiles

Six pre-built profiles ready to use:

Profile Best For Vibe
Professional B2B, enterprise, regulated Competent, reliable, thorough
Casual B2C, social, community Friendly, approachable, genuine
Bold Startups, challenger brands Confident, direct, unapologetic
Empathetic Healthcare, support, wellness Understanding, patient, warm
Witty Consumer brands, entertainment Clever, playful, irreverent
Authoritative Thought leadership, docs Expert, decisive, experienced

Consistency Checker

Score any text against your brand voice:

Check this content against my brand voice:
[Paste content]

Brand profile:
[Paste profile or reference file]

Get a score 0-100 with specific improvement suggestions:

Consistency Score: 72/100

- Personality alignment: 18/25 — Hedging reduces boldness
- Tone match: 20/25 — Formality slightly too high
- Vocabulary usage: 14/20 — Used banned word "leverage"
- Style consistency: 12/15 — Paragraphs slightly too long
- Values alignment: 8/15 — Missing clear next steps

Suggestions:
1. Replace "we think" with "we know"
2. Replace "leverage" with "use"
3. Add bullet points to paragraph 3
4. End with clear next steps

Multi-Brand Support

For agencies and consultants managing multiple brands:

brand_registry:
  brands:
    - name: "TechStartup"
      profile: "brand-voices/tech-startup.yaml"
      active: true
    - name: "EnterpriseClient"
      profile: "brand-voices/enterprise.yaml"
      active: false

Switch with: "Use EnterpriseClient voice for this task"

Works With

  • Claude Code — Drop SKILL.md in .claude/skills/
  • OpenClaw — Drop in workspace/skills/
  • Any AI agent that reads markdown skill files

Zero Dependencies

Pure markdown. No npm, no pip, no API keys, no build step. Just copy the file and go.

License

MIT — Use it for anything. Credit appreciated but not required.


Stop sounding like every other AI. Start sounding like you.

About

Give your AI agent a consistent brand voice. 8-stage brand therapy, tone calibration, content templates. Zero dependencies.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors