Back to Blog
GoScript Journal

Scripting a Tutorial Before You Hit the Record Button

·7 min read·GoScript Team /Craft

Write the steps as a list first

Before you record a single frame, write the steps as a plain numbered list. Each line is one action the viewer can see happen on screen. That list becomes the spine of the tutorial and stops you from wandering while the recorder runs.

I write the list in a text note with no formatting at all. Numbered lines keep me honest, because if a step takes two sentences to describe it usually means two clicks the viewer needs to see. Splitting those apart makes the edit simpler later.

Say the outcome, then the action

Each step in the script reads as outcome first, then action. Something like, click the gear icon to open settings. The viewer hears what is about to happen and then watches you do it, which keeps their eye on the right part of the screen at the right moment.

This ordering also gives you natural places to trim. If a step drags in the final edit, you can cut the action and keep the outcome line as a bridge. A script with clear outcome lines survives aggressive cutting without losing the thread.

Read it out loud before recording

Read the whole script out loud once with no screen in front of you. Awkward phrasing shows up fast when your mouth has to say it. Any sentence you stumble over will cost you a re take, so rewrite it now while fixing it is cheap.

Time the read with a stopwatch. If the spoken script already runs longer than your target, the finished tutorial will run even longer once the real screen pauses are added. Trimming script lines is easier than trimming a finished timeline.

Script the path, then let the screen do the walking. The words only need to keep pace with the clicks.

Leave room for live narration

A full verbatim script can sound stiff when you read it over a live screen. I write short cue phrases instead of whole sentences, then talk around them. The cue keeps me on topic and my voice stays natural because I am not reading a wall of text.

Mark the places where you plan to pause and let the screen breathe. A two second silence after a click gives the viewer time to follow. Those pauses are part of the script even when they are not words on the page.

Keep the script with the project

Save the script next to the recording in the same project folder. When you edit, the list of steps becomes your chapter markers and your description outline. One file does three jobs, which means less duplicated effort across the whole pipeline.

If a step changes during recording, update the script the moment you stop. A stale script is worse than no script, because next time you will trust it and teach the old way by mistake.

Write the description from the script

Your step list doubles as a description outline. Paste the headings in order, add a timestamp for each, and the description writes itself. This saves a separate writing task and keeps the description honest about what happens in the video.

Add the tools and versions you used at the bottom so a viewer can match your setup. Small details like an app version prevent the most common confused comment. The script already told you what you touched, so the list is nearly finished.

If a step changed while recording, fix the outline here too. The description and the script should never disagree, because viewers read one and watch the other and notice when they drift apart.

Key takeaways

  • List the visible steps before you record anything
  • Lead each line with the outcome, then the action
  • Read the script aloud and time it with a stopwatch
  • Use short cue phrases instead of full sentences
  • Keep the script in the project folder for editing

Turn this into your next script.

Analyze a channel, extract its structural DNA, and generate scripts engineered from patterns that actually work.

Analyze a Channel