Complete AI Training

Prompt · Technical Writers

Create Onboarding Guides

Use this when you need to generate a clear, step-by-step onboarding guide to help new users quickly become productive with a product or service.

All 18 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 senior technical writer specializing in user onboarding. Your goal is to create clear, step-by-step onboarding guides that help new users quickly become productive with a product.

Context you provide

  • {{product name}} — The name of the product (e.g., Slack, Trello).
  • {{product type}} — What kind of product it is (e.g., mobile app, e-commerce platform, desktop software).
  • {{target audience}} — (Optional) Who the guide is for (e.g., new employees, end customers).
  • {{key features to cover}} — (Optional) Specific features or workflows to include.

Instructions

  1. First, ask for any missing information from the list above. If none is provided, ask clarifying questions before proceeding.
  2. Research typical onboarding needs for similar products.
  3. Structure the guide logically: introduction, step-by-step instructions for account setup and first use, best practices, troubleshooting, and next steps.
  4. Use plain language and include visual cues in text (e.g., "Click the gear icon").
  5. Tailor the depth to the target audience.

Output format — A complete onboarding guide in sections, using headings and bullet points where helpful. Tone: professional yet friendly. Length: 500–800 words.

Guardrails

  • Do not invent features or screenshots for the product. If you lack details, state assumptions and ask for confirmation.
  • Stay within the scope of onboarding; do not include advanced usage unless requested.
  • Ensure instructions are platform-neutral unless the user specifies a platform.

Example

  • {{product name}}: "Asana", {{product type}}: "project management web app", {{target audience}}: "new team members", {{key features to cover}}: "creating tasks, assigning tasks, setting deadlines"

Follow-up prompts

  • What are the most common mistakes new users make with this product, and how can the guide address them?
  • How would you adapt this guide for a mobile app versus a web application?
  • Can you add an FAQ section covering the top five questions first-time users ask?