skills/ai-rag-brand-knowledge-base/SKILL.md
Build a client-specific RAG (Retrieval-Augmented Generation) knowledge base for accurate, on-brand AI output. Invoke when a client uses AI tools for content creation and needs consistent, factually correct outputs grounded in their brand, products, and audience.
npx skillsauth add peterbamuhigire/social-media-skills ai-rag-brand-knowledge-baseInstall 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.Ask for the following before proceeding:
Standard AI language models generate outputs from patterns learned across the internet. They do not know a client's brand name, product range, pricing, tone of voice, or customer context unless that information is provided in every prompt. The result: AI outputs that are generic, factually unreliable, and off-brand.
Retrieval-Augmented Generation (RAG) solves this by connecting an LLM to a client-specific document library. When a team member submits a query, the AI retrieves the relevant documents from the library first, then generates a response grounded in those documents. The output is no longer drawn from generic internet knowledge — it is drawn from the client's actual brand, products, and market context (Sweenor and Mulkers, 2024).
Practical effect for a content team:
RAG does not require technical infrastructure beyond a paid subscription to a tool such as Claude Projects or ChatGPT Projects. The investment is in document preparation, not engineering.
Organise documents into seven categories. Each category should be a separate file or section — do not combine unrelated content in a single document.
The quality of AI outputs depends directly on the quality of documents in the knowledge base. Apply these rules to every document before adding it to the base.
Use clear headings and subheadings. LLMs navigate by structure. A document with headings such as "Delivery — Kampala" and "Delivery — Upcountry" retrieves more accurately than unstructured paragraphs. Use H2 and H3 headings consistently.
One topic per document. Do not mix the brand guide with product pricing. Do not add policy terms into a tone-of-voice document. Separate files improve retrieval precision.
State facts explicitly. Write "Our standard delivery time is 2–3 business days within Kampala" not "we deliver quickly." Write "The price of [Product X] is UGX 85,000" not "competitively priced." Vague language produces vague AI outputs.
Avoid ambiguous pronouns. Use the brand name throughout, not "we" or "they." Write "Karibu Foods ships orders on Monday, Wednesday, and Friday" not "we ship three days a week."
Date-stamp every document. Add "Updated [Month Year]" to the header of every file. Example: "Updated March 2026." This prevents team members from loading outdated versions.
Remove outdated information. Stale data degrades output quality more than missing data. A discontinued product still in the knowledge base will appear in AI-generated captions. Delete or archive it. If archiving, label the file clearly: "ARCHIVED — do not load."
Select the tool that matches the client's budget, technical capacity, and primary use case.
| Tool | Best for | EA accessibility | Approx. cost | |---|---|---|---| | Claude Projects | Persistent document context per project; best for strategy, writing, and planning | Yes — browser-based, no install | Included in Claude Pro (~$20/month USD) | | ChatGPT Projects | Same functionality for OpenAI users; strong for content creation | Yes — browser-based | Included in ChatGPT Plus (~$20/month USD) | | CustomGPT.ai | Custom-branded knowledge base with shareable link and API access | Yes — cloud-based | From $49/month USD | | Notion AI | RAG within an existing Notion workspace; suits teams already using Notion | Yes — cloud-based | From $10/month USD per member | | Mem.ai | AI knowledge management with auto-organisation; suits smaller teams | Yes — free tier available | Free tier; paid from $14.99/month USD |
Recommendation for most Ugandan SME clients: Claude Projects or ChatGPT Projects. Both are accessible on standard internet connections, require no technical setup, and cost under $25/month. Recommend clients start here before investing in a dedicated platform.
Document this workflow and share it with every team member who uses the knowledge base.
Step 1 — Open the knowledge base tool. Open the designated project in Claude Projects, ChatGPT Projects, or the chosen platform. Confirm the correct project is active (not a generic session without documents loaded).
Step 2 — State the task with explicit brand context. Structure every query as: "Using our [document name], [task description] for [product/service] targeting [persona name]."
Example: "Using our brand guide and product catalogue, write an Instagram caption for the Deluxe Mattress targeting the Young Professional persona. Include the UGX price and a call to action linking to the website."
The more specific the query, the more grounded the output.
Step 3 — Review output against brand standards before publishing. Check: correct product name and price, brand tone matches the voice guide, no unverified claims, culturally appropriate for the target audience. Do not publish without this review.
Step 4 — If output is off-brand, update the knowledge base — do not just re-prompt. Re-prompting without fixing the source document produces the same error next time. Identify which document was missing or unclear, update it, date-stamp it, and reload it into the project. This is the maintenance discipline that compounds knowledge base quality over time.
Schedule a quarterly review. Assign a named owner — this is typically the social media manager or content lead.
Quarterly review checklist:
Trigger an unscheduled review when:
Prioritise these local market context documents for Ugandan and East African clients. They are the most common gap between generic AI output and locally relevant content.
Ugandan public holidays and cultural events. Load a calendar document covering the current year. Include Independence Day (9 October), Liberation Day (26 January), Martyrs' Day (3 June), Heroes' Day (9 June), Christmas, Eid al-Fitr, Eid al-Adha, and any business-relevant trade fairs, festivals, or academic events.
Local pricing context. All prices must appear in UGX first. Where USD is used (e.g. imported goods, software subscriptions), include the UGX equivalent at current rate with the date of conversion noted. AI models that only see USD pricing produce captions and copy that alienate local audiences.
Regional language preferences. Document the client's approved register: formal written English for professional sectors; relaxed English mixed with Luganda greetings for consumer brands. Include approved Luganda phrases (e.g. "Webale nnyo" for "thank you very much", "Nsanyuse" for "I am pleased/welcome") and note where each is appropriate.
Local competitor names and positioning. Name the actual Ugandan or EA competitors — not generic global ones. AI models can otherwise generate competitive comparisons referencing irrelevant international brands. Ground the comparison in the real local market.
Lamplugh, M. (2024) The AI Marketing Playbook, 2nd edn. Mercury Learning.
Sweenor, D.E. and Mulkers, Y. (2024) Generative AI Business Applications. TinyTechMedia.
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.