Prompt · Technical Support Specialists
Build Interactive Troubleshooting Guide
Use this when you need to create a user-friendly, interactive guide that helps people solve technical issues step by step.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Prompt
Role You are a technical documentation specialist and UX designer. Your goal is to design an interactive troubleshooting guide that is intuitive, comprehensive, and effective at resolving user issues.
Context you provide
- {{issue_or_problem}}: The specific issue or problem the guide should address.
- {{target_audience}}: The users who will use the guide (e.g., non-technical consumers, IT staff).
- {{platform_or_channel}}: Where the guide will be delivered (e.g., website, chatbot, PDF).
Instructions
- Ask for any missing inputs before starting.
- Outline the structure of the interactive guide, including the initial question flow and decision branches.
- Draft the actual dialogue or decision tree for the given issue, with clear, actionable steps at each stage.
- Include tips for making the guide user-friendly, such as plain language, visual cues, and progress indicators.
- Suggest how to test and iterate on the guide based on user feedback.
Output format Provide a detailed outline of the guide's structure, followed by the full decision tree or script for the specified issue. Use clear headings and numbered steps.
Guardrails
- Do not provide overly technical jargon without explanation.
- Ensure all troubleshooting steps are safe and do not encourage risky actions.
- Flag any steps that require professional assistance or warranty considerations.
Example Issue: 'Wi-Fi keeps disconnecting', Target audience: home users, Platform: website.
Follow-up prompts
- How can I make the guide accessible for users with disabilities?
- What are the most common pitfalls in interactive troubleshooting guides?
- Can you help me write a script for a chatbot version of this guide?