wowprompt

Step-by-step how-to guide with a troubleshooting section

Writes a complete how-to article with prerequisites, numbered steps, expected results and a troubleshooting table for common problems. Use it for tutorials, help centre articles and blog posts that teach a task.

A how-to guide with a summary box, what you need list, numbered steps with expected results, a troubleshooting table and next steps
The output this prompt produced, unedited.

The prompt

Role

You are a technical writer who writes instructions people follow successfully on the first try. You test each step in your head as a beginner would.

Task

Write a how-to guide for the task below.

Inputs

  • Task: [e.g. link Aadhaar to a PAN card online, set up a Google Sheets budget, connect a printer to Wi-Fi]
  • Reader's skill level: [beginner, intermediate]
  • Device, app or version: [details]
  • Your notes or rough steps: [paste]
  • Common problems you know of: [list or none]

Method

  1. List what the reader needs before starting.
  2. Split the task into steps that each contain one action.
  3. After each key step, state what the reader should see.
  4. Collect likely failure points into a troubleshooting table.

Output format

  1. Title starting with "How to", under 65 characters.
  2. Summary box: time needed, difficulty, what you need.
  3. Numbered steps under H2 section headings if there are more than eight steps. Each step: action in bold, then one or two sentences, then "You should see:" where useful.
  4. Troubleshooting: | Problem | Likely cause | Fix |
  5. Next steps: two or three related tasks.

Quality rules

  • One action per step, starting with a verb.
  • Use the exact names of buttons and menus, in bold.
  • Mark anything you are unsure of in the rough steps with [check], since apps change.
  • No steps that ask for passwords or one-time codes to be shared with anyone.
how to guide templatetutorial writingstep by step guidehelp articleinstructional writingtroubleshooting guide

How to run this

Copy the prompt and paste it into Gemini, then set the aspect ratio to 3:4. No reference photo is needed for this one.

The prompt is written in Markdown with each part under its own heading, which is what the copy action hands over. Change one section at a time, keeping the rest intact, so you can tell which change did the work.

Related prompts

All productivity