AGENT SKILL

caption-titles

Add and animate a consistent text layer on an existing NodeTool timeline. Use for titles, lower-thirds, captions, callouts, end cards, number tickers, deterministic scrambles, and text on a path.

License 许可
AGPL-3.0
最近更新
2026-11-15
Stars
★ 635
Forks
91

01 前言 Front Matter

name
caption-titles
featured
true
description
Add and animate a consistent text layer on an existing NodeTool timeline. Use for titles, lower-thirds, captions, callouts, end cards, number tickers, deterministic scrambles, and text on a path.

03 SKILL.md 正文

Caption & Titles → Timeline Agent

Work directly with timeline capabilities and open-timeline tools. Do not build a workflow or fabricate a cut.

timeline-edit-ops carries the op contract for every call named here. motion-principles gives the entry and exit durations and easing behind each tier's presets, frame-composition fixes the safe inset and where a tier sits, color-motion the scrim and contrast fixes when type does not read, and logo-reveal owns the brand mark at the head or tail.

Type is post, never a render prompt

Every board skill and every video prompting skill sends its on-screen copy here. A title card, a super, a lyric or a CTA is a text clip on the timeline, not words in a generate_video or generate_image prompt: generators letter unreliably, and copy baked into pixels cannot be corrected, translated or re-timed. When a board's shot action carries Text: …, that is the caption map's input, and the render prompt should not have asked for it.

Hard gate

List and read the selected timeline first. When the job is to caption or title footage, the timeline must contain picture clips. If it is missing or has none, stop and ask for a real cut; route users to storyboard or script-to-timeline work instead. A typographic piece built from type and shapes alone, such as a title sequence, kinetic text or a standalone end card, needs no picture clips: build it through motion-graphics and use the tiers below for its type. Snapshot the timeline before editing with create_timeline_version.

Read fps, width and height off get_timeline before setting a size: fontSizePx is authored against the sequence resolution, and the tiers below are fractions of height.

Lock one type system before adding text

Resolve type family and tier weights, five size tiers as fractions of frame height, text/accent/scrim palette, safe inset and maximum width, and per-tier motion presets. Prefer a supplied brand kit, then existing text on the timeline, then a platform-safe system. Keep these tiers consistent: T1 title/end card, T2 lower-third, T3 captions, T4 callouts, T5 CTA.

The family is one NodeTool ships — Inter, Space Grotesk, Bebas Neue, Playfair Display, Lora, JetBrains Mono — or every host resolves it against its own installed fonts, the editor and the render disagree on line widths, and validate_timeline reports font_not_portable. Sizes below 2.5% of frame height report text_illegible; body copy sits at 2.5–4%. motion-direction holds the same rule for the whole piece, so when a motion language already exists, take its type family rather than picking a second one.

Motion per tier follows motion-principles: fade or slide in at 300–500ms, out at 200–300ms, role-default easing. Stagger only on a T1 or a kinetic T3 line of five words or fewer, and work out the span (durationMs + offsetMs × (words − 1)) against the clip — a span that does not fit is compressed silently and only stagger_compressed says so.

Each tier has a shipped composition. Insert it with {"op": "insert_composition", "composition_id": "<id>", ...} and override its params rather than building the rig from bare clips — the timing and motion inside it are already balanced.

Tier Composition id
T1 title title-card
T2 lower-third lower-third
T3 captions caption-bar
T4 callouts callout
T5 CTA / end card cta-end-card

A brand mark at the head or tail is logo-sting.

Every live-picture T2–T4 element gets a matching scrim unless the plate is demonstrably controlled.

Caption map

Write the timed map before editing: tier, exact text, start/end, position, and scrim. Caption duration is at least max(1200ms, words × 350ms). Titles/end cards stay on screen at least 2000ms, which leaves the read hold motion-principles § Holds sets between their in and out. Lower-thirds arrive about 500ms after a person appears and hold 2500–4000ms. One text idea per frame. Unknown facts use [INPUT NEEDED: …].

