seedance-20

name	seedance-20
description	This skill should be used when creating, improving, or troubleshooting Seedance 2.0 video on any surface - Dreamina, Jimeng, CapCut, Doubao, Volcengine/Ark, BytePlus, Runway's Seedance route, fal, or third-party provider/router surfaces such as EvoLink, OpenRouter, Kie.ai, PiAPI, LaoZhang, Runware, ModelsLab, AI/ML API, MuAPI, SeeGen, and Segmind - including text/image/video/reference-to-video prompts, first/last frame, dialogue, lip-sync and audio, IP-safe rewrites, API, pricing and model-ID questions, and zh/ja/ko/es/ru prompt work. Not for non-Seedance models (Sora, Veo, Kling, Runway's own Gen models) or image-only prompting.
license	MIT
user-invocable	true
tags	["seedance"]
metadata	{"version":"6.7.0"}

seedance-20

Seedance 2.0 operating loop for agent-directed video work. Use this root skill to route, check facts, protect references, and keep prompts compact before loading specialized sub-skills.

Every active runtime route in this package is an ordinary relative Markdown link resolved from the Markdown file that contains it; clients without private skill/reference aliases can open the linked file directly. Static validation proves that each link stays inside the installed skill and reaches the exact-cased file (and heading, when a fragment is present). It does not prove that a host auto-loads or invokes the target: clients must follow the link or provide their own native routing.

Soul

This skill exists so that a person who arrives with a feeling leaves with a film. Three principles govern everything below:

1. Hear the intent behind the words. Users describe outcomes ("make it feel like home"), not parameters. Every gate and sub-skill translates feeling into craft; none of them may hand the translation work back to the user.
2. Keep the story alive. Hold a story state across the conversation: subject, mode, look, references, decided constraints, and what failed before. Every skill reads it before asking anything and updates it after acting. A user should never have to repeat a decision, and a new request inherits the world already built.
3. Evolve with the user. Speak plainly to a beginner and in director language to a professional - and notice when the same user grows from one into the other across a project. The register adapts; the standards never do.

Fast Lane

Most requests are one short clip from someone who just wants to see their idea. Do not run the full gate loop on them. Take the fast path when the request is a single standalone clip, from a non-expert, with no IP/likeness/brand/real-person or safety flag and no platform-fact question (API, pricing, model ID, limits, region):

1. Go straight to skills/seedance-interview-short/SKILL.md - or write the brief immediately if the idea is already clear - then skills/seedance-prompt-short/SKILL.md.
2. Load the Director's Read before writing the brief. Narrative, story, and performance ideas complete its ten-field read before prompt compilation; utility, product-only, and abstract ideas record its two-line non-narrative refusal instead. Then apply one visible beat, one motivated camera move, one motivated light source, sound intent, and the directing coherence rule. Load the directing engine, capability map, allocation model, and the source or professional gates only when the shot needs their deeper machinery.
3. Treat it as one clip: do not ask sequence or continuation questions yet. Raise "should this be a series, part two, or longer" only after the first draft, or when the user says continue, extend, next part, or longer.
4. Keep the single-clip prompt compact (about 40-110 words) unless the active surface is a verified stricter API, and keep director language (blocking, directorial voice, shot contracts) inside the internal brief - speak to the user in plain words.

Leave the fast lane the instant the request earns a gate: IP/likeness/brand/safety risk goes to the safety gate (step 9); a platform-fact question loads the source gate; a film, client, or delivery request loads the professional gate; a long story, connected clips, or continuation goes to the Sequence Gate. When in doubt about safety, leave the fast lane. The Operating Loop below is the full procedure - the fast lane is the default for the common case, and every gate it skips stays one signal away.

Director's Read Gate

Before any route drafts, compresses, or compiles a prompt, load the Director's Read and classify the brief. For every narrative, story, or performance brief, complete the canonical dramatic function through stock solution refused record; this includes silent clips, fast single clips, performer-led product work, sequences, and continuations. For non-narrative utility, packshot, functional product, abstract, VFX, or ambient work with no requested agency or performance, do not fabricate drama: record only the concrete utility intent and the explicit refusal of invented want, power, conflict, or subtext.

The read is an internal brief and handoff object, never final generation prose. Translate it into visible or audible carriers - blocking, eyeline, gesture, prop use, spatial change, camera endpoint, motivated light, dialogue contradiction, silence, or sound cue. Narrative prompts must visibly preserve the turn, one suppressed behavior, one non-transferable detail, and the replacement for the genre's easiest stock solution. No fast path, short path, compression path, or agent handoff may replace this record with remembered craft or generic judgment.

Operating Loop

1. Intake: identify the user's goal, production phase, target surface, mode, duration, aspect ratio, references, audio needs, deliverables, and safety/IP risks. If intake surfaces a clear safety, IP, likeness, or evasion risk, jump straight to the safety gate (step 9) before any planning.

   Establish what this client can actually inspect before describing any attachment. Hosts differ: some read images, fewer read video, fewer still read audio. Never state or imply that you viewed, watched, heard, measured, verified, or tested something you did not. When a reference or a returned take cannot be inspected, say so plainly, work from the user's description, mark those details as user-reported rather than observed, and ask for a short description only when the missing detail actually blocks routing. This matters most where the repository's own workflows assume observation: observed end state in continuation, take triage in references/retake-protocol.md, and any reference role inferred from an attachment. An invented observation corrupts sequence canon, and every later clip inherits it.

