brand-voice
Skill9 starsChanged 8 months agoMITView on GitHub
Define and maintain brand voice and tone across all marketing channels. Use when establishing, documenting, or applying brand voice.
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 53 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
Do you have any existing voice documentation, even informal?
- Distinctive: line 122
Use this to evaluate existing content against the voice guide:
- Distinctive: line 138
Writing aspirational voice, not actual voice: Document what the brand sounds like today, then evolve deliberately.
- Distinctive: line 143
Before finalizing a voice guide, confirm:
“Common” is measured: kept by at least 6 in 10 of the 53 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Brand Voice
When to Activate
- A company needs to define its brand voice for the first time
- Existing copy feels inconsistent across channels or teams
- A rebrand or brand refresh is underway
- New writers or agencies are being onboarded
- The brand is expanding into new channels (podcast, TikTok, community)
- Customer feedback suggests the brand "sounds different" in different places
- A voice audit is requested
First Questions
- What three to five adjectives describe how you want your brand to sound?
- Who is your primary audience, and how do they speak among themselves?
- Which brands (in any industry) have a voice you admire, and why?
- What voice traits would be actively wrong for your brand?
- Are there specific contexts where your tone needs to shift (support, crisis, celebration)?
- How many people create content on behalf of the brand today?
- Do you have any existing voice documentation, even informal?
Core Concept: Voice vs Tone
Voice is your brand's personality. It stays consistent everywhere. Think of it as who you are.
Tone is the emotional inflection applied to that voice depending on context. Think of it as how you adapt to the room.
Analogy: A person's personality (voice) stays the same whether they are at a funeral or a birthday party, but their manner (tone) shifts appropriately.
Voice Attribute Framework
Define voice using three to five attribute pairs. Each pair names the trait and draws a boundary to prevent overextension.
| Attribute | But Not |
| Confident | Arrogant |
| Friendly | Flippant |
| Expert | Jargon-heavy |
| Bold | Reckless |
| Warm | Saccharine |
For each attribute, provide:
- Definition — one sentence explaining what this trait means for the brand.
- In practice — a concrete behavior (e.g., "We use first-person plural 'we' to sound inclusive").
- Boundary — where the trait crosses the line (e.g., "We never mock competitors by name").
- Before/After example — a real sentence rewritten to demonstrate the attribute.
Tone Spectrum by Context
Map tone shifts across common brand situations:
| Context | Tone Shift | Example |
| Product launch | Energetic, celebratory | "We've been building this for months — and it's finally here." |
| Customer support | Calm, empathetic, clear | "We understand this is frustrating. Here's exactly what's happening and what we're doing about it." |
| Error/outage | Direct, accountable, no humor | "Our checkout system is down. We're working on it and will update every 30 minutes." |
| Thought leadership | Authoritative, measured | "The data suggests a shift that most teams haven't accounted for yet." |
| Social/casual | Playful, conversational | "Monday called. We sent it to voicemail." |
| Crisis communication | Serious, human, transparent | "We take this seriously. Here's what we know, what we've done, and what happens next." |
| Sales enablement | Confident, benefit-focused | "Teams using [Product] close 23% faster — here's how." |
Voice Documentation Template
# [Brand Name] Voice Guide
## Our Voice in Three Words
1. [Attribute] — [one-sentence definition]
2. [Attribute] — [one-sentence definition]
3. [Attribute] — [one-sentence definition]
## We Are / We Are Not
- We are [trait]. We are not [overextension].
- We are [trait]. We are not [overextension].
- We are [trait]. We are not [overextension].
## How We Write
- Sentence structure: [short and punchy / longer and flowing / mixed]
- Vocabulary level: [accessible to all / industry-informed / technical]
- Person: [first person plural "we" / second person "you" / third person]
- Contractions: [yes / selectively / no]
- Humor: [frequent / occasional / rare / never]
- Jargon: [embrace it / translate it / avoid it]
## Tone by Situation
[Table mapping context → tone shift → example]
## Words We Love
[List of words and phrases that feel on-brand]
## Words We Avoid
[List of words and phrases that feel off-brand, with alternatives]
## Before & After Examples
[3-5 pairs showing off-brand copy rewritten on-brand, with annotations]Before/After Examples
Off-brand (generic corporate): "We are pleased to announce the launch of our new product, which leverages cutting-edge technology to deliver best-in-class solutions for enterprise customers."
On-brand (confident, clear, human): "We built [Product] because teams kept telling us the same thing: reporting takes too long. Now it takes five minutes."
Off-brand (trying too hard to be casual): "OMG you guys!!! We literally CANNOT with how amazing this update is!! You're gonna FREAK!!"
On-brand (energetic but controlled): "This update changes how you work with dashboards. We're genuinely excited — and we think you will be too."
Voice Audit Checklist
Use this to evaluate existing content against the voice guide:
- Does this sound like it was written by the same "person" as other brand content?
- Can you identify at least two of the three voice attributes in this piece?
- Is the tone appropriate for the context (support, marketing, crisis)?
- Are any "words we avoid" present?
- Would a new team member understand the brand personality from reading this?
- Does the vocabulary match the target audience's level?
- Is the humor level (if any) appropriate for the channel and situation?
- Read it aloud — does it sound natural, or forced?
Common Pitfalls
- Confusing voice with visual brand. Voice is how you write, not how you look.
- Making voice guides too abstract. "Innovative" means nothing without examples and boundaries.
- Forgetting tone shifts. A single "voice" applied identically everywhere sounds robotic or inappropriate.
- Writing aspirational voice, not actual voice. Document what the brand sounds like today, then evolve deliberately.
- No enforcement mechanism. A voice guide nobody references is decoration. Build it into review checklists and onboarding.
Quality Gate
Before finalizing a voice guide, confirm:
- Three to five voice attributes are defined with boundaries and examples
- Tone spectrum covers at least five contexts (launch, support, crisis, social, thought leadership)
- At least three before/after examples demonstrate the voice in action
- Words-we-love and words-we-avoid lists have 10+ entries each
- The guide is concise enough to be usable (not a 40-page PDF nobody reads)
- At least two stakeholders have validated that the guide "sounds like us"
- The guide includes channel-specific notes where voice adapts (email vs social vs docs)
Other versions56 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 56
- affaan-m/ECC★ 246ksame name
- HybridAIOne/hybridclaw★ 159same name
- runxhq/runx★ 97same name
- mturac/everything-openai-codex★ 89same name
- mit-network/everything-claude-code★ 76same name
- cofoundy/brand-skills★ 67same name
- jgerton/brand-toolkit★ 64same name
- Fmarzochi/EGC★ 61same name
- ysyecust/everything-claude-code★ 44same name
- MoizIbnYousaf/marketing-cli★ 33same name
46 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use brand-discovery, agent-sort and 9 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ysyecustSkillbrand-discovery
Use when a brand needs to discover or articulate its identity through structured multi-session interviews. Covers purpose, positioning, audience, personality, voice, narrative, and founder-brand tension across 8 modules using laddering, 5 Whys, and projective techniques. Produces a resumable session with disk-persisted state and a master brandbook (90_SYNTHESIS.md).
Also in 6 projects that use this
niloykumarbarmanSkillagent-sort
Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.
Also in 13 projects that use this
akachandan1Skillbrand-story
Receipts-based marketing storytelling engine for LinkedIn and X personal-brand, founder, and brand accounts. Use when the user wants to plan social content, write a LinkedIn post or X thread, research what's being said on social platforms before writing, react to a trend, or build a content calendar. Triggers: "brand story", "plan my content", "write a post", "LinkedIn post", "X thread", "tweet", "content calendar", "what should I post", "social listening", "research this topic", "react to this", "post about", "founder content".
Also in 4 projects that use this
arsalllsSkillnetwork-config-validation
Pre-deployment validation of Cisco IOS/IOS-XE configuration — catching missing saves, mismatched ACLs, overlapping subnets, duplicate IPs, missing route-maps, and dangerous commands before they cause outages.
Also in 5 projects that use this
jgertonSkillbrand-messaging
Build brand messaging using Donald Miller's StoryBrand 7-element BrandScript. Produces BrandScript, tagline, and Neumeier's trueline. Requires positioning to be at least draft status. Triggers when someone needs messaging, a tagline, brand story, or "what should we say" answers.
Also in 4 projects that use this
renepfSkillmotion-advanced
Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.
Also in 4 projects that use this
In this repository73 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ab-testingSkill
- analytics-attributionSkill
- analytics-dashboardsSkill
- cohort-analysisSkill
- marketing-reportingSkill
- brand-architectureSkill
- brand-guidelinesSkill
- brand-positioningSkill
- competitive-positioningSkill
- visual-identitySkill
- community-strategySkill
- blog-seo-writingSkill
- content-auditSkill
- content-pillarsSkill
- content-repurposingSkill
- editorial-calendarSkill
- storytelling-frameworksSkill
- thought-leadershipSkill
- ugc-strategySkill
- ad-copySkill
- copywriting-frameworksSkill
- cta-optimizationSkill
- headline-formulasSkill
- landing-page-copySkill
- microcopy-uxSkill
- sales-page-copySkill
- campaign-conceptsSkill
- cro-frameworksSkill
- funnel-designSkill
- landing-page-optimizationSkill
- email-automationSkill
- email-copywritingSkill
- email-deliverabilitySkill
- email-segmentationSkill
- email-sequencesSkill
- growth-loopsSkill
- plg-strategiesSkill
- referral-programsSkill
- viral-mechanicsSkill
- influencer-outreachSkill
- influencer-roiSkill
- martech-stackSkill
- utm-trackingSkill
- ad-creative-testingSkill
- budget-allocationSkill
- google-adsSkill
- linkedin-adsSkill
- meta-adsSkill
- retargetingSkill
- crisis-communicationSkill
- media-pitchingSkill
- competitive-analysisSkill
- go-to-marketSkill
- launch-playbookSkill
- product-positioningSkill
- press-releasesSkill
- customer-interviewsSkill
- market-researchSkill
- The first 60 shown.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

