skills/ai-readiness-diagnostic/SKILL.md
Conducts a 41-item diagnostic to assess a client's AI marketing maturity, identify their current AI Marketing Canvas step (1–5), and produce a scored maturity profile with a prioritised action plan. Invoke this skill when a client wants to understand where they stand on AI adoption, before beginning any AI strategy, tool selection, or training investment. Based on Venkatesan and Lecinski (2026) The AI Marketing Canvas, 2nd edition, Stanford Business Books.
npx skillsauth add peterbamuhigire/social-media-skills ai-readiness-diagnosticInstall 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.Assess a client's current AI marketing maturity across five domains, calculate their AI Marketing Canvas step, and produce a practical, prioritised action plan that reflects their actual starting point. Output is structured for a non-technical business owner to read and act on immediately.
After completing this diagnostic, refer the client to the sister skill
ai-marketing-canvas-assessment for full canvas completion and strategic
roadmap development.
Ask for the following before beginning:
Then walk through all 41 diagnostic questions together with the client, recording Y (Yes) or N (No) for each item. Do not skip questions. If the client is genuinely uncertain, default to N and note it for follow-up.
Count the number of YES answers in each domain:
| Domain | Items | Max Score | |---|---|---| | 1. Data Foundation | 1–8 | 8 | | 2. Technology Stack | 9–16 | 8 | | 3. Team Capability | 17–24 | 8 | | 4. AI Deployment | 25–33 | 9 | | 5. Business Impact | 34–41 | 8 | | Total | 1–41 | 41 |
| Total Score | Canvas Step | |---|---| | 0–8 | Step 1 — Foundation | | 9–16 | Step 2 — Experimentation | | 17–24 | Step 3 — Expansion | | 25–32 | Step 4 — Transformation | | 33–41 | Step 5 — Reinvention |
Apply these thresholds to identify specific gap areas:
| Domain | Score | Interpretation | |---|---|---| | Data Foundation | 0–3 | Critical gap — no AI programme can succeed without this | | Technology Stack | 0–3 | Tool gaps limit what AI can do | | Team Capability | 0–3 | Training is the priority before any tool investment | | AI Deployment | 0–4 | Experimentation is the immediate priority | | Business Impact | 0–3 | Either early stage or AI is not yet being measured |
Produce the following five sections in order.
Present a clean table showing:
Example format:
| Domain | Score | Status | |---|---|---| | Data Foundation | 3/8 | Critical | | Technology Stack | 5/8 | Developing | | Team Capability | 4/8 | Developing | | AI Deployment | 2/9 | Critical | | Business Impact | 1/8 | Critical | | Total | 15/41 | Step 2 — Experimentation |
Write one paragraph in plain English explaining:
Be honest. If the client is at Step 1, say so directly and explain what that means without softening the message into vagueness.
Source: Venkatesan, R. and Lecinski, J. (2026) The AI Marketing Canvas, 2nd edn. Stanford Business Books.
Identify the three most urgent gaps based on domain scores and individual question responses. Rank them most urgent first. For each gap:
Structure three 30-day blocks. Include exactly three named, specific actions per block. Actions must be concrete (name a tool, name a process, name a person or role).
Days 1–30: Stabilise the Foundation
Days 31–60: Build Capability
Days 61–90: Begin Deployment
Calibrate ambition to the client's step. A Step 1 client's 90-day plan is about getting basic data and tools in place — not deploying AI-powered personalisation.
Recommend tools appropriate to the client's current Canvas step and the East African market. Prioritise:
Step 1–2 tool recommendations to consider:
| Need | Tool | Tier | |---|---|---| | CRM | HubSpot CRM | Free | | Email marketing | Mailchimp | Free up to 500 contacts | | Social scheduling | Buffer | Free (3 channels) | | Website analytics | Google Analytics 4 | Free | | AI content creation | ChatGPT (GPT-4o) | Free / Plus at ~UGX 130,000/month | | AI content creation | Gemini | Free | | Automation | Zapier | Free (5 zaps) | | WhatsApp automation | Africa's Talking | Pay-as-you-go, UGX-compatible | | SMS automation | Africa's Talking | Pay-as-you-go |
Step 3–4 tool recommendations to consider:
| Need | Tool | Tier | |---|---|---| | CRM with automation | HubSpot Starter | From ~USD 20/month | | AI writing at scale | Jasper or Copy.ai | From ~USD 39/month | | Social listening | Brandwatch Lite or Mention | From ~USD 29/month | | Reporting | Looker Studio | Free | | AI analytics | Polymer or Akkio | From ~USD 20/month | | Chatbot | Tidio or Landbot | Free tier available |
Note the WhatsApp advantage: if the client is already using WhatsApp for customer communications, this counts toward the Technology Stack domain and can be formalised quickly via Africa's Talking or similar APIs.
Most Ugandan and East African SMEs score between 4 and 12 on this diagnostic, placing them at Step 1 or early Step 2. This is not a failure — it reflects the market's current stage of AI adoption.
Common patterns to look for:
training-client-team skill provides a structured training programme.Once the diagnostic score is known, map the client's AI readiness to the 2×2 Use Case Matrix:
| | Internal | External | |---|---|---| | Productivity | Automate internal workflows: reporting, content briefs, data analysis | Scale customer-facing functions: chatbots, FAQs, WhatsApp automation | | Growth | Build proprietary data and algorithmic advantages | Deliver personalised customer experiences at scale |
Recommendation by score: (Convert raw score to percentage: total ÷ 41 × 100)
Identify which wave the client currently operates in:
Ask the client: "Which wave best describes your current AI marketing activity?" Use their answer to calibrate the roadmap in the final section.
Venkatesan, R. and Lecinski, J. (2026) The AI Marketing Canvas, 2nd edn. Stanford Business Books.
Chaffey, D. (2024) Digital Marketing: Strategy, Implementation and Practice. Pearson.
Bodnar, K. and Cohen, J. (2012) The B2B Social Media Book. Wiley.
Nayebi, F. (2025) Foundations of Agentic AI for Retail. Gradient Divergence.
For full canvas completion and strategic roadmap development, use the sister
skill ai-marketing-canvas-assessment after completing this diagnostic.
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.