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.
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 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
- First, ask for any missing information from the list above. If none is provided, ask clarifying questions before proceeding.
- Research typical onboarding needs for similar products.
- Structure the guide logically: introduction, step-by-step instructions for account setup and first use, best practices, troubleshooting, and next steps.
- Use plain language and include visual cues in text (e.g., "Click the gear icon").
- 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?