Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
Audit Narratage skill surface mappings
rpone2d4d8f77241d
diff --git a/.agent/skills/narratage/SKILL.md b/.agent/skills/narratage/SKILL.mdindex ed34b9e1..b805a594 100644--- a/.agent/skills/narratage/SKILL.md+++ b/.agent/skills/narratage/SKILL.md@@ -13,8 +13,8 @@ Source, and `svml.runtime.json`/`.ts` Runtime Profile separate.- Environment/setup or API keys → read `references/environment.md` and `references/credentials.md`.- SVML authoring → read `references/quickstart.md`, then the linked authoritative page under`docs/quickstart/`.-- Production craft or format choice → read `references/playbooks/index.md`, then only the relevant- craft/format file.+- Production craft or format choice → read `references/playbooks/index.md` and+ `references/playbooks/svml-mapping.md`, then only the relevant craft/format file.- Reference-video reverse engineering → read `references/reference-vlm.md`; have VLM emit`main.svml`, optional `studio.svs`, and `build.svrun` directly, never a JSON storyboard.- Execution → `check` first, `plan` before paid work, then `build`; inspect and retrieve durablediff --git a/.agent/skills/narratage/references/playbooks/craft/b-roll.md b/.agent/skills/narratage/references/playbooks/craft/b-roll.mdindex b85aa472..55138dae 100644--- a/.agent/skills/narratage/references/playbooks/craft/b-roll.md+++ b/.agent/skills/narratage/references/playbooks/craft/b-roll.md@@ -12,5 +12,5 @@- For software demos, use complementary context and proof images: person/device relationship first,then a device-screen shot from a physically possible reverse viewpoint. Use real supplied UI whenexact fidelity matters.-- Put changing text, labels, arrows, and cards in Typography/Media Tracks. Keep product labels and+- Put changing text, labels, arrows, and cards in `text:Track`/`media-track:Track`. Keep product labels andUI text physically attached to the product or screen.diff --git a/.agent/skills/narratage/references/playbooks/craft/captions.md b/.agent/skills/narratage/references/playbooks/craft/captions.mdindex e7543794..a0db4408 100644--- a/.agent/skills/narratage/references/playbooks/craft/captions.md+++ b/.agent/skills/narratage/references/playbooks/craft/captions.md@@ -1,10 +1,10 @@# Caption craft-- Use one Caption Program/Track for the program. Route speakers and styles through role/word rules,+- Use one `caption:Program` and one `caption-fine:Track` for the program. Route speakers and styles through role/word rules,not duplicate caption tracks.- Keep the spoken Script authoritative. Transcribe real audio; do not copy burned-in referencesubtitles. Preserve original-language speech and translate separately when needed.-- Use the WhisperX SemanticMap for timing. A planner may group whole display Atoms but cannot rewrite+- Use the WhisperX SemanticMap for timing. `caption-gemini:Planner` may group whole display Atoms but cannot rewritetext, invent timing, or split an indivisible Dual Text Atom.- Keep captions in a safe region, avoid faces/product/UI, and use a stable-size Recipe when uniformreadability matters. Hide words with an explicit visibility rule, not by deleting source text.diff --git a/.agent/skills/narratage/references/playbooks/craft/overlays.md b/.agent/skills/narratage/references/playbooks/craft/overlays.mdindex 73090e85..2da1fb6f 100644--- a/.agent/skills/narratage/references/playbooks/craft/overlays.md+++ b/.agent/skills/narratage/references/playbooks/craft/overlays.md@@ -2,14 +2,16 @@- Base and overlays are complementary. Base prompts ignore captions, stickers, arrows, cards, UI,logos, and transition graphics; overlay analysis ignores the photographed base.-- Preserve every distinct changing or scrolling text segment. Put editable text in Text inputs and- Typography Track content, not hard-coded generated segments.+- Preserve every distinct changing or scrolling text segment. Put editable text in `text:Value`+ inputs and `text:Track`/`text:Area` content, not hard-coded generated segments.- Infer alignment across frames: left, center, or right anchoring is a continuity decision. Keep textinside safe zones and away from faces, products, and key UI.- Classify non-text layers by source: `real` photographed PIP/B-roll may be generated; `provided`screenshots, UI, charts, finished graphics, logos, and alpha stickers require supplied media.-- Prefer spoken-phrase timing using a literal contiguous transcript substring; do not anchor to the- final sentence. Without speech, use a scene-relative fraction/manual window, never source-video- absolute seconds.+- Prefer semantic timing through a Script `Selection` or `Moment` resolved by the WhisperX+ `SemanticMap`: use `during={story.selection.<id>}` for a range or `at={story.moment.<id>}` with+ an explicit `for` duration for a point. Without speech timing, use `during="program"` or explicit+ author-time `start`/`end` values in the shared `ProgramSpace`; never infer a window from a source+ video's original timestamps.- Report unsupported effects with a reason. Build an approximation only when the gap stays attachedto the authored element; never silently downgrade.diff --git a/.agent/skills/narratage/references/playbooks/craft/persona-and-audio.md b/.agent/skills/narratage/references/playbooks/craft/persona-and-audio.mdindex afc7a596..5d3584d9 100644--- a/.agent/skills/narratage/references/playbooks/craft/persona-and-audio.md+++ b/.agent/skills/narratage/references/playbooks/craft/persona-and-audio.md@@ -8,4 +8,5 @@reference-duration limits and inspect duration before planning.- Choose the voice before finalizing shot timing when TTS is the sole source. One continuous voiceovercan cover independently selected visual cuts; do not split TTS merely to mirror each shot.-- Keep speech, music, and effects as separate explicit audio contributions. Dialogue wins the mix.+- Keep speech, music, and effects as separate explicit `audio:Track` contributions made of+ `audio:Clip` items. Dialogue wins the mix.diff --git a/.agent/skills/narratage/references/playbooks/craft/pip-overlay.md b/.agent/skills/narratage/references/playbooks/craft/pip-overlay.mdindex 14b3b7b8..fdeeb4c6 100644--- a/.agent/skills/narratage/references/playbooks/craft/pip-overlay.md+++ b/.agent/skills/narratage/references/playbooks/craft/pip-overlay.md@@ -1,7 +1,8 @@# Picture-in-picture overlay craft- Decide whether PIP is real photographed video, supplied recording, or a composited subject with- transparency. Use the matching explicit Media Track input; do not call every non-text layer a sticker.+ transparency. Use `media-track:Item` with `video`, `media`, or `surface`; do not call every non-text+ layer a sticker.- Establish a stable placement Frame, crop, border/paint, and stack order. Keep the PIP clear ofcaptions, faces, product labels, and the base shot's main evidence.- A talking reaction PIP must remain visually alive but silent unless its audio is explicitly included.diff --git a/.agent/skills/narratage/references/playbooks/craft/production-gates.md b/.agent/skills/narratage/references/playbooks/craft/production-gates.mdindex 32162214..ac11f7a2 100644--- a/.agent/skills/narratage/references/playbooks/craft/production-gates.md+++ b/.agent/skills/narratage/references/playbooks/craft/production-gates.md@@ -10,8 +10,8 @@unwanted text, and impossible camera relationships.- Review each video shot independently: motion starts from the reference, stays in 4–15 seconds,preserves props/wardrobe/space, and contains no generated overlays.-- Review captions, typography, and media overlays on the real base program for safe zones, occlusion,- phrase anchors, and stacking.+- Review `caption-fine:Track`, `text:Track`, and `media-track:Track` on the real base program for+ safe zones, occlusion, semantic timing, and stacking.- Use mock/provider-free inputs to validate topology and timing. Do not mock the only audio sourcewhen acceptance depends on real speech or TTS.- Regenerate only failed shots and reuse accepted Artifacts explicitly in a later Run Source; therediff --git a/.agent/skills/narratage/references/playbooks/craft/screen-demo.md b/.agent/skills/narratage/references/playbooks/craft/screen-demo.mdindex e0f2f442..0def97ab 100644--- a/.agent/skills/narratage/references/playbooks/craft/screen-demo.md+++ b/.agent/skills/narratage/references/playbooks/craft/screen-demo.md@@ -4,7 +4,7 @@provided media; a floating card over live action is an overlay. Do not regenerate exact UI.- Pair context and proof: show the person/device relationship, then show the actual UI from the user'sposition. Keep device orientation, screen content, and room geometry consistent.-- Keep UI text attached to the screen. Use Typography Track only for editorial callouts outside the+- Keep UI text attached to the screen. Use `text:Track` only for editorial callouts outside theUI. Use continuous motion when a document, receipt, or screen must remain unchanged.- Ask for the real screenshot, recording, or alpha asset when fidelity matters. Mark the missing assetand gap instead of hallucinating a similar interface.diff --git a/.agent/skills/narratage/references/playbooks/craft/sfx.md b/.agent/skills/narratage/references/playbooks/craft/sfx.mdindex 07041877..fa6dda9b 100644--- a/.agent/skills/narratage/references/playbooks/craft/sfx.md+++ b/.agent/skills/narratage/references/playbooks/craft/sfx.md@@ -7,5 +7,6 @@- Trigger at the audience-perceived event, not automatically at every shot boundary.- Keep a consistent sound vocabulary for repeated cards/UI/actions. Music owns continuous emotion;SFX owns discrete events.-- Review dialogue alone, then music, then effects. Check headphones and phone speakers, and listen to+- Review dialogue alone, then music, then effects. Author each contribution as an `audio:Clip` inside+ an `audio:Track`; check headphones and phone speakers, and listen tothe entire program for density rather than approving isolated loops.diff --git a/.agent/skills/narratage/references/playbooks/formats/asmr.md b/.agent/skills/narratage/references/playbooks/formats/asmr.mdindex 2a1074e1..0e4a4893 100644--- a/.agent/skills/narratage/references/playbooks/formats/asmr.md+++ b/.agent/skills/narratage/references/playbooks/formats/asmr.md@@ -6,8 +6,8 @@ Evidence level: thin.rubbing. Keep motion micro/readable, not energetic or impact-heavy.- Keep the shot continuous and camera close/locked. Rapid cuts or large camera moves break thesound-image continuity.-- Generated visuals remain silent. Author texture sound, ambience, and music as explicit audio tracks- aligned to the visible event.+- Generated visuals remain silent. Author texture sound, ambience, and music as explicit+ `audio:Track`/`audio:Clip` contributions aligned to the visible event.- Choose references with strong material texture and clean geometry. Review looping, contact points,duplicated tools, and end-frame artifacts before adding sound.- Use a higher-quality generation model when fine surface detail is the point; verify the requesteddiff --git a/.agent/skills/narratage/references/playbooks/formats/mass-tarot.md b/.agent/skills/narratage/references/playbooks/formats/mass-tarot.mdindex cfd8d437..4d011dd6 100644--- a/.agent/skills/narratage/references/playbooks/formats/mass-tarot.md+++ b/.agent/skills/narratage/references/playbooks/formats/mass-tarot.md@@ -7,9 +7,10 @@ Evidence level: thin.- Frame interpretation as reflection, not guaranteed fortune-telling. Offer themes/directions, notexact dates, flat verdicts, or promised outcomes. Personality questions describe traits, not apredicted person's physical appearance.-- Generate silent card/table motion; author narration and all editorial text separately. Numbers,- questions, and interpretation lines belong in Typography/Caption Tracks unless physically printed+- Generate silent card/table motion with `seedance:ReferenceVideo`; author narration and all editorial+ text separately. Numbers, questions, and interpretation lines belong in `text:Track` or the+ `caption:Program` + `caption-fine:Track` pair unless physically printedon supplied card art.- Use real supplied card faces when exact symbolism matters. Keep card order and identity stable fromselection through reveal.-- Validate every claim and visual cue with the operator before production; do not fabricate certainty.+- Validate every claim and visual cue with the project reviewer before production; do not fabricate certainty.diff --git a/.agent/skills/narratage/references/playbooks/formats/mixcut.md b/.agent/skills/narratage/references/playbooks/formats/mixcut.mdindex 2b8f719c..324bd329 100644--- a/.agent/skills/narratage/references/playbooks/formats/mixcut.md+++ b/.agent/skills/narratage/references/playbooks/formats/mixcut.md@@ -1,11 +1,13 @@# Silent visual mixcut format- Each beat is a reference frame plus a silent generated motion clip. Keep clips 4–15 seconds, use- distinct roles (hook, rhythm, detail/effect, conversion/payoff), and concatenate deliberately.-- Without speech, use fixed scene-relative windows for titles, benefits, and CTA. Lock effective- duration before laying out overlays; changing a clip duration requires updating all windows.+ distinct roles (hook, rhythm, detail/effect, conversion/payoff), and assemble ordered+ `media-track:Item` inputs deliberately.+- Without speech, use explicit `start`/`end` values in the shared `ProgramSpace` for titles, benefits,+ and CTA. Lock effective duration before laying out overlays; changing a clip duration requires+ updating those authored times.- Make the first three seconds immediately engaging. Music or voiceover is the only audio source whengenerated clips are silent; truncate deliberately rather than letting a long track drift.- Keep at most one or two text groups on screen at once. Product claims must match verified facts andthe visible frame. Alpha graphics retain transparency and point to the intended CTA.-- Omit caption components when there is no spoken base; use Typography Track for editorial copy.+- Omit caption components when there is no spoken base; use `text:Track` for editorial copy.diff --git a/.agent/skills/narratage/references/playbooks/formats/ranking-listicle.md b/.agent/skills/narratage/references/playbooks/formats/ranking-listicle.mdindex 159d1f12..65b73f63 100644--- a/.agent/skills/narratage/references/playbooks/formats/ranking-listicle.md+++ b/.agent/skills/narratage/references/playbooks/formats/ranking-listicle.md@@ -2,7 +2,8 @@Evidence level: partial.-- Use one ranking/deck presentation system for all items; change layout/style through its Recipe or+- Use one official `ranking` variant (`TierBoard`, `Column`, `TopThree`, or `TypewriterList`) or one+ `deck:DepthStack` for all items; change layout/style through its Recipe orcomponent configuration rather than duplicating competing tracks.- Every item has a stable identity, label/icon, rank/tier, and narrow semantic evidence window. Anon-contiguous Selection does not implicitly clone an item; author repeated appearances explicitly.diff --git a/.agent/skills/narratage/references/playbooks/formats/scenario-call.md b/.agent/skills/narratage/references/playbooks/formats/scenario-call.mdindex 475475f8..f72d27e5 100644--- a/.agent/skills/narratage/references/playbooks/formats/scenario-call.md+++ b/.agent/skills/narratage/references/playbooks/formats/scenario-call.md@@ -1,5 +1,8 @@# Scenario-call format+This is an editorial recipe, not a native call generator. Use two `seedance:ReferenceVideo` outputs+or supplied video assets, then compose main/inset views with `media-track:Track` and explicit Frames.+Evidence level: thin.- Prepare two final call-layout references: A main with B inset, and B main with A inset. Their main/@@ -8,7 +11,7 @@ Evidence level: thin.mouth; the listener remains alive in either main or inset view.- Keep both video feeds active. Do not let the inset become a frozen portrait unless that is explicitlythe story state.-- Use at most one Caption Program/Track. Put call labels, notifications, and editorial copy in explicit- Typography/Media Tracks; Seedance must not generate them.+- Use at most one `caption:Program` + `caption-fine:Track`. Put call labels, notifications, and+ editorial copy in explicit `text:Track`/`media-track:Track`; Seedance must not generate them.- Validate layout, speaker/voice assignment, reaction timing, and continuity with provider-free/mockmedia before a paid call generation.diff --git a/.agent/skills/narratage/references/playbooks/formats/street-interview.md b/.agent/skills/narratage/references/playbooks/formats/street-interview.mdindex 7c8844e0..7f1aeb1b 100644--- a/.agent/skills/narratage/references/playbooks/formats/street-interview.md+++ b/.agent/skills/narratage/references/playbooks/formats/street-interview.md@@ -1,5 +1,9 @@# Street-interview format+This is an editorial recipe, not a dedicated Narratage generation component. Compose it with a+`seedance:ReferenceVideo` per authored take (or supplied takes), explicit image/audio references,+and a shared `speech:Spine`; use `media-track:Track` for PIP/reaction layout.+- Establish one shared scene reference showing interviewer, guest, microphone, distance, and streetcontext. Establish two short clean voice references and a Script with explicit speaker cues.- Keep one locked or softly handheld two-person view. Drift may be slight, but do not cut to a new@@ -9,5 +13,6 @@performance only; never add words to the Script.- Define reverse-view backgrounds explicitly for reaction/device shots. Keep distinctive props stableacross the reference image and motion prompt.-- Use one Caption Program when captions are wanted. Overlay phrase anchors must be literal transcript- substrings and should not target the final sentence.+- Use one `caption:Program` + `caption-fine:Track` when captions are wanted. Put editorial overlays+ on a Script `Selection`/`Moment` resolved through the WhisperX `SemanticMap`; do not recreate the+ old phrase-query or source-timestamp locator model.diff --git a/.agent/skills/narratage/references/playbooks/formats/talking-head.md b/.agent/skills/narratage/references/playbooks/formats/talking-head.mdindex f728fcc8..264e3c19 100644--- a/.agent/skills/narratage/references/playbooks/formats/talking-head.md+++ b/.agent/skills/narratage/references/playbooks/formats/talking-head.md@@ -5,8 +5,9 @@- Keep one visual identity across A-roll: same face reference, room, wardrobe, and lighting. UseB-roll for changes, not to drift the presenter base.- Use `seedance:ReferenceVideo` for face/image/audio references; use `seedance:TextVideo` without an- identity reference. Keep dialogue and action as separate text inputs.-- Build one Speech Spine and one WhisperX Alignment. Add one Caption Track only when requested; add- B-roll through Media Track and editorial titles through Typography Track.+ identity reference. Keep dialogue and action as separate `text:Value` inputs.+- Build one `speech:Spine` and one `whisperx:Alignment`. Add `caption:Program` ++ `caption-fine:Track` only when requested; add B-roll through `media-track:Track` and editorial+ titles through `text:Track`.- Review A-roll and B-roll independently, then validate the joined Film. Reuse accepted shotsexplicitly in a later Run Source.diff --git a/.agent/skills/narratage/references/playbooks/formats/two-person-podcast.md b/.agent/skills/narratage/references/playbooks/formats/two-person-podcast.mdindex 29aba399..a06766b7 100644--- a/.agent/skills/narratage/references/playbooks/formats/two-person-podcast.md+++ b/.agent/skills/narratage/references/playbooks/formats/two-person-podcast.md@@ -1,12 +1,17 @@# Two-person podcast format+This is an editorial recipe, not a native podcast surface. Compose one or more+`seedance:ReferenceVideo` takes with two final camera-position references and explicit audio+references; use ordered `speech:Take` inputs and peer Tracks for assembly.+- Prepare two final camera-position reference images, not isolated portraits. They establish room,lighting, clothing, seating, and mutually consistent reverse views.- Prefix every Script line with an explicit speaker cue. Only the active speaker talks; the other hostremains present with breathing, listening, and reaction.- Choose rhythm deliberately: follow the speaker for measured dialogue or cut to a meaningful listenerreaction. Framing changes are crops/pushes inside locked A/B views, never invented cameras/locations.-- Use one Speech Spine, at most one Caption Track, and Typography/Media Tracks for titles/evidence.+- Use one `speech:Spine`, at most one `caption:Program` + `caption-fine:Track`, and `text:Track`/+ `media-track:Track` for titles/evidence.Keep dialogue/action prompts separate and in English.- Shape skeptical reviews asymmetrically: short challenge, longer grounded answer, mechanism/evidence,and a payoff that returns to the opening hook.diff --git a/.agent/skills/narratage/references/playbooks/formats/voiceover-desk-demo.md b/.agent/skills/narratage/references/playbooks/formats/voiceover-desk-demo.mdindex efa9d107..f4a5b475 100644--- a/.agent/skills/narratage/references/playbooks/formats/voiceover-desk-demo.md+++ b/.agent/skills/narratage/references/playbooks/formats/voiceover-desk-demo.md@@ -4,8 +4,9 @@visual shot lengths; do not split TTS merely to mirror visual cuts.- Keep every B-roll clip silent. Visual cuts follow visible screen/product changes, not sentenceboundaries; one sentence may cross several shots.-- Place voiceover as an explicit Audio Track over independent Media Track visuals. Because the base is- silent, do not rely on speech phrase anchors or captions unless a separately measured speech base- exists; use program/full/manual windows.+- Place voiceover as an explicit `audio:Track` over independent `media-track:Track` visuals. Because+ the base is silent, bind clips with `during="program"` or explicit `start`/`end` in the shared+ `ProgramSpace`; use a `Selection`/`Moment` only when a measured speech base and `SemanticMap`+ exist. Do not use phrase-query, `full`, or manual-locator semantics from another authoring system.- Treat UI, labels, receipts, and website text as provided physical screen content. Add editorial- explanations as Typography Track, never floating generator text.+ explanations as `text:Track`, never floating generator text.diff --git a/.agent/skills/narratage/references/playbooks/index.md b/.agent/skills/narratage/references/playbooks/index.mdindex 646cb116..bb7a7806 100644--- a/.agent/skills/narratage/references/playbooks/index.md+++ b/.agent/skills/narratage/references/playbooks/index.md@@ -1,16 +1,20 @@# Narratage production playbooks-Portable production patterns extracted from `twinit/playbooks` and rewritten for Narratage. These-files describe what to author and inspect, not twinit canvas nodes or JSON contracts.+Portable production patterns for Narratage. These files describe what to author and inspect, not+private renderer internals or an analysis-data contract.## Decision path1. Identify the format: talking head, street interview, two-person podcast, voiceover desk demo, or- silent mixcut.+ silent mixcut. Treat format files as editorial recipes; Narratage does not provide a native+ generation surface for every format.2. Apply universal gates: `production-gates`, `visual-continuity`, and `seedance-directing`.3. Add focused craft: `image-prompt-style`, `b-roll`, `overlays`, `captions`, `persona-and-audio`,or `screen-demo`.-4. Map the result to Script, Seedance, Speech Spine, SemanticMap, peer Tracks, Film, and Run Source.+4. Read `svml-mapping.md`, then map the result to actual Narratage surfaces: Script, Seedance `TextVideo`/`FrameVideo`/+ `ReferenceVideo`, Speech Spine, SemanticMap, peer Tracks, Film, and Run Source. If a format needs+ a capability not present in the package surface, use supplied media or supported primitives and+ record the gap.5. Run provider-free `check`/`plan`; only then release paid generation.## Universal prompt policy@@ -20,7 +24,7 @@ files describe what to author and inspect, not twinit canvas nodes or JSON contr- Describe desired states directly. Do not mention mutually exclusive alternatives or objects thatshould not appear; generation models can materialize them.- Never ask Seedance to render subtitles, captions, floating labels, stickers, or UI overlays. Author- those as Caption, Typography, or Media Tracks.+ those as `caption-fine:Track`, `text:Track`, or `media-track:Track`.## Craftdiff --git a/.agent/skills/narratage/references/playbooks/svml-mapping.md b/.agent/skills/narratage/references/playbooks/svml-mapping.mdnew file mode 100644index 00000000..3a84d518--- /dev/null+++ b/.agent/skills/narratage/references/playbooks/svml-mapping.md@@ -0,0 +1,38 @@+# Narratage surface mapping++Use this map when translating an editorial playbook into SVML. These are current package surfaces,+not aliases for the old canvas/JSON workflow.++| Editorial need | Narratage author surface |+|---|---|+| Story and dialogue | `Script`, `Segment`, `Role Cue`, `Selection`, `Moment` |+| Prompt or reusable copy | `text:Value` and `text:Render` (backed by Text Templates) |+| Generated image | `gpt:Image`, `nano:Image`/`nano:ProImage`, or `seedream:TextImage`/`ReferenceImage` |+| Text-to-video | `seedance:TextVideo` |+| First-frame-to-video | `seedance:FrameVideo` |+| Reference-image/audio-to-video | `seedance:ReferenceVideo` |+| Ordered speech-video assembly | `speech:Spine` with `speech:Take` children |+| Measured speech timing | `whisperx:Alignment` → `{timing.map}` |+| Caption policy | `caption:Program` |+| Caption planning/rendering | `caption-ai:Planner` + `caption-fine:Track` |+| B-roll, PIP, supplied media | `media-track:Track` + `media-track:Item` |+| Editorial titles/callouts | `text:Track` + `text:Area`/`text:Point`/`text:Path` |+| Music, voiceover, SFX | `audio:Track` + `audio:Clip` |+| Ranking/listicle visuals | an official `ranking:Column`/`TierBoard`/`TopThree`/`TypewriterList` or `deck:DepthStack` surface |+| Final composition | `film:Film` + `film:Track` |+| Video output | `render:Video` |+| Reusable run/build definition | `.svrun` Run Source, `Target`, and Runtime Profile |++## Timing rule++Use `during="program"` or explicit `start`/`end` for absolute author-time placement. When speech+timing is available, use `during={story.selection.<id>}` for a range or `at={story.moment.<id>}`+with the component's duration attribute (for example `for="2s"`). A Selection/Moment is semantic+and is resolved through `{timing.map}`; it is not a literal transcript query or a source-video+timestamp.++## Translation rule++Editorial concepts map to the nearest supported package surface. Do not invent a native component+for a format that Narratage does not ship: use supplied media plus peer Tracks, or record the gap.+Do not add a storyboard JSON layer or a conversion script between VLM analysis and `.svml`.diff --git a/.agent/skills/narratage/references/quickstart.md b/.agent/skills/narratage/references/quickstart.mdindex e697eacc..5e730685 100644--- a/.agent/skills/narratage/references/quickstart.md+++ b/.agent/skills/narratage/references/quickstart.md@@ -8,13 +8,13 @@ The repository docs are authoritative:| SVS Recipes | `docs/quickstart/styles.md` || Media and Seedance | `docs/quickstart/generation.md` || Speech Spine and SemanticMap | `docs/quickstart/timing.md` |-| Caption, Media, Typography Tracks | `docs/quickstart/tracks.md` |+| Caption, Media, Text, Audio Tracks | `docs/quickstart/tracks.md` and the `@narratage/audio-track` package README || Film and rendering | `docs/quickstart/composition.md` || Run Source and Runtime | `docs/quickstart/run.md` |Canonical path:-`Script → Estimate/Seedance → Speech Spine → WhisperX SemanticMap → peer Caption/Media/Text/Audio Tracks → Film → render:Video`.+`Script → estimate:Speech/text → Seedance or supplied media → Speech Spine → WhisperX SemanticMap → peer Caption/Media/Text/Audio Tracks → Film → render:Video`.Use explicit imports, exact fonts, Canvas/Frames, ProgramSpace, package locks, Targets, and Runtimeauthority. There is no implicit cache; reuse is explicit with `build-record` + `satisfy`.diff --git a/.agent/skills/narratage/references/reference-vlm.md b/.agent/skills/narratage/references/reference-vlm.mdindex 9f3ba1cf..149d447e 100644--- a/.agent/skills/narratage/references/reference-vlm.md+++ b/.agent/skills/narratage/references/reference-vlm.md@@ -11,8 +11,10 @@ overlay JSON or introduce a JSON-to-SVML conversion step.provided media; generated live-action PIP/B-roll may be real generated media.- Anchor recurring people/products/locations at the clearest shot and reuse references topologically.- Listen to audio for voice design. Transcribe speech, not burned-in captions.-- Map transcript to Script; generated media to Seedance; supplied assets to Media; timing to Speech- Spine/WhisperX; overlays to Caption/Media/Typography; then Film/Render and a final-video Run Target.+- Map transcript to Script; generated media to `seedance:TextVideo`/`FrameVideo`/`ReferenceVideo`;+ supplied assets to `media:Image`/`media:Audio` or `media-track:Item`; timing to `speech:Spine` and+ `whisperx:Alignment`; overlays to `caption:Program` + `caption-fine:Track`, `media-track:Track`,+ and `text:Track`; then `film:Film`/`render:Video` and a final-video Run Target.Generated image prompt structure: English realistic-iPhone reality contract, detailed subject/story,camera/reference relationship, then `Natural lighting, detailed realistic skin texture, and no visual artifacts.`