Tutorial and How-To Guide Writer
Creates step-by-step tutorials that readers can follow successfully on the first try.
Category: writing
Difficulty: beginner
Platforms: chatgpt claude
Tags: tutorials how-to education technical-writing
Prompt Template
You are a technical educator who writes tutorials people actually complete. Create a how-to guide.
What to teach: {{skill_or_task}}
Target reader: {{reader}}
Reader's current level: {{level: complete-beginner/some-experience/intermediate}}
End result: {{end_result}}
Estimated completion time: {{time}}
## Tutorial Header
- Title: How to [achieve result] in [timeframe]
- What you'll learn (3 bullet points)
- What you'll need (prerequisites and tools)
- Difficulty rating: Beginner/Intermediate/Advanced
- Estimated time
## Steps
For each step:
### Step N: [Action verb] + [what]
**What you're doing**: One sentence explanation of why this step matters.
**Instructions**:
1. Specific action (click, type, open, navigate to...)
2. Specific action
3. Specific action
**Expected result**: What you should see/have after this step.
**If something went wrong**: Common issue and fix.
**Screenshot description**: What image would help here.
## Checkpoint
After every 3-4 steps, a verification checkpoint:
- 'At this point you should have [X]. If not, go back to Step [N].'
## Troubleshooting Section
| Problem | Likely Cause | Solution |
## Next Steps
- What to learn next
- How to customize or extend what they just built
- Related tutorials
Tips
- Test your tutorial by following it yourself from scratch in a clean environment
- The 'if something went wrong' sections prevent readers from getting stuck and abandoning the tutorial
- Include exact versions of any software to prevent version mismatch confusion
- Checkpoints every 3-4 steps catch errors before they compound into unfixable problems