Agent skill

Script Video

by nodetool-ai in nodetool-ai/nodetool

Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll.

AGPL-3.0Auto-check passedMedia & Creative

Install Script Video

skills CLI
$ npx skills add nodetool-ai/nodetool --skill script-video -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nodetool-ai/nodetool script-video --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system-skills/script-video .claude/skills/script-video && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
script-video
GitHub stars
556
Token cost
~1.3k tokens
SKILL.md length
594 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll.

  • Works in 10 steps: Research and write the voiceover.… → create_script {name}. → edit_script {script_id, ops} — {"op":… → …
  • Tasks that involve Text to speech and voice
  • SKILL.md covers What makes this job type its own, The sequence, Timing and Style registers, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Script Video is an agent skill from nodetool-ai/nodetool. Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll. For on-camera creators, use ugc-video.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Text to speech and voice and Influencer and creator marketing. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Text to speech and voice
  • Tasks that involve Influencer and creator marketing

Example prompts

  • “/script-video”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. Research and write the voiceover. 150–165 words is about 60 seconds. Write it
  2. create_script {name}.
  3. edit_script {script_id, ops} — {"op": "add_speaker", "name": "Narrator"}, then
  4. Give the narrator a voice: find_model (text_to_speech) →
  5. derive_storyboard_from_script {script_id, provider, model} — one shot per line, in
  6. Rewrite the visuals. The derived shots are a starting point. Go through with
  7. Stills on every shot, reviewed, before any clip.
  8. voice_script_lines {script_id} — defaults to every draft or stale line. Word
  9. Clips, then assemble_storyboard_timeline, then validate_timeline.
  10. Duck the pictures' own sound. Assembly gives every shot clip an audio twin on a

What it can do on your machine

Read from SKILL.md and the folder at commit 515bd28. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Script Video loads about 1.3k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 594 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit 515bd28, republished under its AGPL-3.0 licence (© nodetool-ai). 594 words, ~1,260 tokens.

Download SKILL.mdSave it as .claude/skills/script-video/SKILL.md (or your agent's skills folder).
name
script-video
description
Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll. For on-camera creators, use ugc-video.

Load /storyboard-core first. It carries the loop, the tool contract and the gating this skill assumes. This job type inverts the order of that loop, so read the sequence below before creating a board.

What makes this job type its own

Everywhere else the picture comes first and the words ride along. Here the words are the spine: they set the running time, and each shot has to be exactly as long as the line it covers. That is a different tool path — a script resource the storyboard links to — not a storyboard with narration typed into it.

The payoff is that assemble_storyboard_timeline on a linked board cuts words and picture together: each shot runs as long as the takes it covers, and every voiced line becomes its own voiceover clip.

The sequence

  1. Research and write the voiceover. 150–165 words is about 60 seconds. Write it before anything visual exists.
  2. create_script {name}.
  3. edit_script {script_id, ops} — {"op": "add_speaker", "name": "Narrator"}, then one {"op": "add_line", "text": "..."} per sentence. One sentence per line: a line is the unit that gets a take and times a shot, so a paragraph in one line gives you a shot you cannot cut.
  4. Give the narrator a voice: find_model (text_to_speech) → {"op": "set_speaker_voice", "target": "Narrator", "provider", "model", "voice"}. Without it every line reads no_voice.
  5. derive_storyboard_from_script {script_id, provider, model} — one shot per line, in reading order, each carrying the line ids it covers. Pass a language provider and model for a director pass that writes each shot's visuals over that scaffold; omit both for the bare scaffold.
  6. Rewrite the visuals. The derived shots are a starting point. Go through with edit_storyboard update_shot, giving each an action that is concrete b-roll and a motion with a count. Set the board style and entity_ids with set_board.
  7. Stills on every shot, reviewed, before any clip.
  8. voice_script_lines {script_id} — defaults to every draft or stale line. Word timings come from a transcription pass (transcribe: true by default) and ride into the clips as captions.
  9. Clips, then assemble_storyboard_timeline, then validate_timeline.
  10. Duck the pictures' own sound. Assembly gives every shot clip an audio twin on a "Shot Audio" track. edit_timeline → get_state, then set_clip_params with muted: true on those clips so the voiceover carries.
Show full SKILL.md (217 more words)Show less

Timing

A shot on a linked board takes its length from its lines' takes — that is duration_source: "audio", the default once linked. Leave it alone. Pin a shot with duration_source: "manual" plus duration_seconds only when it must hold past its narration, such as a final card.

Voice before you cut. A line with no take leaves its shot on its own duration, and the assembly lists it as skipped.

Style registers

Put one in the board style, and say no on-screen type — titles belong on the timeline as text clips, where they stay editable.

Registerstyle
Flat 2Dflat vector illustration, three-colour palette, thick uniform strokes, white ground
Documentary macromacro photography, shallow depth, natural light, matte film grade
Dark UIdark interface on a black ground, single accent colour, crisp type-free panels
Paper-craftcut-paper layers, soft drop shadows, warm raking light

Music

Set the board's music_prompt only if the board is open in a browser tab — ui_storyboard_set_screenplay is the only writer for it, and assembly turns it into a draft audio clip. Headless, add a music track yourself: generate_music, then edit_timeline → add_track + add_media_clip, and set its volumeDb low enough to sit under the voiceover.

Brief

Adapt these examples to the user's brief. Example deliverables, style choices, and approval checkpoints apply only when the user adopts them.

Research [TOPIC], then direct a faceless 16:9 explainer. No on-camera talent.

Write the voiceover first, 150-165 words, one sentence per line, as a script:
create_script, then edit_script to add a Narrator speaker and the lines. Give
the narrator a voice with set_speaker_voice before anything else.

Then derive_storyboard_from_script with a director pass, and rewrite each of the
eight shots' action and motion as concrete b-roll to that voiceover.
Board style: [flat 2D / documentary macro / dark UI / paper-craft], no on-screen
type.

Stills on every shot before any clip. Then voice_script_lines so the shots take
their length from the takes, then clips, then assemble_storyboard_timeline and
validate_timeline. Finish by muting the Shot Audio clips under the voiceover.

Stop after the script and the board. Show me the words before you spend.

© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/system-skills/script-video of nodetool-ai/nodetool.

Open the folder on GitHubat commit 515bd28

Compare with similar skills

Script Video next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Script Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Script Video this skillnodetool-ai/nodetool556—~1.3kAutomated safety check: PassAGPL-3.0
Scenario Video Assemblyscenario-labs/skills913—~2.2kAutomated safety check: PassMIT
AI Avatar Videoaiskillstore/marketplace4301 repos~2.4kAutomated safety check: PassNone
Super Video MakerBomx/super-video-maker-skill308—~11kAutomated safety check: NotesNone
Audio And Videoglifxyz/glif-mcp-server212—~1.1kAutomated safety check: PassMIT
Ugcfal-ai-community/skills249—~1.5kAutomated safety check: PassNone

Similar skills

  • Scenario Video Assembly

    scenario-labs/skills

    A skill your agent uses when generated clips must become a finished video on Scenario via MCP: cutting a shot list together, laying a timeline, concatenating with transitions, overlaying a logo or…

    913 GitHub stars~2.2k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • AI Avatar Video

    aiskillstore/marketplace

    Create AI avatar and talking head videos via inference.sh CLI.

    430 GitHub starsUsed in 1 repo~2.4k tokens
    Media & CreativeAuto-check passed
  • Super Video Maker

    Bomx/super-video-maker-skill

    End-to-end AI video production skill for agentic frameworks.

    308 GitHub stars~11k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Audio And Video

    glifxyz/glif-mcp-server

    Make or edit audio and video with Glif instead of writing generation code or using another tool.

    212 GitHub stars~1.1k tokensUpdated today
    Media & CreativeAuto-check passed
  • Ugc

    fal-ai-community/skills

    Plan and run UGC-style creator ads and social proof videos with genmedia.

    249 GitHub stars~1.5k tokensUpdated 9 days ago
    Marketing & SEOAuto-check passed
  • Scenario Ugc

    scenario-labs/skills

    A skill your agent uses when producing UGC-style creator video with Scenario: a talking-head ad or testimonial from a portrait and a script, a founder clip, a product demo or unboxing, a reaction or…

    913 GitHub stars~3.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from nodetool-ai/nodetool

All 127 skills in this repo
  • Beat Sync Editing

    nodetool-ai/nodetool

    Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.

    556 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Caption Titles

    nodetool-ai/nodetool

    Add and animate a consistent text layer on an existing NodeTool timeline.

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Color Motion

    nodetool-ai/nodetool

    Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.

    556 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Commercial Beat Sheet

    nodetool-ai/nodetool

    Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.

    556 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Elevenlabs Audio Prompting

    nodetool-ai/nodetool

    Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Frame Composition

    nodetool-ai/nodetool

    Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.

    556 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Questions about Script Video

What does Script Video do?

Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll. Script Video is an agent skill from nodetool-ai/nodetool. Direct a NodeTool video whose timing follows written voiceover, such as an explainer or narrated b-roll.

When should I use Script Video?

Script Video fits situations like: tasks that involve Text to speech and voice; tasks that involve Influencer and creator marketing.

How do I install Script Video in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill script-video -a claude-code`. Or copy the skill folder (packages/system-skills/script-video in nodetool-ai/nodetool) into .claude/skills/script-video in your project. Claude Code loads it when a task matches its description.

How do I install Script Video in Codex?

Run `npx skills add nodetool-ai/nodetool --skill script-video -a codex`. Or copy the skill folder (packages/system-skills/script-video in nodetool-ai/nodetool) into .agents/skills/script-video in your project. Codex loads it when a task matches its description.

Can I use Script Video in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill script-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/script-video, .gemini/skills/script-video, .github/skills/script-video and .opencode/skills/script-video in your project.

What does Script Video need to run?

SKILL.md names no scripts, command-line tools or credentials: Script Video is instructions for the agent only.

Does Script Video access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Script Video safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Script Video use?

Script Video is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Script Video use?

About 1.3k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Script Video?

Skills that share tags, products or a category with Script Video: Scenario Video Assembly (scenario-labs/skills, 913 stars), AI Avatar Video (aiskillstore/marketplace, 430 stars), Super Video Maker (Bomx/super-video-maker-skill, 308 stars) and Audio And Video (glifxyz/glif-mcp-server, 212 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Script Video?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 556 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 8, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.