Animate the letters and their content

For a number that changes during a text clip, store textAnimator on an animation with kind: "ticker", from, and to. It also accepts decimals, padTo, prefix, and suffix. Set groupSeparator to "," to show thousands as 2,847; omitting it keeps existing tickers ungrouped. For a deterministic decode into the clip's authored text, use kind: "scramble" with a fixed seed and optional charset. These operate over the animation window, so a held final frame shows the finished value.

{"id": "count-in", "role": "in", "preset": "fade", "durationMs": 900,
 "textAnimator": {"kind": "ticker", "from": 1, "to": 7,
  "padTo": 2, "suffix": " / 07"}}

For unit-by-unit motion, set stagger.unit to character, word, or line and give it offsetMs. With a text stagger, styleTracks can target glyph.color, glyph.blurPx, or glyph.trackingPx. The colour uses CSS colour values; blur and tracking use sequence pixels. Use text.color or text.fill.stops.0.color for a whole line. A text fill gradient also exposes text.fill.angle and stop offsets. The target must refer to an existing style field; text.color is hidden while a gradient fill is set.

To lay a title along a curve, set textStyle.path to an SVG path in normalized canvas coordinates. This places the baseline on the path. It does not make each character travel along it. Shape and mask paths can morph through shape.d and mask.d style tracks when both paths have matching commands and point counts. Use followPath when the whole clip should move along a path.

edit_timeline's animate_clip input accepts presets and custom numeric curves, but does not accept textAnimator or styleTracks; those fields are dropped from that call. To author them, read the current document and use set_timeline_document with the animation fields in the clip. That call validates the complete document and snapshots the previous state. Preserve the other tracks and clips from the document. timeline-edit-ops owns the full tool contract.

Build and verify

Add separate overlay and subtitle tracks. For each map item, add scrim before text, apply the locked tier style, then animate it with that tier’s entry and exit preset. No hard cut-on. Use stagger only for tone-appropriate kinetic captions. Keep all text within safe margins and clear of faces and product moments.

Two facts about stacking decide whether the text is seen at all. The lowest track index draws on top, so the scrim's track index sits between the picture's and the text's — picture, scrim, text, in descending index. And word-level captions generated from a voiceover clip composite above every real track regardless of where that clip sits, so no title can cover them: time a T1 around the narration rather than over it.

Verify in two passes, and they answer different questions. validate_timeline reads the document: text_illegible (size, or under 3:1 contrast against the text's own background plate or a full-frame shape behind it), font_not_portable, stagger_compressed, animation_exceeds_clip, overlaps, and clips shorter than a frame. Its contrast check refuses to guess — a translucent scrim, gradient type or a plate it cannot prove is behind the text produces no finding — so a silent pass is not a pass. Then preview_timeline_frame at each item's entry midpoint, a held moment, and its exit: that is where text over a busy plate, a scrim covering a face, or a caption still finishing when its clip ends shows up. Re-read the map against the frames: timing, reading floors, scrim ordering, one CTA at the end. Then render with render_timeline before calling the layer done, as timeline-edit-ops § The render loop describes: the frames show one timecode, the render shows the timing at speed.

04 同仓库更多 Skills

nodetool-ai
nodetool-ai/nodetool

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.

★ 635
nodetool-ai
nodetool-ai/nodetool

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.

开发工程师Skill与智能体开发
★ 635
nodetool-ai
nodetool-ai/nodetool

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.

图像与多媒体
★ 635
nodetool-ai
nodetool-ai/nodetool

video-workflow

Build a reusable NodeTool video workflow for batches or repeated inputs. For a single finished piece, use a storyboard skill.

图像与多媒体Skill与智能体开发
★ 635
nodetool-ai
nodetool-ai/nodetool

video-clone

Analyze a reference video and recreate its shot structure with a new product or cast in NodeTool.

图像与多媒体
★ 635
nodetool-ai
nodetool-ai/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.

图像与多媒体
★ 635