Productivity
knowledge basehelp centerdocumentationsupportself-serviceKnowledge Base Article Writer
A complete, Grade-8-level knowledge base article with prerequisites, numbered steps, and troubleshooting that deflects support tickets.
Best For
- •A support team writes a help center article to deflect a recurring ticket type without waiting for engineering to fix the root cause
- •A SaaS onboarding lead documents a common setup step so new users can self-serve instead of opening a chat ticket
- •An internal ops team turns a Slack thread full of tribal knowledge into a searchable article for future hires
Prompt Template
Write a help center / knowledge base article on the topic: [ARTICLE_TOPIC]. This article is for [AUDIENCE, e.g., end users of a SaaS product / internal employees]. The article should help the reader accomplish: [USER_GOAL]. Subject matter expert input: [SME_NOTES_OR_BRAIN_DUMP]. Structure the article as: (1) Title, written as a task ("How to [action]") or a question ("How do I [action]?"), (2) Overview, 1–2 sentences explaining what the reader will be able to do after reading this, (3) Before you begin, any prerequisites, permissions, or context the reader needs, (4) Step-by-step instructions, numbered steps with imperative verbs; every step produces one clear action. Add [NOTE: text] for important caveats and [TIP: text] for shortcuts, (5) Troubleshooting, 3 common problems and their solutions in a "Problem → Solution" format, (6) Related articles, suggest 2–3 logical next articles the reader might need: [RELATED_TOPICS]. Write in plain language, second person ("you"), active voice. Target reading level: Grade 8.
Pro Tip
Feed it the actual support tickets or Slack questions as SME notes rather than a clean summary, since the troubleshooting section is strongest when it's built from real confusion, not assumptions.
Example Output
A sample of what this prompt produces once you fill in the placeholders.
Title: How to Reset Your Two-Factor Authentication. Overview: after this, you'll be able to regain account access without contacting support. Before you begin: you need access to your registered recovery email. Step 2: click 'Lost access to your device?' [TIP: this link only appears after three failed login attempts]. Troubleshooting: Problem, recovery email not arriving, Solution, check spam folder and whitelist support@domain.com.
Recommended Tools
How to use this prompt
- Copy the prompt template using the button above.
- Paste it into your preferred AI assistant (ChatGPT, Claude, Gemini, etc.).
- Replace all bracketed placeholders like
[TOPIC]with your specific details. - Send the prompt and refine the output as needed.