skills/playbook-question-engine/SKILL.md
Systematic process for mining customer questions from five sources and converting them into a content pipeline of blog posts, social posts, video scripts, and FAQs that rank organically and answer what the audience is already searching for. Invoke when a client has no content strategy, when content ideas have run dry, when the client asks what to post, or when the goal is to generate content that reduces sales friction by pre-educating prospects before they speak to the business.
npx skillsauth add peterbamuhigire/social-media-skills playbook-question-engineInstall 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.
Sources: Westergaard (2016) Get Scrappy; Marcus Sheridan's River Pools case study
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 generating any deliverable:
The most effective content answers the questions customers are already asking. Marcus Sheridan's River Pools company grew from near-bankruptcy to the most-visited swimming pool website in the world by one method: answering every customer question in writing — including the uncomfortable ones. "How much does a pool cost?" "What are the problems with fibreglass pools?" "How do we compare to [competitor]?" Answering the questions competitors avoid is the highest-leverage content tactic available (Westergaard, 2016).
The East African equivalent: Be the business in the market that everyone goes to when they have a question. In communities where trust is built through information-sharing, the business that gives away knowledge freely is the business people recommend.
Collect questions from all five sources each month. Target: 20 raw questions per month minimum.
The receptionist, sales team, and customer service team hear customer questions daily. These people are a gold mine. Many businesses never ask them.
Action: Brief every customer-facing team member to capture one question per week that a customer asked which is not yet answered in the business's content. Use a shared WhatsApp group or a simple Google Sheet.
Sample briefing message: "Every time a customer asks you something this week, note it down. We're going to turn those questions into content. There are no silly questions — the more specific, the better."
Mine Instagram, Facebook, TikTok, and WhatsApp for recurring questions. A question asked by 10 different people in different ways is a content gap, not an individual customer query.
Action: Review the last 90 days of social media comments and DMs. Identify questions that appear more than twice. Export to the question list.
Tool: Meta Business Suite comment history; TikTok Creator Studio comments; WhatsApp Business chat search.
Use Google Search Console (free) to identify the search queries bringing visitors to the website — including partial matches and long-tail phrases. These are real searches from real people who want the answer.
Action:
If Google Search Console is not yet set up: Use Google's "People Also Ask" box — search for the client's main service or product and record every question that appears in the PAA box. These are Google's most common related queries.
Review the business's existing FAQ page, WhatsApp saved replies, email template library, and any printed customer information documents. Every saved reply is evidence of a recurring question.
Action: List every saved WhatsApp reply and email template. Treat each as an answered question. Cross-reference against the content library — if the answer exists as a saved reply but not as a blog post or social post, it is a content gap.
Review the notes or recordings from the last 20 sales enquiry conversations. What objections came up? What did the prospect not understand before they spoke to the business? What question, if answered in advance, would have reduced hesitation?
Action: Interview the owner or sales lead with this question: "In the last month, what question came up most often in sales conversations that slowed down the decision?" That question becomes the first content piece.
Run all five source reviews in the first week of each month. Collect raw questions without filtering. Target 20+ questions per month. Record every question exactly as the customer asked it — in their language, not the business's language.
Group similar questions together. "How much does X cost?", "What is the price of X?", "Is X expensive?", and "Can I afford X?" are all the same question — cluster them into one content brief.
The Big 5 are the five question categories that generate the highest search volume and the greatest sales acceleration. Prioritise content from these categories before any other topic:
| Category | What buyers are asking | Why this is urgent | |---|---|---| | Pricing and Cost | "How much does [product/service] cost?" "What affects the price?" "Is there a cheaper option?" | Price is the most-searched topic in almost every industry; businesses that answer it first own the category in search | | Problems and Limitations | "What are the problems with [product/service]?" "When does [solution] not work?" | Buyers conduct due diligence before purchase; honest answers build trust faster than silence | | Comparisons | "[Brand A] vs [Brand B]" "What is the difference between [option 1] and [option 2]?" | Buyers in the consideration stage actively compare; appear in their research or lose the sale to whoever does | | Reviews | "Is [company/product] any good?" "What do customers say about [brand]?" "Best [product category]" | Social proof is the deciding factor for many buyers; reviews content appears in Google and YouTube search | | Best in Class | "Best [product type] in [city/country]" "Which [service] should I choose?" "Top [service providers] in Uganda" | Buyers seeking the best option are close to a decision; ranking content at this stage converts directly |
Score each question cluster against the Big 5: Big 5 questions get highest priority. Non-Big 5 questions fill the calendar after the primary gaps are addressed.
Also score on: | Dimension | Scoring | |---|---| | Search volume / enquiry frequency | How often is this question asked? (High / Medium / Low) | | Sales relevance | If this question were answered, would it accelerate a purchase decision? (High / Medium / Low) |
Prioritise questions that score High on both dimensions. Price and cost questions, comparison questions, and problem questions typically score highest on both.
Match each prioritised question to the best content format:
| Question type | Best format | Distribution | |---|---|---| | Pricing and cost | Blog post + short video | Website, YouTube, Facebook | | Comparison ("us vs. competitor") | Long-form article | Website, LinkedIn | | Problems / limitations | Honest FAQ (text) | Website, WhatsApp saved reply | | How-to / process | Video + checklist | YouTube, Instagram, WhatsApp | | Best in category / buyer's guide | Long-form article or PDF | Website, email newsletter | | Quick facts | Instagram carousel or Facebook post | Social media only |
Every 90 days, review content performance:
Double down on the topics and formats generating the most enquiry traffic. Retire or update content that no longer reflects current pricing, processes, or services.
Most businesses refuse to answer:
These are the highest-value content pieces precisely because competitors avoid them. A prospect searching "how much does [service] cost in [city]" and finding an honest, detailed answer from the client's website arrives at the conversation pre-qualified and ready to proceed.
Answering limitations builds trust: "Here is when our service is not the right fit for you" is counterintuitive but highly effective — it signals confidence, honesty, and selectivity. Prospects who continue after reading a limitation are more committed buyers.
Generate a monthly Question Engine report containing:
Once the content library is built, deploy it proactively in the sales process. This is called Assignment Selling: the practice of assigning specific content pieces to prospects before key sales conversations, so that the conversation begins at a higher level of shared understanding.
How Assignment Selling works:
The 30-page principle: Sheridan (2019) found that prospects who read 30 or more pages of a company's content before a sales conversation closed at an 80% rate. Those who had read fewer than 10 pages closed at a significantly lower rate. Content is not only a marketing tool — it is a pre-sale qualification and conversion instrument. Track which content pieces the prospect has viewed before each sales appointment.
Pre-qualification questions to include in every lead form:
Insourcing content creation: The most effective answer to "we don't have time to create content" is to involve the people who already have the answers — the sales team, customer service staff, and subject matter experts within the business. They answer questions every day. A content manager with a journalist's instincts can turn those answers into published content with a 20-minute monthly interview per staff member. One filming session with four employees on a job site can produce five or more videos. No specialist knowledge is required to create content — only a willingness to share what is already known.
Output meets the standard for this skill if:
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.