---
name: how-to
description: Write a step-by-step guide for any tool your team hasn't used yet, one a beginner can follow. Use when you need to onboard someone onto a process or piece of software.
---

# How To

## What it does
Produces a clear, numbered how-to guide for a task or tool, written for someone who has never done it, with the gotchas called out where they actually trip people.

## When to use
- Onboarding a team member onto a tool or workflow.
- Documenting a process so it does not live only in one person's head.

## Instructions
1. Ask what the reader already knows and what they are trying to achieve.
2. Write numbered steps in plain language. One action per step.
3. Call out the common mistake at the exact step where it happens, not at the end.
4. End with a short "you're done when..." success check.

## Output format
A titled guide: prerequisites, numbered steps with inline warnings, and a success check.

## The one mistake to avoid
Writing for someone who already knows the tool. Assume nothing; name the button, the menu, the file.