# Send Seedance Video Generation Extension to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "seedance-story-orchestrator",
    "name": "Seedance Video Generation Extension",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/KKenny0/seedance-story-orchestrator",
    "canonicalUrl": "https://clawhub.ai/KKenny0/seedance-story-orchestrator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/seedance-story-orchestrator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=seedance-story-orchestrator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/build_subagent_task.py",
      "scripts/concat_videos.py",
      "scripts/orchestrate_story.py",
      "scripts/prepare_storyboard.py",
      "scripts/run_story.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/seedance-story-orchestrator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/seedance-story-orchestrator",
    "downloadUrl": "https://openagent3.xyz/downloads/seedance-story-orchestrator",
    "agentUrl": "https://openagent3.xyz/skills/seedance-story-orchestrator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/seedance-story-orchestrator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/seedance-story-orchestrator/agent.md"
  }
}
```
## Documentation

### Seedance Story Orchestrator (v0.2.0-phase1)

阶段性方案（Phase 1）：

上层编排：seedance-story-orchestrator
下层执行：seedance-video-generation/seedance.py

以“可审计、可恢复、可控推进”为第一目标。

### Workflow（严格关卡）

固定阶段顺序：

outline -> episode_plan -> storyboard -> storyboard_images -> render

规则：

每阶段执行后写入 checkpoint-{stage}.json，默认 confirmed=false
未确认时，run 会立即停止并返回：

pending_confirmation_stage
next_action


必须 confirm --stage <stage> 后再继续下一阶段

### Prerequisites

Python 3.8+
seedance-video-generation skill（必须可访问 seedance.py）
ARK_API_KEY
FFmpeg（用于拼接最终视频）

### Quick Start（推荐）

# 1) 运行到 render（会在每个关卡停下）
python3 {baseDir}/scripts/run_story.py run \\
  --project-dir {baseDir}/outputs/my-project \\
  --input-file /path/to/story.txt \\
  --stage render

# 2) 按提示确认阶段（示例）
python3 {baseDir}/scripts/run_story.py confirm \\
  --project-dir {baseDir}/outputs/my-project \\
  --stage outline

# 3) 查看整体状态
python3 {baseDir}/scripts/run_story.py status \\
  --project-dir {baseDir}/outputs/my-project

### End-to-End（从剧本到成片）

# 首次运行（会停在 outline）
python3 {baseDir}/scripts/run_story.py run \\
  --project-dir ./my-project \\
  --input-file ./story.txt \\
  --stage render

# 逐关确认并继续
python3 {baseDir}/scripts/run_story.py confirm --project-dir ./my-project --stage outline
python3 {baseDir}/scripts/run_story.py run --project-dir ./my-project --stage render

python3 {baseDir}/scripts/run_story.py confirm --project-dir ./my-project --stage episode_plan
python3 {baseDir}/scripts/run_story.py run --project-dir ./my-project --stage render

python3 {baseDir}/scripts/run_story.py confirm --project-dir ./my-project --stage storyboard
python3 {baseDir}/scripts/run_story.py run --project-dir ./my-project --stage render

python3 {baseDir}/scripts/run_story.py confirm --project-dir ./my-project --stage storyboard_images
python3 {baseDir}/scripts/run_story.py run --project-dir ./my-project --stage render

python3 {baseDir}/scripts/run_story.py confirm --project-dir ./my-project --stage render

最终视频路径：
./my-project/videos/run-YYYYMMDD-HHMMSS/final-video.mp4

### 1) 非结构化输入（默认推荐：sub-agent-first）

# 先生成 sub-agent 任务
python3 {baseDir}/scripts/build_subagent_task.py \\
  --input-file /path/to/raw.txt \\
  --output {baseDir}/outputs/subagent-task.txt

# 用 sessions_spawn 执行后，拿到结构化 JSON，再喂给 prepare
python3 {baseDir}/scripts/prepare_storyboard.py \\
  --input-file /path/to/subagent-output.json \\
  --output-dir {baseDir}/outputs

### 2) 直接文本/JSON输入

python3 {baseDir}/scripts/prepare_storyboard.py \\
  --input-file /path/to/story.txt \\
  --output-dir {baseDir}/outputs

### 3) staged artifacts 输入

python3 {baseDir}/scripts/prepare_storyboard.py \\
  --staged-artifacts /path/to/staged-artifacts.v1.json \\
  --output-dir {baseDir}/outputs

### Prepare

python3 {baseDir}/scripts/prepare_storyboard.py \\
  --input-file /path/to/story.txt \\
  --output-dir {baseDir}/outputs

### Storyboard Images（Seedream）

python3 {baseDir}/scripts/seedream_image.py storyboard \\
  --storyboard /path/to/storyboard.draft.v1.json \\
  --output-dir {baseDir}/outputs/images

### Render Videos（Seedance）

python3 {baseDir}/scripts/orchestrate_story.py run \\
  --storyboard /path/to/storyboard.draft.v1.json \\
  --output-dir {baseDir}/outputs/videos

### Concat Final Video

python3 {baseDir}/scripts/concat_videos.py \\
  --run-dir {baseDir}/outputs/videos/run-YYYYMMDD-HHMMSS

### Artifacts

主要产物：

plan-*/storyboard.draft.v1.json
plan-*/assets.v1.json
plan-*/staged-artifacts.v1.json
checkpoint-{stage}.json
videos/run-*/result-index.json
videos/run-*/run-summary.json
videos/run-*/final-video.mp4

### Schemas & References

references/storyboard-v1.schema.json
references/assets-v1.schema.json
references/staged-artifacts-v1.schema.json
references/subagent-parser-contract.md
docs/design-doc-v0.2.0-phase1.md
docs/logic-flow-v0.2.0-phase1.md

### Notes (Phase 1)

当前是阶段性方案：优先可控、可恢复、可审计
自动“回传最终视频到会话”不在本阶段强制实现（可在 Phase 2 增加）
run_story.py 已内置混合日志 JSON 解析与严格关卡机制
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: KKenny0
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/seedance-story-orchestrator)
- [Send to Agent page](https://openagent3.xyz/skills/seedance-story-orchestrator/agent)
- [JSON manifest](https://openagent3.xyz/skills/seedance-story-orchestrator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/seedance-story-orchestrator/agent.md)
- [Download page](https://openagent3.xyz/downloads/seedance-story-orchestrator)