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.

Tutorial video script template
PartWhat goes in itNarration (what you say)On screen (what you do)
1. HookThe problem, in the viewer's words"Your [thing] does [annoying thing]. Here is the fix."The problem itself, or the finished result
2. OutcomeWhat the viewer can do by the end"By the end you will [result]."The finished result, or the first screen
3. PrerequisitesSoftware, version, files or accounts needed first"You need [item] and [item]."Each item open or listed on screen
4. StepsOne 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. CheckHow the viewer knows it worked"You should now see [result]."The result on screen
6. RecapThe steps in one sentence"So: [step], [step], [step]."A held shot of the result, or a text card
7. Next stepOne 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.

Example script: change where a Mac saves screen recordings
PartNarrationOn 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

  1. 1Import. Drag the .mov recording from Finder onto the timeline, or choose Add, then Video.
  2. 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.
  3. 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.
  4. 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.
  5. 5Export. Click Export to render an MP4 at 1080p or 1440p and choose where to save it.

Common questions

Sources

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.

Download for Mac

Paste into Claude Code to install and connect Woven.

Related