Skip to main content
customer-support intermediate

Create Professional Help Desk Knowledge Articles

Generate comprehensive help desk knowledge articles with step-by-step instructions, troubleshooting guides, and user-friendly formatting.

Works with: chatgptclaudegemini

Prompt Template

You are an expert technical writer specializing in customer support documentation. Create a comprehensive help desk knowledge article for [TOPIC] that will be used by [TARGET_AUDIENCE]. The article should include: 1. **Clear, descriptive title** that includes relevant keywords 2. **Brief overview** explaining what the article covers and who it's for 3. **Prerequisites** (if any) - what users need before starting 4. **Step-by-step instructions** with numbered steps and clear action items 5. **Screenshots/visual indicators** - note where images would be helpful with [IMAGE: description] 6. **Common issues and troubleshooting** - anticipate 3-4 problems users might encounter 7. **Related articles** - suggest 2-3 related topics 8. **Contact information** - when to escalate to live support Writing guidelines: - Use clear, jargon-free language appropriate for [TECHNICAL_LEVEL] users - Write in second person ("you") - Use active voice - Include specific examples and error messages when relevant - Optimize for searchability with relevant keywords - Structure with proper headings (H2, H3) for easy scanning - Add warning callouts for critical steps - Include estimated time to complete if applicable The tone should be helpful, professional, and empathetic. Assume users may be frustrated and need clear, confidence-building guidance.

Variables to Customize

[TOPIC]

The specific issue, process, or feature to document

Example: How to Reset Your Password Using Two-Factor Authentication

[TARGET_AUDIENCE]

Who will be reading this article

Example: end-users of our SaaS platform

[TECHNICAL_LEVEL]

The technical expertise level of your audience

Example: beginner to intermediate

Example Output

# How to Reset Your Password Using Two-Factor Authentication ## Overview This guide walks you through resetting your password when two-factor authentication (2FA) is enabled on your account. This process typically takes 3-5 minutes to complete. **Who this is for:** End-users who have forgotten their password and have 2FA enabled ## Prerequisites - Access to your registered email address - Access to your 2FA device (phone or authenticator app) - Your username or email address ## Step-by-Step Instructions ### Step 1: Navigate to the Login Page 1. Go to [company website]/login 2. Click "Forgot Password?" below the login form ### Step 2: Enter Your Information 1. Enter your username or email address 2. Click "Send Reset Link" 3. Check your email inbox (including spam folder) [IMAGE: Password reset form with email field highlighted] ### Step 3: Access the Reset Link 1. Open the email from our support team 2. Click the "Reset Password" button 3. You'll be redirected to a secure password reset page ### Step 4: Complete 2FA Verification 1. Enter your new password (must be 8+ characters) 2. Confirm your new password 3. Open your authenticator app or check your phone for the 6-digit code 4. Enter the 2FA code in the verification field 5. Click "Reset Password" ## Troubleshooting Common Issues **Issue:** "Invalid 2FA code" error **Solution:** Ensure your device's time is synced correctly. Generate a new code and try again. **Issue:** Reset email not received **Solution:** Check spam folder. Wait 5 minutes, then request another reset link. ## Related Articles - How to Set Up Two-Factor Authentication - Updating Your Account Security Settings ## Need Additional Help? If you continue experiencing issues, contact our support team at support@company.com or use the live chat feature.

Pro Tips for Best Results

  • Include specific error messages and codes that users might encounter to improve searchability
  • Use bullet points and numbered lists to break up long paragraphs and make instructions scannable
  • Add estimated completion times to set proper user expectations
  • Include 'gotcha' moments or common mistakes to prevent user frustration
  • Test your articles with actual users before publishing to identify gaps or confusion points

Tags

Want 500+ Expert Prompts?

Get the Premium Prompt Pack — organized, tested, and ready to use.

Get it for $29

Related Prompts You Might Like