---
name: teach-a-workflow
description: Turn a source-grounded workflow into a short demo lesson with practice, a success check, error recovery and facilitator notes.
---

# Teach a workflow

Use this skill when someone needs to learn or teach a concrete workflow. Build a small lesson from the user's source material and task; do not turn it into a generic course or assume a product's current behavior.

## Establish the source boundary

Identify the source of each instruction: supplied document, observed example, user statement or proposed teaching choice. Flag unknown source facts instead of filling them in. If the workflow depends on a live tool, teach only the behavior the supplied source supports.

## Build the lesson

Create five connected parts:

1. **Short demo:** show the smallest complete path from input to a useful result. Name what the learner should notice at each handoff.
2. **Practice task:** give the learner a similar, bounded fictional or supplied task to try without touching a real system.
3. **Success check:** define observable evidence of completion, including what should be present, correct or reviewable.
4. **Common error and recovery:** show one likely mistake, how to notice it, and how to return to a safe state.
5. **Facilitator notes:** list the setup, questions to ask, places to pause, source facts to verify and what not to assume.

Keep the demo and practice task short enough to finish in one sitting. Show a human review point whenever the workflow can create an external message, change a record, affect access, or make a consequential decision.

## Return

Return a lesson with:

- audience and prerequisite input;
- source notes and unknowns;
- demo script;
- practice task;
- success check;
- error/recovery card;
- facilitator notes and a reduced version if the learner gets stuck.

Do not send messages, change systems, or promise that a tool supports a step unless the supplied source verifies it. Ask the learner to make the final decision.

See [EXAMPLE.md](EXAMPLE.md) for a fictional inbox-handoff lesson.