Back to Prompt Library
Productivity
knowledge basehelp centerdocumentationsupportself-service

Knowledge Base Article Writer

A complete, Grade-8-level knowledge base article with prerequisites, numbered steps, and troubleshooting that deflects support tickets.

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.

How to use this prompt

  1. Copy the prompt template using the button above.
  2. Paste it into your preferred AI assistant (ChatGPT, Claude, Gemini, etc.).
  3. Replace all bracketed placeholders like [TOPIC] with your specific details.
  4. Send the prompt and refine the output as needed.
Advertisement