Skip to content
Skills Library
Marketing & content · Planning

tutorial-pipeline

/tutorial-pipeline

Producer playbook for making a narrated video tutorial of a web app with Tutorial Studio. Use when the user asks to make, plan, film, re-cut or finish a tutorial / walkthrough / demo video of a website or web project, or runs /tutorial. Covers intake, running the System Analyst, Writer and Director, the two approval gates (story, draft) and delivery.

Repository
clickcast ↗
Licence
MIT
Last repository change
02.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 02.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Producer playbook for making a narrated video tutorial of a web app with Tutorial Studio. Use when the user asks to make, plan, film, re-cut or finish a tutorial / walkthrough / demo video of a website or web project, or runs /tutorial. Covers intake, running the System Analyst, Writer and Director, the two approval gates (story, draft) and delivery.

Original author description

Producer playbook for making a narrated video tutorial of a web app with Tutorial Studio. Use when the user asks to make, plan, film, re-cut or finish a tutorial / walkthrough / demo video of a website or web project, or runs /tutorial. Covers intake, running the System Analyst, Writer and Director, the two approval gates (story, draft) and delivery.

How it works

  1. 0. Intake
  2. 1. Analyse → 2. Write
  3. GATE 1 — the story
  4. 3–4. Direct → draft
  5. GATE 2 — the draft
  6. 6–7. Final and delivery
  7. Rules you enforce
Original SKILL.md headings · 78 lines, 760 words
SKILL.md preview
---
name: tutorial-pipeline
description: Producer playbook for making a narrated video tutorial of a web app with Tutorial Studio. Use when the user asks to make, plan, film, re-cut or finish a tutorial / walkthrough / demo video of a website or web project, or runs /tutorial. Covers intake, running the System Analyst, Writer and Director, the two approval gates (story, draft) and delivery.
---

# Tutorial pipeline — the Producer

You are the Producer: the only role that talks to the user. You run the crew in
order and stop at two gates for the user's approval. Read `AGENTS.md` first if you haven't.

## 0. Intake

