music-video-treatment
Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard. Use for a music video cut to a track, not ads or promos (commercial-beat-sheet, motion-ad), workflows, pipelines, or finished renders.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-11-15
- Stars
- ★ 635
- Forks
- 91
01 前言 Front Matter
- name
- music-video-treatment
- description
- Turn confirmed track metadata into a shootable, beat-synced music-video treatment and NodeTool storyboard. Use for a music video cut to a track, not ads or promos (commercial-beat-sheet, motion-ad), workflows, pipelines, or finished renders.
03 SKILL.md 正文
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. 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 fifteen edit_storyboard ops, what set_board accepts, what text the generator actually reads — are in storyboard-core § 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, action and the camera movement are the keyframe clip prompt and a performance section is worded differently for Kling's shot list, Hailuo's ordered beats or Seedance's sound brief.
A section usually runs longer than one generated clip (a 20s chorus against a 5–10s clip), so give each section several add_shot ops, one per phrase or bar group, each with its slice of the section's duration rounded to 0.5 seconds and the section name in its slug. Each action names visible entities in brackets and includes its sync point. 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 at each shot's own duration_seconds; the model snaps it to the lengths it offers, which usually leaves frames to trim on the beat. Asking for longer clips than the shots need buys footage the cut throws away: report the extra clip seconds and get the user's go-ahead first (storyboard-core § Fusing shots). 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. timeline-edit-ops carries the timeline op contract, motion-graphics the build loop, 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.
04 同仓库更多 Skills
humanizer
Rewrite AI-sounding text so it reads like the writer without changing what it says. Use when editing or reviewing prose for AI tells: not-X-but-Y contrasts, one-line closers, staged openers, forced triads, dashes everywhere, inflated claims, sales language, stock AI words, bold labels, or filler.
nodetool
Use the NodeTool MCP server to build, validate, run, and debug visual AI workflows, and to work with assets, collections, and jobs. Use when the user mentions NodeTool or asks for a workflow graph, a node, or a media generation run on their NodeTool server.
wan-2-6-prompting
Prompt Alibaba's Wan 2.6 video — text-to-video with a global style line plus timing-bracketed shots, and image-to-video that describes only what changes over time. Covers the shot-mode switch per provider, the prompt budget, negative prompts, motion intensity wording, audio input and prompt expansion. Use whenever the model id names a Wan 2.6 video route (alibaba/wan-2.6/text-to-video, alibaba/wan-2.6/image-to-video, wan-video/wan-2.6-t2v, wan-video/wan-2.6-i2v, wan-video/wan2.6-i2v-flash) on generate_video, animate_image or a TextToVideo node. Not for Wan 2.5 or 2.7, or the Wan 2.6 image routes.
video-workflow
Build a reusable NodeTool video workflow for batches or repeated inputs. For a single finished piece, use a storyboard skill.
video-clone
Analyze a reference video and recreate its shot structure with a new product or cast in NodeTool.
video-audio-continuity
Keep sound continuous across a multi-scene piece cut from generated video — why one clip per scene hard-cuts the audio at every boundary, when to write all the scenes into a single generation instead, the sound-design vocabulary that survives a provider's copyright filter, and how to check the length, the aspect ratio and the mix of what came back. Use when a piece has more than one scene and the video model writes its own audio (Seedance 2, Veo 3, MiniMax H3, Kling 2.6 and later), or when a cut's sound drops out at the shot changes.