Agent skill

Music Video Treatment

by nodetool-ai in nodetool-ai/nodetool

Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard.

AGPL-3.0Auto-check passedMedia & Creative

Install Music Video Treatment

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

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

GitHub CLI
$ gh skill install nodetool-ai/nodetool music-video-treatment --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/music-video-treatment .claude/skills/music-video-treatment && 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
music-video-treatment
GitHub stars
560
Token cost
~1.3k tokens
SKILL.md length
714 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard.

  • Music videos and promos
  • SKILL.md covers Brief and truthfulness, Entity roster, Music grid and treatment and Persist the board, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Finished renders

What it does

Music Video Treatment is an agent skill from nodetool-ai/nodetool. Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard. Use for music videos and promos, not workflows, pipelines, or finished renders.

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 Comics and storyboards. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • Music videos and promos
  • Finished renders

Example prompts

  • “/music-video-treatment”

What it can do on your machine

Read from SKILL.md and the folder at commit 339f069. 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

Music Video Treatment loads about 1.3k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 714 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
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 339f069, republished under its AGPL-3.0 licence (© nodetool-ai). 714 words, ~1,257 tokens.

Download SKILL.mdSave it as .claude/skills/music-video-treatment/SKILL.md (or your agent's skills folder).
name
music-video-treatment
description
Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard. Use for music videos and promos, not workflows, pipelines, or finished renders.

Music Video Treatment → Storyboard Agent

Create a complete, shootable music-video treatment as a NodeTool storyboard. Work directly through storyboard and entity capabilities. Do not build a workflow or pipeline. Do not render or assemble a timeline unless asked.

Brief and truthfulness

Require artist and persona, track title, genre, BPM, time signature, track length, a timecoded section map, performance-to-narrative ratio, platform, tone, and any mandatory or forbidden content. BPM and section map are hard inputs. If neither a section map nor audio is available, ask rather than invent bar counts. Mark unknown artist, label, release, lyric, or production facts as [ARTIST INPUT NEEDED].

Entity roster

Resolve the roster before drafting sections: user references first, then list_entities, then generate only missing references. The artist is always a character entity and a provided press image is never regenerated. Resolve style first; apply it to generated artist, locations, and props. Keep a typical roster to 4–7 entities: style, artist, 1–2 locations, and 0–2 signature props. Show the roster and flag a generated artist as a stand-in before treatment drafting.

Music grid and treatment

Compute seconds per bar as (60 / BPM) × beats per bar, convert every section into bars and timecodes, and make every transition land on a bar, beat, or lyric. Build three distinct directions with a performance/narrative ratio, repeatable chorus hook shot, drop event, risk, and entity roster. Recommend one in two sentences or fewer.

For each section, provide timecode and bar range, musical and visual jobs, framing, lens/angle, movement, visual/action, sync point, entities, performance, lyric text when applicable, lighting, grade/effect, transition, and why it cuts. Interleave performance and narrative. The biggest event lands on the drop or first chorus downbeat; every chorus repeats the hook shot; include one deliberate rhythmic break before the final chorus; the outro echoes the intro.

Persist the board

Create a storyboard with create_storyboard({ name, brief, style, aspect_ratio }), using storyboard_id from its result, never .id. Put the full brief, lyrics, section map, bar grid, and roster in brief. The call shapes every board skill shares — entity id equals the asset id you passed in, the five edit_storyboard ops, what set_board accepts, what text the generator actually reads — are in commercial-beat-sheet § Tool contract.

Attach entity ids with edit_storyboard({ storyboard_id, ops: [{ op: "set_board", entity_ids, image_model, video_model }] }) (set_entities is only an alias). The two models are the .ref of a find_model call each, for text_to_image and image_to_video; load the prompting_skill each one names before writing shot text, since motion then action is the clip prompt verbatim and a performance section is worded differently for Kling's shot list, Hailuo's ordered beats or Seedance's sound brief.

Show full SKILL.md (281 more words)Show less

Add one add_shot op per section. Each action names visible entities in brackets, includes its sync point, and uses the section duration rounded to 0.5 seconds. The render attaches the artist or a prop to a shot only when its name appears in that shot's text (style and location always apply), so the artist's name goes in every performance shot, or on that shot's own entity_ids. Lyric text on screen is a note for the cut and goes on as a text clip after assembly (caption-titles), not into the render prompt.

Stop at the planned board unless asked to render. Report the directions, selected treatment, and entity roster.

Render (only on request)

Stills first with render_storyboard_stills; look at each with view_image asking what is wrong, and fix a drifting artist at the entity, never in one shot's prompt. Clips with render_storyboard_clips; ask for longer clips than the section needs (bump duration_seconds with update_shot, restore after) so the cut has frames to choose from on the beat. A clip wrong where its still was right is one revise_storyboard_clip. Then assemble_storyboard_timeline.

When the treatment becomes a cut

The bar grid computed above is the plan; beat-sync-editing derives the real one from the track with detect_audio_events and snaps the cuts to it, so the two must agree before anything is trimmed. The track is the continuity here, so section clips render separately and mute their own audio — video-audio-continuity for the case where a piece has no track of its own. motion-graphics carries the timeline op contract, color-motion the per-section grade and any colour that moves on the drop, frame-composition the repeated hook framing across choruses, and caption-titles any lyric or artist card on screen.

© 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/music-video-treatment of nodetool-ai/nodetool.

Open the folder on GitHubat commit 339f069

Compare with similar skills

Music Video Treatment 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.

Music Video Treatment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Music Video Treatment this skillnodetool-ai/nodetool560—~1.3kAutomated safety check: PassAGPL-3.0
Canghe Comicfreestylefly/canghe-skills4618 repos~3.2kAutomated safety check: PassNone
Tutti UI Systemtutti-os/tutti3.8k—~2.7kAutomated safety check: PassApache-2.0
3D Animation Short Generatortl2012tl/comfyUI-llama-TE2414 repos~3.7kAutomated safety check: PassNone
Text to PNG Card Casterlijigang/ljg-skills7.5k—~1.9kAutomated safety check: PassMIT
H3 Cinematic Directorjtydhr88/ComfyTV1.1k—~2.7kAutomated safety check: PassMIT

Similar skills

  • Canghe Comic

    freestylefly/canghe-skills

    Knowledge comic creator supporting multiple art styles and tones.

    461 GitHub starsUsed in 8 repos~3.2k tokens
    Media & CreativeAuto-check passed
  • Tutti UI System

    tutti-os/tutti

    A skill your agent uses when working with @tutti-os/ui-system components, replacing local UI with shared components, querying component ids or metadata, promoting UI into shared base or business…

    3.8k GitHub stars~2.7k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • 3D Animation Short Generator

    tl2012tl/comfyUI-llama-TE

    Create complete stylized 3D animated shorts from a story idea through an ordered production workflow covering project brief, story outline, character and environment cards, standardized shot…

    241 GitHub starsUsed in 4 repos~3.7k tokens
    Media & CreativeAuto-check passed
  • Text to PNG Card Caster

    lijigang/ljg-skills

    Turns text, URLs or local files into tall PNG cards through HTML typography, with four modes: long reading card, full-text layout, comic and whiteboard.

    7.5k GitHub stars~1.9k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • H3 Cinematic Director

    jtydhr88/ComfyTV

    Convert approved scripts, shot briefs, storyboards, keyframes, character sheets, scene assets, prop sheets, and sound briefs into director-level storyboards and production-ready MiniMax H3 prompts.

    1.1k GitHub stars~2.7k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Scroll Promo Site Builder

    kangarooking/kangarooking-skills

    Create a scroll-controlled cinematic product website with rich motion (动效网站) from product materials, reference pages or videos, and brand assets.

    662 GitHub stars~2.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-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.

    560 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.

    560 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.

    560 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.

    560 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…

    560 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.

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

Questions about Music Video Treatment

What does Music Video Treatment do?

Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard. Music Video Treatment is an agent skill from nodetool-ai/nodetool. Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard.

When should I use Music Video Treatment?

Music Video Treatment fits situations like: music videos and promos; finished renders.

How do I install Music Video Treatment in Claude Code?

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

How do I install Music Video Treatment in Codex?

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

Can I use Music Video Treatment 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 music-video-treatment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/music-video-treatment, .gemini/skills/music-video-treatment, .github/skills/music-video-treatment and .opencode/skills/music-video-treatment in your project.

What does Music Video Treatment need to run?

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

Does Music Video Treatment 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 Music Video Treatment 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 Music Video Treatment use?

Music Video Treatment 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 Music Video Treatment 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 Music Video Treatment?

Skills that share tags, products or a category with Music Video Treatment: Canghe Comic (freestylefly/canghe-skills, 461 stars), Tutti UI System (tutti-os/tutti, 3.8k stars), 3D Animation Short Generator (tl2012tl/comfyUI-llama-TE, 241 stars) and Text to PNG Card Caster (lijigang/ljg-skills, 7.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Music Video Treatment?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 560 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 10, 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.