plugins/skjalden/skills/brand-voice-implementation/SKILL.md
Brand voice implementation in code — formality spectrum, tone attributes, personality archetypes, UI copy tone selection (plain speech vs brand voice), channel-specific guidelines, and voice consistency checking across components.
npx skillsauth add hjemmesidekongen/ai brand-voice-implementationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Four levels: Formal (legal, investor, crisis), Professional (B2B, whitepapers, case studies), Conversational (blog, social, email), Casual (community, behind-scenes). Pick one level per context and hold it consistently.
Choose 3-5 for the brand: Authoritative, Friendly, Trustworthy, Educational, Inspiring, Innovative, Witty (use sparingly). These stay constant — formality shifts by context, personality doesn't.
Pick one primary, one secondary: The Expert (knowledgeable, data-driven), The Friend (warm, supportive, relatable), The Innovator (bold, forward-thinking), The Guide (wise, step-by-step, patient), The Motivator (energetic, empowering, action-oriented).
| Plain Speech (default) | Brand Voice (earned moments) | |------------------------|------------------------------| | Product UI, buttons, labels | 404 pages, empty states | | Documentation, help text | Onboarding flows | | Error messages, settings | Loading states, celebrations | | Billing, payment flows | Marketing copy, announcements |
Plain speech: clear, direct, functional. Brand voice: adds personality where users have time to appreciate it. Default to plain speech.
Active voice 80%+. "You/your" more than "we/our". One idea per sentence. Benefits before features. Lead with the main point. Short paragraphs (2-3 sentences for web). Avoid: very, really, just, maybe, hopefully, synergy, leverage, innovative, disruptive. Replace with specific alternatives.
Oxford comma always. One exclamation mark max per piece. Title Case for H1, sentence case for H2+. Spell out 1-9, numerals for 10+. Gender-neutral language.
See references/process.md for persona-to-tone mapping, channel guidelines, messaging pillars, inclusivity rules, and the brand voice consistency checklist.
development
Creates a brand from scratch through market research and interactive sparring. Runs competitive research via Perplexity, then guides the user through positioning, audience, voice, values, and content pillars. Produces the full brand guideline set at .ai/brand/{name}/. Use when building a new brand, defining brand strategy for a product, or when /våbenskjold:create is invoked.
testing
Loads brand guidelines from .ai/brand/{name}/ and makes them available to the current context. Progressive disclosure: L1 confirms brand exists, L2 loads summary, L3 loads specific files on demand. Use when a downstream skill or user needs brand context, or when /våbenskjold:apply is invoked.
documentation
Guided reinvention of an existing brand guideline. Loads current brand from .ai/brand/{name}/, identifies what to keep vs change, and walks the user through targeted evolution. Preserves brand equity while updating positioning, voice, or values. Use when refreshing a brand or when /våbenskjold:evolve is invoked.
development
Codifies an existing brand from materials, samples, and references. Analyzes provided content to extract voice patterns, values, and positioning. Produces the same guideline format as brand-strategy. Use when a brand already exists but isn't documented, or when /våbenskjold:audit is invoked.