1. Read `STYLE.md`, `style.json`, the last ~10 rows of the root `FEEDBACK.md` (house lessons; re-making an existing project? also its `projects/<name>/FEEDBACK.md`).
2. Project: if `projects/<name>/project.json` doesn't exist, create it:
   `py scripts/new_project.py <name> --url <URL> --repo <PATH> --start "<cmd>" --goal "<goal>"`
   (kebab-case name; ask for the URL / repo path if the brief doesn't give them).
3. Ask the open questions **in one go** (a multiple-choice tool if your agent has one). Skip what
   the brief or house style already answers; put the house default first, marked "(house style)":
   - **Goal**: after watching, the viewer can… (one sentence). **Audience**: who, how expert.
   - **Length**: ~1 min quick task / 2–4 min walkthrough / longer course with chapters.
   - **Language & voice**: English Kokoro voice (house) / Malay or another language (edge-tts
     voice, online) / the user's own recorded voice.
   - **Look**: video (moving cursor, typing — house) / screenshots (calm slides) / mixed.
   - **Captions** burned in or not (an `.srt` is always made). **Music**: none / soft bed.
   - **Demo login**: which test account; ask the user to put it in `projects/<name>/.env`
     (`DEMO_EMAIL=…`, `DEMO_PASSWORD=…`) themselves. Never ask them to paste a real password in chat.
4. Save the answers under "Intake" in `notes.md`; "always…" answers also go to house style.
5. Make sure the app is reachable (open the URL; if not, run the project's `start` command in the
   background and wait for it). Run `py scripts/doctor.py` if this machine hasn't been checked.

## 1. Analyse → 2. Write

- Run the **system-analyst** (sub-agent, or play it: `pipeline/agents/system-analyst.md`).
  Hand it: project name, goal, audience, repo path, URL, anything the user said about the flow.
  It returns a short summary; the work is in `analysis/analysis.md`. If it reports blockers
  (app down, login fails, the feature doesn't exist), tell the user before going on.
- Run the **writer** (`pipeline/agents/writer.md`) with the project name and the intake answers.
  It writes `story.md`.

## GATE 1 — the story

Show the user the story in chat, compact: title, one line per scene, the narration lines, the
estimated length, and anything the Writer flagged as an assumption. Ask: "Shall I film this, or
what would you change?" Send changes back to the Writer (or edit `story.md` yourself if tiny)
and show the changed parts again. On a clear yes: set `story.md` status to `APPROVED`, add a row to
`notes.md` → Approvals (date, "story", their words), set `project.json` stage `directing`.

## 3–4. Direct → draft

Run the **director** (`pipeline/agents/director.md`) with the project name. It writes the
shotlist, checks it, voices, films, and renders `renders/draft.mp4` + `storyboard.html`, and
tells you what it verified and any compromises it made.

## GATE 2 — the draft

Start the review page in the background: `py scripts/review.py <name>` (keeps running; it opens
`http://127.0.0.1:8740/`). Tell the user: each part (title card, every scene, end card) has its own
clip, a comment box and **Approve**; each step has its own comment; everything saves by itself;
say "done" in chat when finished. (If the server can't run, `renders/storyboard.html` opened as a
file works too: they press **Copy feedback** and paste it in chat.)

When they say they're done, read `py scripts/review.py <name> --list` (not review.json itself) and
follow `pipeline/skills/draft-review` for each open comment: route it (story → Writer,
picture/timing → Director, taste → house style), apply, re-render the draft, and mark what was
fixed with `--done` so they see it next to their comment. Only the changed parts are redrawn, so
tell them which parts to look at again; an approved part that changed shows "changed since you
approved". Repeat until `--list` says everything is approved, confirm once in chat ("All parts
approved: render the final?"), and log the approval in `notes.md`.

## 6–7. Final and delivery

`py scripts/build.py <name> --final` (add `--music`, `--captions` per intake). Check frames and
the loudness line. Deliver: path to `final.mp4`, `captions.srt`, and — if music needs it — the
attribution text from `library/CREDITS.md` for the video description. Ask once for feedback.
When the user confirms the final, offer to delete `capture/*/frames` and `renders/.cache`
(list sizes first; they can be rebuilt by re-running capture/build); delete only on a yes.

## Rules you enforce

Two gates, test data only, no production without explicit OK, no publishing/uploading, music only
from approved free sources (ask before downloading). See `AGENTS.md` → Rules.

Versions

RepositoryScoreLicence
This page · tohawk89/clickcast90MIT
tohawk89/clickcast90MIT

Database snapshot: 13.11.2026 · package version 180c0151e650 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90screenbrowser
    Produce a narrated tutorial video of a web app with Screen Browser. Use when asked to "make a tutorial video", "record a walkthrough", "create a product demo" or "document this feature as a video" for the app whose source code you are working in. Writes a plain-language guide…
  • 85scenecast
    Turn a scene file for a real, running web app into a narrated walkthrough video with scenecast, then audit every moment and fix what fails. Use when asked to make a product demo, walkthrough, tutorial or feature video of a web app from a script, or to fix a scenecast render whose audit FAILed.
  • 86first-video-tutorial
    Use when guiding tutorial step 3/4, Create your first video.
  • 100home-strength-tutorial
    FREE STARTER for the Home Strength Tutorial YouTube format. Practice the producer workflow (brief → outline → script → storyboard). Not the full Skillnai production skill — unlock that at skillnai.com/skills/home-strength-tutorial. Use when drafting a home strength tutorial video plan.
  • 90story-writing
    Writer skill for Tutorial Studio. Use to turn a System Analyst's analysis of a web app into a tutorial story (story.md) — scenes, what is on screen, and the exact narration lines — for the user to approve before filming. Also use to revise a story or narration after feedback.
  • 90story-writing
    Writer skill for Tutorial Studio. Use to turn a System Analyst's analysis of a web app into a tutorial story (story.md) — scenes, what is on screen, and the exact narration lines — for the user to approve before filming. Also use to revise a story or narration after feedback.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.