How to write a tutorial video script
Last updated 2026-11-16
A tutorial video script has seven parts: a hook that names the problem, the outcome the viewer will get, what they need first, the steps, a check that it worked, a recap and a next step. Write each step as two columns, what happens on screen and what you say. Record the screen on a Mac with Screenshot (⇧⌘5) or QuickTime Player, then cut the pauses and add captions in an editor such as Woven.
The script template
Copy this into a document and fill in each row. It is a plain text outline for you to write in, not a file you open in an editor. Keep one document per video, so the script, the recording and the final cut all share a name.
Write the narration as you would say it to one person sitting next to you. Short sentences read well aloud, and a step that fits on one line is a step the viewer can follow.
| Part | What goes in it | Narration (what you say) | On screen (what you do) |
|---|---|---|---|
| 1. Hook | The problem, in the viewer's words | "Your [thing] does [annoying thing]. Here is the fix." | The problem itself, or the finished result |
| 2. Outcome | What the viewer can do by the end | "By the end you will [result]." | The finished result, or the first screen |
| 3. Prerequisites | Software, version, files or accounts needed first | "You need [item] and [item]." | Each item open or listed on screen |
| 4. Steps | One action per step, in order | "Step [n]: [verb] the [thing]." Say where it is and why, in one sentence. | The click, key press or typed text, with the target in view |
| 5. Check | How the viewer knows it worked | "You should now see [result]." | The result on screen |
| 6. Recap | The steps in one sentence | "So: [step], [step], [step]." | A held shot of the result, or a text card |
| 7. Next step | One thing to watch or do next | "Next, learn to [related task]." | An end card or a link |
Rules for writing the steps
Most of the script is part 4, so most of the work is there.
- One action per step. If a step has an "and" in it, split it. "Open Options and pick a folder" is two steps.
- Say the target before the click. Name the button or menu, then click it. A viewer who hears the name first can find it on their own screen.
- Narration and screen agree. Write the two columns side by side. If the narration mentions a menu the screen never shows, fix one of them.
- Name keys and menus exactly. Write "⇧⌘5" or "File, then New Screen Recording", as they appear on the Mac.
- Cut what the viewer does not need. If a step explains how the app works but does not change the result, leave it out or move it to a second video.
- Read it aloud once. Any line you stumble on when reading will be a re-take when recording. Rewrite it before you record.
A worked example: change where your Mac saves screen recordings
This is the template filled in for one short Mac task. The steps match Apple's Mac User Guide on screenshots and screen recordings.
| Part | Narration | On screen |
|---|---|---|
| Hook | "Your screen recordings keep landing somewhere you never look. Let's send them to a folder you choose." | A cluttered folder of files named Screen Recording |
| Outcome | "By the end, every new recording will save to the folder you pick." | The target folder, empty |
| Prerequisites | "All you need is a Mac and the folder you want to use. Make it now if it does not exist." | Finder with the new folder |
| Step 1 | "Press Shift, Command and 5 to open Screenshot." | The keys on screen, then the Screenshot toolbar appears |
| Step 2 | "Click Options." | Cursor to Options; the menu opens |
| Step 3 | "Under Save to, pick one of the listed locations. For your own folder, click Other Location." | The Save to section, then the folder picker |
| Step 4 | "Choose your folder." | The folder selected in the picker |
| Check | "Record a few seconds and stop it from the menu bar. The file is now in your folder." | Record, stop, then the new file in the folder |
| Recap | "So: Shift Command 5, Options, Save to, choose a folder." | The Options menu with your folder chosen |
| Next step | "Next, learn to trim and caption the recording." | End card |
Record the screen on a Mac
Woven does not record the screen, camera or microphone. Record with macOS, then bring the file into the editor. Apple gives two routes.
- Screenshot. Press ⇧⌘5. In the toolbar, click the tool to record the entire screen or to record a selected portion. For a portion, drag the frame to move it or drag its edges to resize it.
- QuickTime Player. Choose File, then New Screen Recording. Apple says this opens Screenshot and displays the tools, so the options below apply to both.
- Options. Click the Options pop-up menu to set Save to, a Timer, the Microphone (choose None to record without audio) and whether to show the mouse pointer.
- Start and stop. Click Record to start. To stop, click the Stop Recording button in the menu bar.
- The file. Apple says screen recordings are saved as .mov files, named Screen Recording followed by the date and time. Woven imports MOV.
Recording tips that save editing
Record from the script, in order, with a short silence before each step. A clear gap before each step makes it easy to find the cut later.
If you stumble, stop, pause, and say the line again from the start of that step. In the edit you cut to the second take. Close messages and chat windows first, so nothing pops up in the recording.
Edit your tutorial in Woven
Woven edits the recording after you have made it. It does not record the screen, and it has no script template, though you can ask its chat to draft a script. It imports MP4, MOV and M4V video, so the .mov file from macOS opens as it is. The Remove Pauses button lists every silence longer than the pause length you pick, and every filler word such as um and uh, and removes the ones you leave checked. You can then zoom in, add arrows and callouts, burn in captions and export an MP4. Woven asks where to save the export.
Ask in chat
- Transcribe this recording and cut the long pauses.
- Cut my first try at step 3 and keep the second take.
- Zoom in on the Options menu in step 2.
- Circle the Save to section and draw an arrow to Other Location.
- Add captions in the Subtitle style.
Or do it by hand
- 1Import. Drag the .mov recording from Finder onto the timeline, or choose Add, then Video.
- 2Cut dead air. Click Remove Pauses next to Keyframe in the timeline toolbar, uncheck any pause worth keeping, and press Remove. To cut a bad take yourself, split at both ends with ⌘B, select the middle piece and press ⇧⌫ (Delete and Close Gap), so everything after it moves up.
- 3Show where to look. Choose Add, then Video Effects, add a Push-in or Focus Zoom, then drag its focal point onto the part of the screen the step uses. Choose Add, then Shapes, for arrows, circles and highlights, and time each one to the word you say. You name each zoom and callout, either by chat or by hand; Woven does not zoom on its own when you click.
- 4Caption. Choose Generate captions from the Add menu. Woven has five caption looks, Highlight, Subtitle, Word by word, Word in place and Progressive reveal. Captions are burned into the exported video.
- 5Export. Click Export to render an MP4 at 1080p or 1440p and choose where to save it.
Common questions
A hook that names the problem, the outcome the viewer will get, what they need first, the steps, a check that it worked, a recap and a next step. Write each step as two columns: what you say and what happens on screen.
You do not need word-for-word narration, but you do need the order of steps and the line you will say for each. Without it, recordings tend to fill with pauses, restarts and filler words that you then cut. A short script means fewer re-takes.
Start with the outcome, then list the steps as one action each. Write what you say beside what the screen shows for each step. Read it aloud, rewrite any line you stumble on, then record from it.
As long as the steps need and no longer. Count the steps: a task with four steps does not need a long introduction. Cut anything that does not change the result, and split a big task into two videos with one outcome each.
No single number fits every tutorial. Read your script aloud at the pace you would show a friend, with room to wait while the screen changes. If you are rushing to say it, the step has too much in it.
Write the script, record the screen with Screenshot (⇧⌘5) or QuickTime Player, say the narration as you go, then edit the recording: cut pauses and false starts, add zooms and arrows, add captions and export an MP4.
macOS saves the recording as a .mov file. Open it in a video editor, cut the dead air and bad takes, add zooms, arrows and captions, and export. In Woven, import the .mov, click Remove Pauses, add the callouts and captions you need and export an MP4.
No. Woven does not record the screen, camera or microphone. Record with macOS, then import the file. Woven has no script template; write the script in any text document, or ask Woven's chat to draft one. Woven edits the recording.
Sources
- Take screenshots or screen recordings on Mac - Apple Support, checked November 16, 2026
- Record your screen in QuickTime Player on Mac - Apple Support, checked November 16, 2026
Try Woven free for 3 days
Then $129/yr or $15/month on Starter, or $299/yr or $39/month on Pro. Native Mac app for long and short video.
Paste into Claude Code to install and connect Woven.