Knowledge Base Article Optimizer
Transform rough support notes or FAQs into polished, searchable knowledge base articles with clear structure, troubleshooting steps, and SEO-friendly formatting.
Prompt Template
I need to create (or rewrite) a knowledge base article for our [product/service name] help center. **Topic:** [describe the issue or feature the article covers] **Raw information / current draft:** [paste existing notes, support ticket examples, or rough draft] **Target audience:** [e.g., non-technical end users, IT admins, developers] Please create a polished knowledge base article following these guidelines: 1. **Title**: Clear, search-friendly title using the words customers actually type 2. **Summary**: 1-2 sentence overview at the top (answers the question immediately) 3. **Applies to**: Product version, plan tier, or platform (if relevant) 4. **Step-by-step instructions**: Numbered steps with expected outcomes after each step 5. **Screenshots/visual placeholders**: Indicate where screenshots should be added with [Screenshot: description] 6. **Troubleshooting section**: "Still not working?" with 3-5 common failure scenarios and fixes 7. **Related articles**: Suggest 3 related topics that should be linked 8. **SEO metadata**: Suggested meta title (under 60 chars) and meta description (under 155 chars) Tone: Friendly, confident, jargon-free. Use "you" and "your." Write at a 6th-grade reading level.
Example Output
# How to Reset Your Password
**Quick answer:** Go to the login page, click "Forgot password," enter your email, and follow the link in your inbox to set a new password.
**Applies to:** All plans (Free, Pro, Enterprise) · Web and mobile app
Steps to Reset Your Password
1. Go to [yourapp.com/login](https://yourapp.com/login)
2. Click **"Forgot password?"** below the password field
[Screenshot: Login page with "Forgot password" link highlighted]
3. Enter the email address associated with your account
4. Click **"Send reset link"**
5. Check your inbox for an email from no-reply@yourapp.com
- **Expected:** Email arrives within 2 minutes
6. Click the **"Reset my password"** button in the email
7. Enter your new password (must be at least 8 characters with one number)
8. Click **"Save new password"**
9. You'll be redirected to the login page — sign in with your new password ✅
Still Not Working?
| Problem | Solution |
|---------|----------|
| Didn't receive the reset email | Check your spam/junk folder. Add no-reply@yourapp.com to your contacts and try again. |
| Reset link says "expired" | Links expire after 30 minutes. Request a new one from the login page. |
| "Email not found" error | You may have signed up with a different email or via Google/SSO. Try those options. |
| New password not accepted | Ensure it meets requirements: 8+ characters, at least one number. Avoid reusing your last 3 passwords. |
Related Articles
- How to enable two-factor authentication (2FA)
- How to update your email address
- Signing in with Google or SSO
SEO Metadata
**Meta title:** How to Reset Your Password | YourApp Help Center
**Meta description:** Forgot your password? Follow these simple steps to reset your YourApp password in under 2 minutes. Works on web and mobile.
Tips for Best Results
- 💡Paste actual support tickets as raw input — the AI will extract the real customer language, which improves searchability.
- 💡Always specify your audience's technical level; an article for IT admins should read very differently than one for consumers.
- 💡Use the [Screenshot: ...] placeholders to create a checklist for your design team.
- 💡Run the output through a readability checker (like Hemingway Editor) to verify the reading level.
Related Prompts
Help Documentation Writer
Write clear, user-friendly help articles and documentation that reduce support tickets and improve self-service.
Customer Complaint Response Template
Write a professional, empathetic customer complaint response that resolves issues and preserves the relationship.
Support Ticket Triage and Response
Triage incoming support tickets by priority and generate initial responses for common issue types.