skills/playbook-social-media-brand-style-guide/SKILL.md
Generates a complete, formatted Social Media Brand Style Guide ready to hand over to a client's social media manager or in-house team. The guide covers brand voice, platform tone adjustments, vocabulary standards, emoji policy, image and video standards, hashtag rules, content approval workflow, breaking-news pause protocol, and language and grammar rules — everything an executor needs to maintain brand consistency without consultant oversight. Invoke when onboarding a new client (before content production begins), whenever a client's social media manager changes, or when a client requests a standalone governance document for their team.
npx skillsauth add peterbamuhigire/social-media-skills playbook-social-media-brand-style-guideInstall 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 complete, formatted Brand Style Guide as a client-ready deliverable. This is not advice or a framework — it is a finished document the client hands to whoever manages their social media. Every section must be filled in with client-specific content. Placeholder text must not appear in the final output.
Apply British English throughout. Follow the east-african-english skill for prose register. Default to the Uganda/East Africa market unless the client specifies otherwise.
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.If the 04-brand-voice-intake has already been completed for this client, request that document and extract the inputs from it. Do not ask the client to repeat information already captured.
If 04-brand-voice-intake has not been completed, collect the following before generating anything:
Generate the guide as a complete, headed document in the following order. Use the section titles exactly as listed.
State the three client-supplied tone adjectives. For each adjective, produce a "we are X, not Y" pairing that clarifies where the brand sits on a spectrum:
| We are… | We are not… | |---|---| | [Adjective 1 — e.g. Warm] | [Its shadow side — e.g. Familiar to the point of being unprofessional] | | [Adjective 2] | [Its shadow side] | | [Adjective 3] | [Its shadow side] |
Follow this table with a tone scale statement using the format below. Mark the brand's position with [HERE]:
Formal ←————————[HERE]————————→ Informal
Write one sentence explaining why this position is correct for this brand and audience.
Write one paragraph (5–7 sentences) that any new team member reads before writing a single word for this client. Describe the brand voice as if describing a person: who are they, what do they say, what do they never say? This paragraph must be specific to this client — it must be impossible to apply it to a different brand without rewriting.
For each platform the client uses, generate a tone guide entry. Omit platforms the client is not active on and does not plan to use.
Use this format for each platform:
[PLATFORM NAME]
Tone in one sentence: [How the brand sounds on this specific platform]
Rules:
Example post: [A worked example using this client's actual product or service — not a generic placeholder]
Cover the following platforms if in scope:
Facebook — conversational, community-focused. Lead with a question or an invitation. Short paragraphs. This is where the brand acts as a neighbour, not a broadcaster.
Instagram — visual-first, aspirational or relatable depending on personas. The caption supports the image. The first line must work without the "more" button. Hashtags go at the end.
LinkedIn — professional, credibility-driven. Lead with an industry observation or data point. Full sentences. One strong idea per post. No more than one emoji if used at all.
WhatsApp — personal, direct, value-led. Treat every message as a one-to-one conversation, not a broadcast. Lead with context and value. One clear call to action. Maximum three sentences.
TikTok — energetic, entertaining, hook-first. The first word of the caption and the first second of video must earn attention. Use the vocabulary the audience actually uses.
X / Twitter — concise, opinionated, topical. One strong idea per post. Cut every word that is not working. A take or a question — never a press release.
List 10–15 preferred terms drawn from the client's tone adjectives, industry, and EA professional register. Format as a table:
| Word or Phrase | Why it fits this brand | |---|---| | [Term] | [One-line rationale] |
List 10–15 terms to avoid: overused marketing clichés, off-brand language, competitor terms, and anything that conflicts with the tone attributes. Always include the standard EA avoid list: "groundbreaking", "revolutionary", "game-changing", "amazing", "awesome", "unleash", "skyrocket". Format as a table:
| Word or Phrase | Why to avoid | |---|---| | [Term] | [One-line rationale] |
List every product, service, campaign, or internal term that has a specific approved spelling or formatting. Misuse of these terms in published content is not acceptable.
| Term | Correct usage | Common error to avoid | |---|---|---| | [Product/service name] | [Exact spelling and capitalisation] | [e.g. Do not abbreviate; do not lowercase] |
State the policy clearly:
State the overall emoji philosophy in one sentence (e.g. "This brand uses emojis functionally and sparingly — they support the message, they do not replace it.").
| Platform | Emojis permitted? | Maximum per post | Approved types | |---|---|---|---| | Facebook | Yes / Sparingly / No | [Number] | [e.g. Functional and expressive] | | Instagram | Yes / Sparingly / No | [Number] | | | LinkedIn | Sparingly / No | [Number — recommend 0–1] | [Functional only] | | WhatsApp | Yes / Sparingly / No | [Number] | | | TikTok | Yes / Sparingly / No | [Number] | | | X / Twitter | Yes / Sparingly / No | [Number] | |
Define the policy for each category:
List 5–8 specific emojis that are off-brand for this client, with a one-line note for each:
| Emoji | Reason to avoid | |---|---| | 🔥 | Overused; signals hype rather than substance | | 💯 | Informal and aggressive in tone | | 🚀 | Start-up cliché; does not fit this brand's register | | [Add client-specific entries] | |
Emojis are never used in:
| Platform | Format | Recommended ratio | Notes | |---|---|---|---| | Facebook Feed | Image / Video | 1:1 or 4:5 | 4:5 maximises screen space on mobile | | Facebook Stories | Image / Video | 9:16 | Full screen; leave 14% top and bottom safe zone | | Instagram Feed | Image / Video | 1:1 or 4:5 | 4:5 preferred | | Instagram Stories | Image / Video | 9:16 | Same safe zone as Facebook Stories | | Instagram Reels | Video | 9:16 | | | TikTok | Video | 9:16 | | | LinkedIn | Image | 1200 × 627px (1.91:1) | Landscape preferred for link posts | | WhatsApp | Image | 1:1 or 4:5 | Avoid cropping faces | | X / Twitter | Image | 16:9 or 1:1 | | | YouTube Thumbnail | Image | 16:9 | 1280 × 720px minimum |
State the watermark rule clearly:
| Colour role | Hex code or description | When to use | |---|---|---| | Primary | [Code] | Dominant colour in all graphics | | Secondary | [Code] | Accents and contrast | | Accent | [Code] | Calls to action; use sparingly | | Background | [Code] | Default graphic background | | Text on dark | [Code] | Overlays on dark images | | Text on light | [Code] | Overlays on light images |
Colours to avoid: [List any colours associated with competitors or that clash with the palette.]
| Platform | Recommended length | Maximum | |---|---|---| | Facebook Feed | 60–90 seconds | 3 minutes | | Instagram Reels | 15–30 seconds | 90 seconds | | TikTok | 15–60 seconds | 3 minutes | | LinkedIn | 30–90 seconds | 10 minutes | | YouTube | 5–15 minutes | No limit | | WhatsApp Status | 15–30 seconds | 30 seconds |
Longer formats require client approval before production.
List 1–3 branded hashtags unique to this client. For each:
#[Hashtag]
Advise the client to search each hashtag on Instagram and TikTok before first use to confirm it is not in widespread use by another brand.
State the protocol:
Provide a set of supplementary hashtags for reach. These are not branded — they rotate:
Branded hashtags are permanent. Community hashtags are refreshed monthly. Campaign hashtags are retired at campaign end.
| Platform | Recommended | Maximum | Notes | |---|---|---|---| | Instagram | 5–10 | 30 | Place at end of caption or in first comment | | Facebook | 2–3 | 5 | Fewer hashtags perform better on Facebook | | LinkedIn | 3–5 | 5 | Industry and professional topic hashtags only | | TikTok | 3–5 | 8 | Include at least one trending hashtag where relevant | | X / Twitter | 1–2 | 2 | Embedded in sentence where possible | | WhatsApp | 0 | 0 | No hashtags in WhatsApp messages |
Before adding a new hashtag to the rotation:
| Role | Name | Responsibility | |---|---|---| | Content Drafter | [Name] | Writes and designs all content; creates the draft for review | | Content Reviewer | [Name or "not applicable"] | Reviews for brand voice, accuracy, and grammar before approval | | Content Approver | [Name] | Final sign-off before any post is scheduled or published |
For time-sensitive posts (breaking news response, event announcements, same-day promotions):
The following content types require explicit approval from [Approver name/role] before drafting begins — not just before publishing:
When a significant national or regional event occurs — a national tragedy, a major disaster, a public figure's death, civil unrest, or any event that dominates national conversation — all scheduled content must be paused immediately.
Pause all scheduled and planned content when:
Resume normal content only when:
Apply these rules consistently across all platforms and all content types.
east-african-english skill for guidance| Type | Format | Example | |---|---|---| | Numbers 1–9 | Spell out | "three locations", "seven days" | | Numbers 10 and above | Numerals | "15 products", "100 customers" | | Large numbers | Numeral + word | "1.2 million", "50,000 customers" | | Percentages | Numeral + % (no space) | "25%" not "25 percent" in social copy | | Telephone numbers | Local format | +256 700 000 000 |
Output meets production standard when it satisfies all of the following:
tools
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.