skills/playbook-ai-content-workflow/SKILL.md
Generates a step-by-step operational guide for integrating AI tools into a client's social media content production process — covering tool selection, brand voice calibration, a core prompt library (with reference to the full prompt-engineering-library), quality control, content maturity staging, and a clear list of what AI must never be used for. Draws on frameworks from Upadhyay (2024) and Schaefer (2025). Invoke this skill when a client is already using AI tools without a structured process, when onboarding a new client who wants to scale content production, or when a consultant needs to document and hand over an AI-assisted content workflow to an in-house team. This skill does not replace the brand voice guide (04-brand-voice-intake) or the content calendar (11-content-calendar) — it plugs them into an AI-assisted production system.
npx skillsauth add peterbamuhigire/social-media-skills playbook-ai-content-workflowInstall 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.
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.Collect the following before generating the playbook:
Start with two tools only: ChatGPT and Canva. Add others once the workflow is established. Recommending ten tools at once guarantees none of them get used consistently.
| Tool | What It Does | EA Access | |---|---|---| | ChatGPT (OpenAI) | Text generation, ideation, caption drafting, copywriting | Free tier via browser; no app required | | Claude (Anthropic) | Text generation, longer-form drafting, analysis | Free tier via browser | | Canva Magic Write / Magic Design | AI-generated social graphics with copy suggestions | Free tier; used directly in Canva | | Grammarly | Grammar check, tone review, British English correction | Free browser extension and web app | | CapCut AI Captions | Automatic captions for videos; available on mobile | Free; works on Android and iOS | | Google Gemini | Research assistance, ideation, summarisation | Free via Google account | | Magai / Poe | Multi-model AI access in one interface | Paid; for advanced users only | | HeyGen | AI video production; talking-head avatars | Paid; for advanced video users | | Tavus | Personalised AI video at scale | Paid; for advanced personalisation workflows | | NotebookLM | AI podcast production from source documents | Free (Google); browser-based | | Frase.io | Content optimisation, pruning, and gap analysis | Paid; for content-mature clients | | Make.com | Workflow automation and multi-tool pipelines | Free tier; for Stage 3–4 clients | | Descript | AI audio and video editing; transcription | Paid; for clients producing audio/video | | AdCreative.ai | AI-generated ad creative variations | Paid; for clients running paid social |
Content pruning note (Source: Roth & neuroflash, 2024/2025): removing or updating outdated content is as important as new creation. Use Frase.io or manual audits quarterly to identify and refresh content that is no longer accurate, performing, or relevant. A content library that grows without pruning accumulates liability.
Starting recommendation: Use ChatGPT for all text work and Canva for all graphic work. Both have free tiers, both work on a basic smartphone or laptop, and both are already familiar to most EA users. Introduce Grammarly in week two as a mandatory quality step. Defer all other tools until the core workflow is running smoothly.
Complete this step before any AI content is generated. It is not optional — skipping it produces generic output that sounds like every other brand in the client's industry.
Before building the Brand Context Block, run brand-voice-ai-training. That skill executes the full 6-step process: extracting tone words from real client language, building the vocabulary avoid list, generating reference examples, and producing an AI-ready voice profile. The Brand Context Block below draws directly from that output.
This is a reusable prompt prefix. Paste it at the start of every new AI session. Complete every bracketed field before use. Fields are populated from the brand-voice-ai-training output and 04-brand-voice-intake.
You are writing social media content for [Brand Name], a [industry] business
based in [city], Uganda. Our brand voice is [tone word 1], [tone word 2], and
[tone word 3]. We speak to [persona description — e.g. "urban women aged 25–40
who value quality and convenience"]. We always use British English spelling —
never American spellings. We never use the following words or phrases:
[vocabulary avoid list]. Our content pillars are: [pillar 1], [pillar 2],
[pillar 3]. Do not use these words under any circumstances: delve, tapestry,
leverage, game-changer, groundbreaking, revolutionary, navigate, foster, realm,
unleash, unlock, elevate.
ChatGPT Custom Instructions (recommended): Go to your profile → Custom Instructions → paste the completed Brand Context Block into the "What would you like ChatGPT to know about you?" field. This loads automatically into every new conversation.
Session-start paste method: Keep the completed Brand Context Block in a shared Google Doc or WhatsApp Saved Messages. Paste it as the very first message in any new AI session before asking for content.
Team use: If more than one person is generating content for the same client, share the completed Brand Context Block in the team WhatsApp group. Everyone uses the same block. A team using different context blocks will produce inconsistent content.
After four weeks of use, review the AI outputs against the brand voice. If a pattern of off-brand outputs persists, adjust the block:
Update the shared Brand Context Block document every time you make a change. Date each version.
Every effective AI prompt contains five elements (Upadhyay, 2024):
| Element | What It Does | Example | |---|---|---| | Alpha — Role | Assigns expertise to the AI | "You are writing for a Kampala-based SME…" | | Beta — Context | Provides background and brand parameters | The Brand Context Block | | Gamma — Task | States the specific output required | "Write a 150-word Instagram caption about…" | | Delta — Constraints | Sets limits (length, tone, language, exclusions) | "Under 100 characters. British English. No hashtags." | | Epsilon — Output format | Specifies how the result should be presented | "Output: 3 numbered options." |
The Brand Context Block covers Alpha and Beta. Every prompt below adds Gamma, Delta, and Epsilon. Do not remove any element.
Copywriting frameworks available: The core prompts below use PAS (Problem–Agitate–Solution) and AIDA (Attention–Interest–Desire–Action) by default. For the full library of 7 frameworks — PAS, AIDA, BAB, FAB, SSS, PPPP, and AFOREST — plus 7 additional ready-to-use templates, invoke prompt-engineering-library.
All prompts specify British English output. Do not remove this instruction.
Prompt 1 — Short caption (under 100 characters, Instagram / WhatsApp)
[CONTEXT BLOCK] Write a short social media caption of under 100 characters for [platform]. The post is about [topic or product]. Include one relevant emoji. Do not include hashtags. Output: one caption only. British English.
Prompt 2 — Medium caption (100–200 characters, Facebook / LinkedIn)
[CONTEXT BLOCK] Write a social media caption of 100–200 characters for [platform]. The post is about [topic or product]. Open with a strong first line that stops the scroll. Include a call to action at the end. Do not include hashtags. Output: two caption options to choose between. British English.
Prompt 3 — Carousel or thread (5–7 slides / tweets)
[CONTEXT BLOCK] Write a [5-slide carousel / 6-tweet thread] about [topic]. Each slide/tweet should make one clear point. Open with a hook that creates curiosity. Close with a call to action linking to [desired action]. Output: numbered slides or tweets, one line each. British English.
Prompt 4 — Monthly content ideas from pillars
[CONTEXT BLOCK] Generate 30 social media content ideas for [month]. Distribute evenly across these pillars: [pillar 1], [pillar 2], [pillar 3]. Include a mix of educational, entertaining, and promotional content. For each idea: content type (post, Reel, Story, carousel), pillar, and a one-sentence description. Output: numbered table. British English.
Prompt 5 — Seasonal or campaign content ideas
[CONTEXT BLOCK] Generate 10 social media content ideas for [occasion — e.g. Eid, end of financial year, back to school]. Relevant to [industry] and the Ugandan/East African context. For each idea: platform, format, one-sentence description. Output: numbered list. British English.
Prompt 6 — Hashtag set for a specific post
[CONTEXT BLOCK] Suggest 15 relevant hashtags for a [platform] post about [topic]. Include: 3 broad hashtags (over 1 million uses), 6 mid-range (100k–1 million uses), 6 niche (under 100k uses). Include at least 2 Uganda or East Africa specific hashtags. Output: three labelled groups. British English.
Prompt 7 — Long content to short social post
[CONTEXT BLOCK] I have the following long-form content: [paste blog post, article, or transcript]. Extract the 3 most valuable insights and write a separate caption for each, suitable for [platform]. Each caption: 100–150 words, ends with a call to action. Output: 3 numbered captions. British English.
Prompt 8 — Response to a complaint or negative review
[CONTEXT BLOCK] Write a response to the following complaint on [platform]: "[paste complaint]". Acknowledge the issue, apologise without admitting legal liability, offer to resolve privately via WhatsApp or DM, under 80 words. Do not be defensive. Output: one response. British English.
For email subject lines, blog post outlines, positive review responses, video transcript captions, and the full 15-template set, invoke prompt-engineering-library.
Every AI-generated output must pass all six checks before it is published. Run the checks in order. Do not skip steps under time pressure.
For thought leadership posts, strategy documents, personal brand content, or any post where audience trust is the currency: signal that a human wrote or heavily shaped this content. Do not just assert it — show it (Schaefer, 2025). Methods:
Apply this standard whenever the content is making a claim to authority, expertise, or personal experience.
For AI humanisation of draft content before publishing, invoke ai-content-humaniser.
AI does not replace the weekly content process — it compresses the time required for each step.
Monday — AI Drafting (10 minutes) Open ChatGPT. Paste the Brand Context Block. Run Prompt 4 to confirm the week's topics if not already planned. Run Prompt 1 or 2 five times, once per post. Save all five drafts in a shared Google Doc or Notion page labelled "[Client] — Week of [date] — AI drafts."
Monday — Human Review and Edit (30 minutes) Open the five drafts. Run the Quality Control Protocol on each one. Add the human touch element to each caption. Mark the status: Approved / Needs Revision / Reject. For any rejected draft, re-prompt or write the caption manually — do not publish a draft that failed a quality check.
Monday — Scheduling (20 minutes) Load approved captions into Buffer or Hootsuite. Assign dates and times. Attach images. Set all posts to schedule (not auto-publish) so the client can review before anything goes live.
Total time with AI: 60 minutes per week
| Task | Without AI | With AI | |---|---|---| | Researching and writing 5 captions | 75 minutes | 10 minutes (AI draft) + 30 minutes (edit) | | Hashtag selection per post | 15 minutes | 5 minutes | | Scheduling in Buffer/Hootsuite | 20 minutes | 20 minutes (unchanged) | | Total per week | 110 minutes | 65 minutes | | Total per month (4 weeks) | 7.3 hours | 4.3 hours | | Monthly saving | — | 3 hours per client |
For a consultant managing five clients, AI-assisted workflows free up to 15 hours per month — time that goes back into strategy, client relationships, and business development.
For advanced automation (scheduling triggers, auto-repurposing pipelines, multi-platform distribution), invoke playbook-ai-automation-workflow.
Assess where the client currently sits before prescribing tools or workflows. Introducing automation to a client at Stage 1 creates chaos, not efficiency (Upadhyay, 2024).
| Stage | Description | AI Use at This Stage |
|---|---|---|
| 1 — Basic | Posting inconsistently; no strategy; content reactive | Use AI for ideation and caption drafting only. Establish posting rhythm first. |
| 2 — Aligned | Regular posting; brand voice defined; pillars in use | Use AI for full caption workflow, hashtag research, and repurposing. This playbook is designed for Stage 2. |
| 3 — Multichannel | Consistent across 3+ platforms; content plan in place | Use AI for cross-platform adaptation, email subject lines, and blog outlines. Add prompt-engineering-library. |
| 4 — Automated | Workflows documented; team trained; scheduling system live | Use AI for scheduling triggers, performance-based content adjustments, and reporting summaries. Add playbook-ai-automation-workflow. |
Identify the client's current stage in the playbook introduction. Do not prescribe Stage 4 tools to a Stage 1 client.
These are structural limitations — not tool failures that future updates will fix. Understanding them prevents misplaced reliance (Schaefer, 2025).
brand-voice-ai-training; do not try to generate it from a prompt.These prohibitions are not suggestions. Each one exists because real harm — to the client, the audience, or the consultancy — is the predictable outcome of ignoring it.
playbook-crisis-communications for the correct protocol.brand-voice-ai-training — real conversations, real examples, real dislikes. AI cannot do this work.Apply this guidance to every client account. When in doubt, disclose — audiences in the EA market are becoming more sophisticated about AI use, and proactive transparency builds rather than erodes trust.
Disclose — required: Use a clear label ("AI-generated image" or "Created with AI") when AI-generated images are used in advertising, editorial features, or any context where the audience might assume the image depicts a real person, place, or event.
Disclose — best practice: If a post is substantially AI-generated (drafted and published with only minor edits), a light disclosure such as "Created with AI assistance" builds long-term audience trust. Use it selectively on posts where the AI role was significant.
No disclosure required: Using AI as a drafting tool that is then substantially edited, rewritten, and personalised by a human is industry-standard practice and does not require disclosure.
For the formal client AI content policy document covering legal considerations and disclosure obligations, invoke policy-ai-content-ethics.
Apply these notes when generating content for each platform. Generic AI outputs underperform on every platform — these adjustments close the gap.
LinkedIn B2B audiences on LinkedIn — especially professionals in Kampala, Nairobi, and Lagos — are increasingly skilled at recognising AI-generated posts. The tell: perfectly structured paragraphs, no personal specificity, and generic professional language. Always add a personal observation, a specific client experience, or a genuine professional opinion. If the post reads like a thought leadership template, re-prompt or rewrite.
TikTok AI-written scripts sound scripted on camera — and TikTok audiences will skip within two seconds. Use AI for the opening hook only (the first line or first visual idea). Film the rest naturally and conversationally. CapCut AI captions are the single most useful AI application for TikTok — use them on every video.
WhatsApp Broadcast message recipients know when they are reading a template. AI-written WhatsApp messages have a generic warmth that is immediately recognisable. Use AI to draft the structure, then rewrite in the client's natural voice. Heavy personalisation (name, recent purchase, specific context) is mandatory. Never send a broadcast without at least one personal element per recipient segment.
Instagram Feed captions are well-suited to AI drafting — quality control and a human edit produce good results. Stories and Reels voice-overs must be authentic. If the client is speaking on camera, they should speak from bullet points, not read an AI script. Use AI to generate caption options for Reels after filming — not to script what the creator says.
Email
Subject lines are the highest-value AI application in email marketing — run Prompt 8 from prompt-engineering-library and test multiple options. Email body copy benefits from an AI draft that is then substantially edited: check every claim, rewrite the opening paragraph in the client's real voice, and ensure the call to action matches the actual offer.
Source: Ching & Mothi (2025). A prompt library that never changes is a library that never improves. Document how the agency refines prompt templates over time.
What triggers a prompt update:
How updates are documented:
caption-facebook-PAS-v1, caption-facebook-PAS-v2How improved prompts are shared:
This practice turns one-off prompting into a learning system. A library built over 12 months is a proprietary agency asset.
Source: Mizrahi (2024); Evelyn (2025). Add as an explicit quality control step for all content making factual, statistical, or market-specific claims.
Gate instruction: For any draft containing specific statistics, market data, product claims, named entities, dates, or prices — include this instruction in the prompt:
"Use web search to find the latest news and resources, and cite your sources."
Then verify the cited sources independently before human review. Do not assume web-search output is correct; check the linked source directly.
This gate applies in addition to the Accuracy Check in Section 4. The Accuracy Check applies to all content; the Hallucination Gate specifically applies to content making claims of fact that the audience might act on — statistics in proposals, market data in strategy documents, product specifications in captions.
Source: Evelyn (2025). In multi-step production workflows, AI loses coherence as context accumulates across exchanges.
Key rule: Do not assume context carries across sessions. If continuing a production workflow from a previous session, re-paste the Brand Context Block before issuing any new content instruction.
In-session practice: In long sessions (more than 8–10 exchanges), re-state key context: "Remember: the brand is [X], tone is [Y], platform is [Z]." Reference previous outputs explicitly: "Using the caption you wrote in step 2, now write a matching Story caption." Never assume the AI remembers.
Team practice: When a different team member continues a session or picks up a draft, share the full conversation thread or paste a session summary — not just the prompt.
Source: Ching & Mothi (2025). For AI-generated audio and visual assets, tag original AI-generated files with persistent metadata or watermarks before any editing or compression.
This practice protects the agency if AI-generated content is later disputed, and establishes a chain of custody for client deliverables.
| Skill | When to Use It |
|---|---|
| brand-voice-ai-training | Step 0 — before any AI content is generated for a new client |
| prompt-engineering-library | Full prompt set (15 templates, 7 copywriting frameworks) |
| ai-content-humaniser | Making AI drafts sound human before publishing |
| playbook-ai-automation-workflow | Stage 3–4 clients; scheduling triggers and pipeline automation |
| playbook-crisis-communications | Any reputational incident — do not use AI for crisis response |
| policy-ai-content-ethics | Formal AI disclosure and legal compliance documentation |
All content produced through the workflow documented in this playbook must pass through the ai-content-humaniser before client delivery. This is not optional and is not a step that can be omitted under time pressure. AI-generated or AI-assisted drafts must meet the Golden Rule: every output must look, feel, and sound as if it was crafted by the most skilled human creative with deep knowledge of the target audience. Generic, flat, or culturally misaligned output is not acceptable regardless of how efficiently it was produced.
Output meets production standard when it satisfies all of the following:
brand-voice-ai-training as the source for tone words and vocabularytools
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.