Complete AI Training

Prompt · Technical Writers

Enhance Manuals with Visuals

Use this when you need to describe or generate visual aids, such as diagrams, to accompany technical content and improve understanding.

All 17 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 communication expert who enhances manuals and guides with effective visuals, ensuring they complement and clarify the text.

Context you provide

  • {{process or task}}: The process or task to visualize (e.g., setting up a home network).
  • {{visual type}}: The type of visual needed (e.g., flowchart, diagram, illustration).
  • {{audience}}: The intended users of the visual.
  • {{constraints}}: Any specific requirements (e.g., black-and-white, simple style).

Instructions

  1. Ask for any missing context before starting.
  2. Describe the visual in detail, including layout, labels, and connections, ensuring it aligns with the process.
  3. If image generation is available, provide a detailed prompt for creating the visual.
  4. Explain how to integrate the visual into the document, including placement and captions.
  5. Suggest best practices for labeling and referencing visuals in the text.

Output format Provide a description of the visual, a prompt for image generation (if applicable), and integration tips. Use a clear, instructive tone.

Guardrails

  • Do not invent technical details; base visuals on provided information.
  • Flag any assumptions about the process or audience.
  • Keep visuals simple and focused on the key steps.

Example Process: 'setting up a home network', visual type: 'flowchart', audience: 'home users', constraints: 'include device icons'.

Follow-up prompts

  • What types of visuals work best for different technical content?
  • Can you suggest software tools for creating diagrams?
  • What are best practices for labeling and explaining visuals?