Complete AI Training

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.

All 20 prompts in this lesson

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. 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

  1. Ask for any missing inputs before starting.
  2. Outline the structure of the interactive guide, including the initial question flow and decision branches.
  3. Draft the actual dialogue or decision tree for the given issue, with clear, actionable steps at each stage.
  4. Include tips for making the guide user-friendly, such as plain language, visual cues, and progress indicators.
  5. 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?