How I Folded AI Video Intros Into a Developer Tutorial Pipeline

Jack — Fri, 13 Nov 2026 08:45:48 +0000

When I publish a technical tutorial, the writing is the easy part. The awkward gap is the first ten seconds of the companion video: a cold open that shows the problem, a face or a desk, and one line of narration before the screen recording starts. I used to skip the video entirely, or record a shaky phone clip that never matched the article. This year I started treating a short AI-generated shot as one more build artifact in the same folder as the markdown and the screenshots.

This is not a survey of every model on the market. It is a workflow I can repeat on a weeknight, with files I already have.

Keep the source of truth in the repo

I keep a media/ directory next to the post:

posts/how-we-debounced-webhooks/
  index.md
  media/
    refs/
      host.jpg          # talking-head still, or a product packshot
      desk.jpg          # location / desk setup
      grade.jpg         # a still whose color grade I want to lock
      vo-guide.wav      # optional scratch narration
    prompts/
      intro-v3.txt
    out/
      intro-16x9-1080.mp4
      intro-9x16-1080.mp4

The prompt file is versioned. The output is not precious; I can regenerate it. The references are precious. If a later post in the same series needs the same host and the same desk, I reuse those files instead of hoping the model remembers a face from last month.

Write the intro as a shot, not as a paragraph

A blog intro can ramble. An eight-to-twelve-second video intro cannot. I write three lines before I touch a generator:

Who or what is on screen.
The single action that happens — one action, not four.
What the camera does, and how the scene is lit.

A prompt that has worked for a webhook tutorial looks more like a director's note than a marketing slogan:

Mid shot of a developer at a wooden desk, facing a laptop that shows a failing CI badge. She looks up from the screen, exhales, then turns the laptop toward camera. Slow dolly-in, 35mm, soft window light from the left, shallow depth of field. She says: "This webhook retried sixteen times before I found the missing signature header." Room tone of a quiet apartment, faint keyboard clicks under the line.

Notice what is missing: "cinematic, epic, ultra-realistic, masterpiece." Those adjectives do not tell the model who moves, when they speak, or where the light is. Specific stage directions do. If I need a longer setup, I stretch the shot and mark beats by timestamp — 0–6s the failed badge, 6–14s the turn to camera, 14–22s the line — rather than stuffing three scenes into one prompt.

Attach references and say what each one is for

A text prompt is enough to start, but identity drift is the usual failure mode: the person in frame two is almost, but not quite, the person in frame one. I attach a still of the host, a still of the desk, and sometimes a short clip of how I want the camera to feel. In the prompt I tag each file by role: this image is the face, this one is the location, this audio is the rhythm of the line.

Tools that accept a large set of mixed references — images, clips, and audio in the same generation — are useful here because a tutorial series has to look like one show. I have been using Seedance 3.0 for this step because it is built around that mix: text plus tagged references, a single unbroken take of up to thirty seconds, and voices and room tone rendered with the picture. I do not need a second pass in an audio editor just to get the line on the lips. New accounts also receive free credits without a card, which is enough to test whether a prompt pattern is worth keeping.

Render once, then revise only the change

The first draft is rarely the one I publish. Maybe the light is right but the line is rushed. Maybe I want a night interior instead of afternoon window light. Regenerating the whole shot is how you lose a take you already liked.

The better habit is the same as a small patch in git: upload the finished clip and describe only the change. "Keep the developer, the desk and the laptop. Make it a rainy evening, tungsten desk lamp, same camera move and the same line." If the hook needs more room, extend the take forward instead of starting over.

I usually render a 1080p 16:9 master for YouTube or the blog embed, then a 9:16 cut for Shorts, reusing the same references and changing only the framing instruction. When I start from a still, I let the frame follow the image's proportions unless the platform needs a different shape. Available aspect ratios cover the usual publishing targets — 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 — so the export decision can live in the prompt file, not in a later crop.

A checklist I run before I hit generate

One main action, written as a verb, not a mood.
Camera move, lens, and light are named.
Dialogue is a sentence I would actually say, not a slogan.
Every reference file is tagged for a job.
Duration matches the line. I time myself reading it out loud.
Output path and aspect ratio are decided before I spend a credit.