| name | 01-client-brief |
| description | Generates a structured client intake questionnaire and two onboarding documents — a full client brief and a one-page at-a-glance card — capturing all information required before producing any strategy, content plan, or platform audit. Invoke at the start of every new client engagement, before any other onboarding or strategy skill is used. |
Client Brief Generator
Produce two outputs: (1) a full client brief document and (2) a one-page client at-a-glance card. The questionnaire doubles as a fillable document to send to the client and as a discovery call guide for the consultant. Apply the east-african-english skill for tone throughout. Do not begin generating content until the questionnaire has been completed.
Use when
- Generates a structured client intake questionnaire and two onboarding documents — a full client brief and a one-page at-a-glance card — capturing all information required before producing any strategy, content plan, or platform audit. Invoke at the start of every new client engagement, before any other onboarding or strategy skill is used.
- Use this skill when it is the closest match to the requested deliverable or workflow.
Do not use when
- Do not use this skill for graphic design, video production, software development, or legal advice beyond the repository's stated scope.
- Do not use it when another skill in this repository is clearly more specific to the requested deliverable.
Workflow
- Collect the required inputs or source material before drafting, unless this skill explicitly generates the intake itself.
- Follow the section order and decision rules in this
SKILL.md; do not skip mandatory steps or required fields.
- Review the draft against the quality criteria, then deliver the final output in markdown unless the skill specifies another format.
Anti-Patterns
- Do not invent client facts, performance data, budgets, or approvals that were not provided or clearly inferred from evidence.
- Do not skip required inputs, mandatory sections, or quality checks just to make the output shorter.
- Do not drift into out-of-scope work such as code implementation, design production, or unsupported legal conclusions.
Outputs
- A structured onboarding, strategy, or planning document in markdown, ready to hand off to the next skill in the workflow.
References
- Use the inline instructions in this skill now. If a
references/ directory is added later, treat its files as the deeper source material and keep this SKILL.md execution-focused.
Required Input
This skill generates the questionnaire itself — no prior input is required. The client (or the consultant on the client's behalf) fills in the questionnaire. If the consultant provides partial information upfront, pre-fill what is known and flag remaining gaps clearly.
Part A: Questionnaire — Send to Client or Use in Discovery Call
Present each section as a clearly labelled block. Use the exact question wording below.
Section 1: Business Overview
- What is the full legal name of your business and the trading name (if different)?
- What industry or sector does your business operate in?
- In which year was the business founded?
- How many full-time employees or team members does the business have? (Ranges: 1–5 / 6–20 / 21–50 / 51–200 / 200+)
- Where is the business based? (City, country — and any other locations if relevant)
- In one or two sentences, what is your unique value proposition — what do you offer that your competitors do not?
- What is your primary business goal for the next 12 months?
Section 2: Target Audience
- Who is your primary customer? Describe them in terms of:
- Age range
- Gender (if relevant to your market)
- Location (city, region, or national)
- Approximate income level or economic segment (e.g. middle income, upper middle, high net worth)
- Occupation or sector
- Is your business B2C (selling to individuals), B2B (selling to other businesses), or both?
- Are there secondary audiences you also want to reach? If yes, describe them briefly.
Section 3: Current Social Media Presence
Complete one row per active platform. If you are not active on a platform, leave it blank.
| Platform | Handle / URL | Approx. follower count | How often do you post? | Date of last post | Who currently manages the account? |
|---|
| Facebook | | | | | |
| Instagram | | | | | |
| WhatsApp Business | | | | | |
| TikTok | | | | | |
| LinkedIn | | | | | |
| X / Twitter | | | | | |
| YouTube | | | | | |
| Other | | | | | |
- How would you rate the current performance of your social media overall? (1 = very poor, 5 = very good)
- What has worked well on social media so far, if anything?
- What has not worked or what problems have you encountered?
Section 4: Competitors
- List 3–5 direct competitors. For each, provide:
| Competitor name | Industry / what they sell | Their main social media platform and handle |
|---|
| 1. | | |
| 2. | | |
| 3. | | |
| 4. (optional) | | |
| 5. (optional) | | |
- Which competitor's social media presence do you most admire and why?
- Which competitor's approach do you want to be clearly different from?
Section 5: Content Goals
-
Tick all content goals that apply to your business:
-
If you had to choose just one primary goal, which would it be?
Section 6: Tone of Voice
- Choose three adjectives that best describe how your brand should sound on social media:
Example words to choose from (or provide your own): Professional, Warm, Bold, Friendly, Authoritative, Approachable, Energetic, Calm, Innovative, Traditional, Playful, Serious, Inspiring, Practical, Premium, Accessible
Your three words: _________________ / _________________ / _________________
- List two or three brands — anywhere in the world — whose social media tone you admire. What do you like about each?
- List two or three brands whose tone you absolutely do NOT want to sound like. What puts you off?
Section 7: Brand Guidelines
- Do you have existing brand guidelines? (Yes / No / In progress)
- Logo files available? (Yes — please share / No — we will work with what you have)
- Brand colours: (Provide hex codes if known, e.g. #1A73E8; or describe: "dark green and gold")
- Primary colour: _______________
- Secondary colour: _______________
- Accent colour (if any): _______________
- Fonts: (Name the fonts used in your brand, if known)
- Heading font: _______________
- Body font: _______________
- Are there any visual styles you want to avoid? (e.g. certain colours, stock photography, cluttered layouts)
Section 8: Posting Frequency and Expectations
- How often do you expect content to be posted per week, per platform? (Your expectation)
- Are there particular days or times you believe your audience is most active?
- Do you have a content calendar already, or will one need to be built from scratch?
Section 9: Budget for Paid Social Media
-
Do you have a budget available for paid social media advertising (boosted posts, Facebook/Instagram ads)?
-
If yes, is the budget intended for boosting organic content, running dedicated ad campaigns, or both?
Positioning Questions
USP / Differentiation:
"What is the one thing your business does or delivers that your closest competitor does not — or cannot — do as well?"
Mission:
"In one sentence: what does your business do, for whom, and what outcome does it deliver?"
Vision:
"Where do you want this business to be in three years? What does success look like specifically?"
Niche:
"Describe your single most ideal client — their sector, size, location, and the specific problem they have that you solve best."
These answers feed directly into biz-dev-positioning and all strategy and content work. Collect them at intake and store in the client file.
Section 10: Internal Approval Workflow
- Who must approve content before it is published? (Name and role)
- What is the expected turnaround time for approvals? (e.g. 24 hours, 48 hours)
- Will approvals happen via a shared tool (e.g. Google Drive, Trello, email), or do you have a preferred method?
- Are there multiple approval stages? (e.g. team lead reviews first, then director approves)
Section 11: Content Restrictions
- Are there any topics your business must never post about on social media?
- What is your policy on mentioning competitors? (Never / Only positively / Can reference if factual)
- Does your business operate in a regulated industry? (e.g. financial services, healthcare, alcohol, legal services, education) If yes, are there specific disclaimers or compliance requirements that apply to social media content?
- Are there any past incidents — public complaints, PR issues, or sensitive situations — that the content team should be aware of?
Section 12: Reporting Preferences
- How often would you like to receive performance reports? (Weekly / Fortnightly / Monthly)
- What format do you prefer for reports? (PDF summary / Shared Google Doc / In-person review meeting / All three)
- Who should receive reports? (Names and email addresses)
- What metrics matter most to you? (e.g. follower growth, engagement rate, reach, website clicks, leads generated)
Part B: Outputs — Generate After Questionnaire is Complete
Once the questionnaire is filled in, generate the following two documents in order.
Output 1: Full Client Brief Document
Structure the completed brief as a professional document with the following sections. Write in full sentences where appropriate; use tables for structured data.
- Business Overview — name, industry, founding year, size, location, unique value proposition, 12-month business goal
- Target Audience — primary and secondary audience profiles using the demographics provided; note whether B2B, B2C, or both
- Social Media Presence — reproduce the platform table with a one-line consultant commentary on each active platform
- Competitors — named competitors with handles; note the one the client most admires and the one they want to differ from
- Content Goals — primary goal in bold; all secondary goals listed; note any tensions between goals
- Tone of Voice — three brand adjectives; admired brands summary; brands to avoid and why
- Brand Guidelines — colours, fonts, logo status; note any visual restrictions
- Posting Frequency — client's expectation vs. the consultant's recommended starting frequency (see note below)
- Budget for Paid Social — selected budget band; intended use
- Approval Workflow — approver name and role, turnaround time, approval method
- Content Restrictions — topics to avoid, competitor mention policy, regulatory constraints, any past issues to be aware of
- Reporting Preferences — frequency, format, recipients, priority metrics
Posting frequency guidance note: Where the client's expectation is unrealistic, flag it professionally. Recommended starting frequencies for Uganda/EA market:
- Facebook: 4–5 posts per week
- Instagram: 3–4 posts per week
- LinkedIn: 2–3 posts per week
- TikTok: 3–5 short videos per week
- WhatsApp: 1–2 broadcast messages per week (not daily)
Output 2: Client At-a-Glance Card
Generate immediately after the full brief. Format as a compact one-page summary for the wider team. Include:
| Field | Content |
|---|
| Business name | |
| Industry | |
| Location | |
| Active platforms | (list with handles) |
| Primary goal | |
| Secondary goals | |
| Tone in three words | |
| Approval contact | (name, role, turnaround time) |
| Content restrictions | (one line per restriction) |
| Posting targets | (per platform — recommended frequency) |
| Paid budget band | |
| Report recipient(s) | |
Add a Consultant Notes field at the bottom: flag any ambiguities, missing information, or follow-up questions that need resolving before strategy work begins.
Quality Criteria
- Both outputs are generated from the same completed questionnaire — no information is contradicted between the two documents
- The full brief covers all twelve sections; no section is skipped or left empty without a clear note explaining why
- Posting frequency recommendations are grounded in Uganda/EA platform norms, not generic global benchmarks
- Content restrictions are stated plainly and unambiguously so any team member can act on them without seeking clarification
- Tone adjectives are carried forward accurately and will be usable by the
04-brand-voice-intake skill
- The at-a-glance card fits a single page; no section contains more detail than is needed for quick reference
- British English spelling is used throughout; tone follows the
east-african-english skill
- The consultant notes field in the at-a-glance card identifies at least one follow-up item where information is missing or unclear
Pre-brief filter (added 2026-05-04 from Levy + Deacon)
Three checks to apply during intake — before scoping or pricing:
1. Top-10 Not-UX-Strategies anti-pattern check (Levy)
See docs/ux-foundations.md Section 2 for the full list. During intake, score the client's stated goal against the Top-10. If the goal matches any anti-pattern, push back before scoping. Document the pushback in the brief itself under a "Brief filters applied" subsection so future audits can trace the conversation.
Most common matches in social-media intakes:
- "We need a killer Instagram strategy" → matches #1 (a killer idea) — push back, ask what problem the client is solving
- "We want viral content" → matches #5 (motivational generic) — push back, ask which persona for what action
- "We just need posts that look like [trending brand]" → matches #4 (buzzword permutation) — push back, ask what differentiated promise
2. Three Levels of UX Scope declaration (Deacon)
Every brief must declare which level the engagement targets:
- Single Interaction — one platform, one campaign, one task. Most engagements live here.
- Journey — multi-channel, multi-device, time-sequenced (e.g., social → email nurture → website). Opt-in upgrade.
- Relationship — overall brand experience across all touchpoints. Rare; treat as a separate engagement bundle.
Add the level declaration as a required field in the intake questionnaire and the at-a-glance card.
3. Field-of-Dreams flag (Levy)
If the brief contains no validated user research and no plan to acquire it, mark the brief as "speculative" rather than "execution-ready." This affects pricing — speculative work cannot be priced as a delivery engagement; it must be priced as a discovery engagement first.
If the client refuses discovery and demands execution-priced delivery on a speculative brief, decline the work or document the risk acceptance in writing.
