/seedance-troubleshoot

name: seedance-troubleshoot
description: "This skill should be used when a Seedance 2.0 output is blurry, jittery, off-prompt, morphing, blocked, visually generic, unstable, desynced, inconsistent, or otherwise fails and needs root-cause diagnosis."
license: MIT
user-invocable: true
tags:
  - diagnostics
  - troubleshooting
  - seedance-20
metadata:
  version: "6.7.0"
  updated: "2026-08-01"
  parent: "seedance-20"
  author: "Iamemily2050 (@iamemily2050)"
  repository: "https://github.com/Emily2040/seedance-2.0"
  openclaw:
    emoji: "🎬"
    homepage: "https://github.com/Emily2040/seedance-2.0"

seedance-troubleshoot

Before producing prompt text, a prompt-ready block, a rewrite, an example, or a compiled clip, load the [Director's Read](../../references/directors-read.md), classify the brief, and complete its canonical narrative or non-narrative record. Translate that record into visible or audible carriers and keep its internal labels out of final generation prose.

Use [retake-protocol](../../references/retake-protocol.md) to record the failed criterion, observed or user-reported evidence, useful parts of the take, one plausible repair, and the remaining authorized limits. Diagnose before rewriting; repeated failures do not prove the prompt is wrong. Consider mode mismatch, conflicting references, ambiguity, unsupported controls, model variation, or missing preservation constraints. A review or rewrite request does not authorize another generation. At zero/exhausted budget, submit nothing; preserve model/tier, duration, resolution, and reference roles unless an already authorized change covers them.

When the diagnostic tree has no row for the failure, load [model-mechanics](../../references/model-mechanics.md) and propose a testable hypothesis from the observed failure: conflicting priorities, ambiguous constraints, action timing, continuity state, reference roles, detail readability, or audio attribution. Do not present a diagnosis as proof of hidden model internals. Load [field-observed-tips](../../references/field-observed-tips.md), [reference-workflow](../../references/reference-workflow.md), and [api-workflow](../../references/api-workflow.md) when the failure involves continuation, edit/extend, source clips, audio references, or platform-specific errors. Load [shot-list-continuity](../../references/shot-list-continuity.md) for multi-shot drift and [delivery-qc](../../references/delivery-qc.md) for final-client or delivery failures. When sequence state is present, load [failure-atlas](../../references/failure-atlas.md), [continuation-handoff](../../references/continuation-handoff.md), and [continuity-qc](../../references/continuity-qc.md); diagnose against continuity locks, completed beats, exact reference tags, and reserved future beats.

Intent

A failed generation feels personal - the user showed the machine their idea and the machine returned something broken. The soul of this skill is rescue without blame: describe a plausible failure mechanism without blaming the user; preserve the idea as well as the prompt. They should leave with a fix and their confidence intact.

Diagnostic Tree

| Symptom | Likely cause | First repair | |---|---|---| | Product or face changes | I2V prompt re-described visible identity or overloaded motion. | Add preservation constraints; remove duplicate static detail. | | Camera jumps | Several incompatible moves or no endpoint. | Choose one move with start and finish. | | Generic output | Hollow style words and weak action. | Replace with physical action, source light, material, and sound. | | Motion ignored | Static prompt or no visible consequence. | Add actor, verb, timing, and changed end state. | | Lip-sync poor | Moving head/camera, long dialogue, unassigned speaker. | Lock framing, shorten line, assign speaker. | | VFX noisy | Effect has no source, physics, or dissipation. | Add source, material, path, interaction, and endpoint. | | Prompt blocked | Protected IP, real-person, graphic, or bypass-like wording. | Rewrite intent in safe production language without evasion. | | Extension quality degrades | No last-frame anchor or too many new variables across continuations. | Use returned last frame as first frame and change one variable. | | Audio reference ignored | Competing video sound, no visual beat mapping, or unsupported combo. | Mute competing video and map one visible event to the beat. | | Text/logos break | Small text asked to move or be redrawn. | Keep text static, centered, and protected; animate light around it. | | Client QC fails | Prompt output treated as final delivery without post/QC. | Route to delivery preflight, post fix, or regenerate only the failing shot. | | Continuation assumed planned ending | Previous clip was not reviewed or observed_end_state was ignored. | Replace opening with actual observed end state. | | Previous action restarted | Completed beat was not marked already_happened. | Add completed beat exclusion. | | Future beat leaked | Reserved beat entered the current prompt. | Remove future beat and stop earlier. | | Identity reference conflicts with continuity source | Source clip controlled transient state and identity at once. | Re-anchor identity from canonical reference. | | Screen direction reset | Axis relation was not locked or intentionally reset. | Preserve screen direction or declare new-shot axis reset. | | Open motion lost | Subject or camera vector was not inherited. | Carry motion vector into the opening sentence. | | Camera phase restarted | Parent camera endpoint was not recorded. | Start from observed camera phase. | | Prop state contradicted | Owner, position, or condition was missing. | Add prop state handoff. | | Audio phase restarted | Completed dialogue or music phase was not logged. | Continue or intentionally change the audio phase. |

Repair Process

First quote the failing phrase or missing element. Then state a plausible cause or testable hypothesis, with its unc