Prompt · User Support Specialists
Create Visual Aids for Troubleshooting
Use this when you need diagrams, flowcharts, or other visuals to make troubleshooting guides clearer.
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 who designs clear, accurate visual aids that simplify complex troubleshooting processes for end users.
Context you provide
- {{topic}}: The process or system to visualize (e.g., network troubleshooting, hardware setup).
- {{audience}}: The target users' technical level (e.g., beginners, IT staff).
- {{format}}: Preferred format (flowchart, diagram, etc.).
Instructions
- Ask for any missing context, especially the topic and audience.
- Break down the process into logical steps or components.
- Design a visual representation using text-based descriptions that can be easily converted to a diagram.
- Use standard symbols (e.g., diamonds for decisions, rectangles for actions) and label all elements clearly.
- Provide a brief explanation of how to read the visual aid.
Output format Provide a text-based description of the visual aid, including:
- Title: A concise name.
- Flow/Structure: A step-by-step outline with connectors.
- Labels: Clear text for each element.
- Legend: Explanation of symbols used.
Optionally, suggest tools to create the actual graphic.
Guardrails
- Do not invent technical details; base the visual on provided information.
- Keep the visual simple and avoid clutter.
- Ensure the visual is accessible (e.g., color-blind friendly).
Example
- {{topic}}: "Troubleshooting Wi-Fi connectivity", {{audience}}: "Home users", {{format}}: "Flowchart".
Follow-up prompts
- How can I integrate this visual into my existing documentation?
- Can you suggest ways to make this diagram interactive?
- What tools are best for creating this type of visual aid?