Prompt lesson · 17 prompts
Troubleshooting Guide Creation prompts for User Support Specialists
17 ready-to-use prompts from our AI for User Support Specialists course. Copy one, fill in the {{placeholders}}, and paste it into ChatGPT, Claude, Gemini or any other AI.
Find Root Causes In User Feedback
Use this when you need to turn scattered support tickets and feedback into a ranked list of your most common user problems and their likely causes.
Role — You are a support insights analyst who mines feedback and tickets to surface recurring problems and their likely causes.
Context you provide
- {{feedback_data}} — the support tickets, reviews, or survey responses to analyze (pasted or summarized)
- {{product_or_service}} — what the feedback relates to
- {{number_of_issues}} — optional: how many top issues to surface (default 5)
Instructions
- Ask for the feedback data and product name if not provided.
- Read through the material and group complaints into distinct issue categories.
- Estimate the relative frequency of each category based only on what's in the data.
- For each category, propose the most likely root cause and its severity (high/medium/low impact on users).
- Rank the issues by a combination of frequency and severity.
Output format — A numbered list of the top issues, each with: short description, estimated frequency, likely root cause, and severity rating.
Guardrails
- Work only from the data supplied; do not fabricate ticket counts or quote users that weren't in the source material.
- Clearly separate patterns confirmed by the data from causes that are your best hypothesis.
- Note when the sample is too small or one-sided to generalize confidently.
Example — {{feedback_data}} = 50 support tickets pasted below; {{product_or_service}} = mobile banking app; {{number_of_issues}} = 5.
Open this prompt Analysis · Beginner
Organize Troubleshooting Steps Logically
Use this when you need to structure troubleshooting guides into clear, actionable steps that users can follow easily.
Role You are a technical writer who organizes troubleshooting information into logical, easy-to-follow steps that minimize user confusion and maximize resolution success.
Context you provide
- {{issue}}: The specific problem (e.g., application crashes, connectivity issues).
- {{software_or_device}}: The product involved.
- {{known_symptoms}}: Any error messages or signs already observed.
Instructions
- Ask for the issue and any known symptoms if not provided.
- Break the troubleshooting process into a sequence of steps, starting from initial diagnosis to resolution.
- Order steps from simplest and least invasive to more complex.
- For each step, include a clear action, expected result, and how to proceed if it fails.
- Ensure the guide covers all necessary aspects, including prerequisites and safety warnings.
Output format Provide a numbered list of steps, each with:
- Action: What the user should do.
- Expected result: What should happen.
- If not: What to try next.
Keep language simple and direct.
Guardrails
- Do not skip steps that are critical for safety or data integrity.
- Avoid technical jargon unless the audience is technical.
- Flag any steps that require advanced skills.
Example
- {{issue}}: "Application crashes on startup", {{software_or_device}}: "Our software", {{known_symptoms}}: "Error code 0x1234".
Open this prompt Planning · Beginner
Clear Troubleshooting Instructions
Use this when you need to write or simplify troubleshooting instructions for non-technical users.
Open this prompt Writing · Beginner
Create Visual Aids for Troubleshooting
Use this when you need diagrams, flowcharts, or other visuals to make troubleshooting guides clearer.
Open this prompt Creating · Beginner
Review and Refine Troubleshooting Guide
Use this when you need to evaluate and improve an existing troubleshooting guide for accuracy, clarity, and user-friendliness.
Open this prompt Analysis · Intermediate
Build Interactive Troubleshooting Flowchart
Use this when you need a dynamic, user-driven troubleshooting guide that adapts to responses.
Open this prompt Creating · Intermediate
Video Troubleshooting Tutorial Scripts
Use this when you need to create engaging video tutorials that clearly explain troubleshooting steps for technical issues.
Open this prompt Creating · Intermediate
Build a Troubleshooting FAQ Page
Use this when you need to create a comprehensive FAQ page that addresses common troubleshooting questions and improves user self-service.
Open this prompt Writing · Beginner
Create a Troubleshooting Checklist Generator
Use this when you need to design a tool that generates personalized troubleshooting checklists for various technical issues.
Open this prompt Creating · Intermediate
Build a Troubleshooting Chatbot
Use this when you need to design a conversational troubleshooting chatbot that guides users through problem-solving in real time.
Open this prompt Creating · Intermediate
Craft Troubleshooting Email Templates
Use this when you need to create standardized email templates for troubleshooting communications that are professional and empathetic.
Open this prompt Writing · Beginner
Write Troubleshooting Knowledge Base Articles
Use this when you need to create detailed, step-by-step knowledge base articles that help users resolve technical issues independently.
Open this prompt Writing · Intermediate
Develop Troubleshooting Diagnostic Tools
Use this when you need to design diagnostic tools that help users identify and resolve technical issues independently.
Open this prompt Creating · Advanced
Plan a Troubleshooting Webinar
Use this when you need to create engaging webinar content and talking points to educate users on troubleshooting best practices.
Open this prompt Planning · Intermediate
Set Up Troubleshooting User Forums
Use this when you want to establish and manage user forums for community-driven troubleshooting, including automated responses and moderation strategies.
Open this prompt Planning · Intermediate
Design a Troubleshooting Mobile App
Use this when you want to plan and design a mobile app that provides on-the-go troubleshooting support with conversational AI capabilities.
Open this prompt Planning · Advanced
Handle Social Media Troubleshooting
Use this when you need to craft responses and strategies for providing troubleshooting support and managing issues on social media platforms.
Open this prompt Communication · Intermediate