skills/04-brand-voice-intake/SKILL.md
Develops the client's social media brand voice guide and visual identity brief — a single standalone document covering tone attributes, platform tone adjustments, vocabulary, emoji policy, hashtag identity, and photography and design direction. Invoke after the 01-client-brief and 03-audience-personas are complete, and before any content writing, caption writing, or platform playbook work begins. This document is the tone reference every team member reads before writing anything for the client.
npx skillsauth add peterbamuhigire/social-media-skills 04-brand-voice-intakeInstall 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.
Produce one standalone brand document. This is the definitive tone and identity reference for the client account. It covers written voice, platform adjustments, vocabulary, emoji and hashtag policy, and visual identity direction for briefing a designer. Apply the east-african-english skill for tone throughout this document's own prose — but note that the brand voice being defined may differ from EA standard if the client specifies a different style.
SKILL.md; do not skip mandatory steps or required fields.references/ directory is added later, treat its files as the deeper source material and keep this SKILL.md execution-focused.Ask for the following before generating anything:
If the three tone adjectives are missing, do not proceed — they are the foundation of all voice decisions. Ask for them.
Derive 4–6 tone attributes from the three client adjectives. Each attribute is a nuanced phrase that clarifies how the adjective applies in practice — not a synonym.
Format for each attribute:
Attribute [N]: [Attribute phrase — e.g. "Warm but professional"]
Definition: One sentence explaining what this means in practice for this brand. Be specific — do not write a dictionary definition.
Right:
Wrong:
Repeat for all 4–6 attributes.
Guidance on deriving attributes from adjectives:
Write one paragraph (5–7 sentences) that the entire team reads before writing anything for this client. Synthesise all tone attributes into a coherent description of who this brand sounds like. Use the analogy of a person: if this brand were a person walking into a room, who would they be? What would they say? What would they never say?
This paragraph must be client-specific — it should be impossible to copy it to a different client without rewriting.
Example register: "[Client name] sounds like a trusted colleague who has genuinely useful advice — never a salesperson, never an academic. The brand speaks plainly, uses real-world examples, and treats the audience as intelligent adults who have seen enough marketing to recognise when they are being sold to. It is warm but efficient: it respects the reader's time. It does not shout to be heard. On the rare occasions it celebrates an achievement, it is brief and backs it up with evidence. It never uses the word 'groundbreaking'."
The brand voice is consistent across all platforms. The tone adjusts to match platform norms. Generate a platform adjustment for every platform the client is active on, plus any the client plans to use.
For each platform, provide:
Sample message for worked examples: Use a product or service announcement relevant to the client's industry. If no specific announcement is available, use: "[Client name] is pleased to introduce [new product/service], now available at [location/online]."
Rewrite this announcement in the correct tone and format for each platform:
TikTok
X / Twitter
Only include platforms the client is active on or has confirmed plans to use. If a platform is not relevant, omit it.
Generate 10–15 brand-specific terms, preferred vocabulary, and power words. Draw from:
east-african-english skillFormat as a list with a one-line note on why each term fits the brand:
| Word / Phrase | Why it fits | |---|---| | [Term] | [One-line rationale] |
Generate 10–15 items — jargon, competitor terms, off-brand language, and anything that conflicts with the tone attributes. Include:
Format as a list with a one-line note on why each term is off-brand:
| Word / Phrase | Why to avoid | |---|---| | [Term] | [One-line rationale] |
State the emoji policy for this brand clearly. Decisions should align with the tone attributes — a "professional and authoritative" brand uses fewer emojis than a "warm and approachable" brand.
Platform-by-platform emoji usage:
| Platform | Emojis used? | Frequency | Types appropriate | Notes | |---|---|---|---|---| | LinkedIn | Yes / No / Sparingly | (e.g. max 1–2 per post) | Functional ✅ only | | | Facebook | | | | | | Instagram | | | | | | WhatsApp | | | | | | TikTok | | | | | | X / Twitter | | | | |
Emoji types — define the policy:
Emojis to avoid — list 5–8 emojis that are off-brand for this client with a brief note on why. Common candidates: 🔥 (overused), 💯 (informal/aggressive), 😂 (too casual for professional brands), 🚀 (startup cliché).
Generate 1–3 branded hashtags unique to this client. Requirements:
For each hashtag:
#[Hashtag]
Provide guidance on supplementary hashtags — not branded, but relevant for reach:
State clearly: branded hashtags are permanent; community hashtags rotate; trending hashtags are time-limited.
This section is guidance for briefing a graphic designer or photographer. It does not produce design files. The output is a written brief the client can hand to their designer.
State clearly and briefly:
Using colours from the 01-client-brief (hex codes if provided):
| Colour role | Colour (hex or description) | When to use | |---|---|---| | Primary | | Main brand colour — dominant in all content | | Secondary | | Supporting colour — used for accents and contrast | | Accent | | Highlight colour — used sparingly for CTAs | | Background | | Default background for graphics | | Text on dark | | Colour used for text overlays on dark images | | Text on light | | Colour used for text overlays on light images |
Note any colours to avoid — especially colours associated with competitors or that clash with brand colours.
Using fonts from the 01-client-brief:
Do:
Do not:
east-african-english skilltools
Generates a foundational social media training guide for clients and their teams who are completely new to social media marketing, or who have been posting without any strategic understanding. Invoke when the user says "write a social media basics guide", "create a beginner training document", "the client doesn't understand social media", "start-here training", or when a client needs to understand social media before any strategy or content work begins. Distinct from training-client-team (operational handover of an existing strategy) and training-diy-content (content creation for self-managing clients). This skill covers what social media is, how it works, and how to approach it intelligently — the conceptual foundation that makes all downstream strategy work land.
tools
Generates a practical smartphone video production training guide for East African clients and content teams. Covers shooting, audio, lighting, framing, editing, and platform-specific formats using only a smartphone — no professional equipment required. Invoke this skill when a client or their team needs to produce their own social video content and requires a hands-on, jargon-free training document tailored to EA field conditions.
tools
Generates a complete DIY content creation handbook for clients who want to manage some or all of their own content after the initial strategy engagement. Invoke when the user says "write a DIY content guide", "create a self-managed content handbook", "the client wants to manage their own content", or when a handover guide is needed at the end of a strategy engagement. Output is a self-contained reference document — not a training presentation — that the client keeps and uses independently.
tools
Generates a complete 2-hour in-person training workbook for a client's internal team — employees who will assist with content creation or community management. Invoke when the user says "create a team training guide", "write a staff training workbook", "onboard our internal team on social media", or needs a printable workshop document for client employees. Output is a structured, print-ready workbook — not a presentation deck.