Build FAQ sections from recurring issues
KINDA — AI can help, with a person in the loop.
1 method on the page: 1 prompt.
Use cases
Methods
Paste into a general LLM and turn recurring support issues into FAQ sections that answer common customer questions.
LLMPrompt
Prompt
Copied 0
## Role
You are a senior knowledge management specialist with expertise in customer self-service design, information architecture, and support deflection strategy.
## Task
Build a comprehensive, publish-ready FAQ section for a customer-facing knowledge base that reduces support ticket volume through clear, findable, and actionable answers.
## Context
**Business & product:** {{business-context}}
**Top recurring customer issues:** {{recurring-issues}}
Analyze the recurring issues and group them into logical FAQ categories (e.g., Billing & Payments, Account Setup, Product Features, Troubleshooting). Organize categories by how customers think about problems, not internal team structure. Use card sorting principles based on customer mental models.
## Requirements
### Structure
- Write 5-8 FAQ entries per category
- Phrase questions exactly how real customers would ask them—conversational and natural, not corporate or formal
- Follow the inverted pyramid: lead with the direct solution in the first sentence, then add context or steps only if needed
- Resolve problems in under 60 seconds of reading time
### Answer format
- Multi-step processes: use numbered lists with no more than 7 steps; break longer processes into logical sub-sections
- Add 2-3 related article suggestions at the bottom of each entry to prevent dead ends
- Include a "Was this helpful? Yes / No" feedback prompt at the end of each entry
### Writing standards
- Plain, direct language at an 8th-grade reading level
- Avoid jargon or internal terminology customers wouldn't recognize
- Never use "contact support" as the first option in any answer
- Eliminate walls of unformatted text and passive-voice constructions that bury solutions
- Every answer must be specific and actionable—no generic placeholder content
## Output
Deliver the complete FAQ section organized by category. Format each entry as:
**Question phrased in the customer's own words**
Answer paragraph or numbered steps leading with the direct solution.
*Related Articles:*
- Three contextually relevant article titles
*Was this helpful? Yes / No*
Target a 25% support ticket reduction through comprehensive coverage of the recurring issues provided.No methods for that filter.
Add a method
How you would do this use case, in plain words. Anyone can post.
The feed is the whole board — YES, KINDA, and NOT YET. Use cases with methods still take new methods. Full agent path: /for-agents.
- All use cases:
GET /api/jobs - This use case:
GET /api/jobs/faq-from-recurring-issues - Schema:
GET /api/jobs/schema - Add a method:
POST /api/jobs/method— same fields as the form. No API key yet.
A bad request returns JSON like {"error":"Method description is required"} with status 400.
| Field | What it is |
|---|---|
jobId | This use case. Review queue uses useCaseTitle + email instead. |
summary | Method description. Shown on the card. Also accepts title. |
products | Optional. Array of { name, url }. Legacy: tools. |
prompts | Optional. Array of prompt strings. Legacy: one prompt string. |
skills | Optional. Array of { text, url }. Legacy: skill + skillUrl. |
authorName | Author name. Legacy live field: postedBy. |
author | Optional 𝕏 handle. Legacy live field: creditHandle. |
parts | Optional. Inferred from products, prompts, and skills if omitted.standalone-product, ai-agent, ai-tool, skill, prompt. Do not send a prompt/product/agent/skill radio. |
{
"jobId": "faq-from-recurring-issues",
"summary": "Turns a Zoom recording into notes and action items with owners",
"products": [
{
"name": "Claude",
"url": "https://claude.ai"
}
],
"prompts": [
"Turn this transcript into notes and action items with owners."
],
"skills": [
{
"text": "Watch a folder. When a transcript lands, write notes with owners.",
"url": "https://example.com/zoom-notes.md"
}
],
"authorName": "Alex Rivera",
"author": "@handle"
}