2. Source gate: before platform claims, load references/api-status.md and references/source-registry.md. For Runway, Volcengine, fal, provider/router, or China-facing surface specifics, also load references/platform-surface-matrix.md.

   This skill is for Seedance 2.0. A newer line exists and is out of scope; a user may be on it without saying so. Every duration, reference ceiling, resolution, and model ID here is a 2.0 value - never restate one for another line. Craft still applies (direction, shot contracts, reference roles, continuity, anti-slop); the numbers do not. When the line is unknown, write the prompt and withhold the number, exactly as for an unknown surface operation.

3. Professional gate: if the user asks for film, ad, campaign, client, delivery, localization, color, sound, subtitle, post, QC, or multi-shot work, load references/pro-filmmaking-standards.md before drafting.

4. Sequence Gate: classify the request as standalone_clip or sequence_project before the Mode Gate. Use sequence_project for long stories, connected clips, continuation/extend/next-part requests, dense action/dialogue scenes, campaigns, or any idea whose beats cannot clearly fit inside one verified active-surface generation. For sequence work, load , , , and ; for continuation, repair-tail, or re-anchor requests, also load .

Authority Order

The gates above will contradict each other. When they do, resolve in this order, highest first. A lower rule never silently overrides a higher one; when one is sacrificed, say which and why.

1. Safety, rights, consent, platform policy. Never traded away, never worked around.
2. Verified limits of the active surface operation. A request the surface rejects is not a prompt.
3. The user's explicit must-haves. Their stated non-negotiables outrank every default below.
4. Reference contracts — what each asset must supply, preserve, and never transfer.
5. Continuity — identity, space, time, prop ownership, audio state.
6. Physical causality and action legibility. A beat the viewer cannot read has not happened.
7. Camera and editorial logic.
8. Style, palette, atmosphere, decorative detail.
9. This skill's own defaults. The first thing to give up, not the last.

Which tier a constraint sits in is decided by what it controls, not by who asked for it. One requirement often touches several tiers at once: "@Video1 must supply this camera path" is a user must-have, a reference contract, and camera logic simultaneously. Classify it by the dimension it governs — camera, tier 7 — so that if the borrowed path hides the contact the shot exists to show, legibility at tier 6 still wins. Classifying by origin instead would collapse every user sentence into tier 3 and the order would decide nothing.

Being a user requirement does something different, and narrower: it forbids dropping the constraint quietly. When a user's request loses to a higher tier, say what you changed and why — "the borrowed camera path hid the moment of contact, so the crane is shallower; the timing is unchanged." The user can then lift it deliberately by naming the trade ("keep that path even if the action reads less clearly"), which moves it to tier 3 as a genuine non-negotiable. An unstated preference is not that.

Within one tier, prefer the constraint that is verified over the one that is inferred, and the one the user stated over the one this skill assumed. If they are still tied, ask rather than pick.

The common failures are inversions: style wording that quietly breaks an identity lock, a camera move that outranks the action it exists to reveal, or a repo default overriding something the user actually asked for.

Sequence Gate

For a sequence project, do not write Clip 01 until these are known: story objective, final story outcome, ordered major beats grouped into scenes, active surface or conservative surface assumption, clip budget, current clip narrative job and felt intent, and current clip completed endpoint.

Do not write a continuation prompt until the previous accepted clip or its actual final frame has been reviewed and its observed end state recorded.

Sequence invariants:

• every sequence prompt has project_id and clip_id lineage;
• accepted observed state overrides planned state;
• rejected footage is excluded from canon and cannot become a continuation source;
• future prompts remain provisional until the preceding accepted take is reviewed;
• exact reference tags survive every clip unchanged;
• seamless continuation stays inside a scene; a scene boundary opens from canonical references and resets extension_depth;
• completed beats cannot replay and reserved future beats cannot leak early;
• continuity state must be updated after each accepted take;
• final Seedance prompts remain natural language unless the user explicitly asks for structured output.

Load Map

Situation	Load
Any brief before prompt drafting or compilation; mandatory narrative read or non-narrative refusal	references/directors-read.md
Vague idea or missing brief	skills/seedance-interview/SKILL.md or skills/seedance-interview-short/SKILL.md
Long story, connected clips, campaign sequence, dense action/dialogue scene, or a prompt that needs several generations	skills/seedance-sequence/SKILL.md, references/sequence-project-state.md, references/prompt-compiler.md
Continue, extend, next part, repair tail, bridge known states, or re-anchor drift from accepted footage	skills/seedance-continuation/SKILL.md, references/continuation-handoff.md, references/continuity-qc.md
Fragile contact, continuing or cyclic motion, owner-specific endpoints, or motion handoff between clips	skills/seedance-motion/SKILL.md, references/model-mechanics.md, references/continuation-handoff.md, references/sequence-project-state.md
Review a generated take and update canon before the next prompt	references/retake-protocol.md, references/sequence-project-state.md, references/continuation-handoff.md

Preserve reference tags exactly, keep prompts short, and never convert field-observed community tricks into official platform guarantees. For professional filmmaker requests, deliver the workflow object the role needs: shot list, shot contract, continuity ledger, prompt, post handoff, localization plan, or QC checklist.