seedance-2-5-video-director README

The project's README from github.com/liyue-aigc/seedance-2-5-video-director. As one markdown file: README.md.

Seedance 2.5 Video Director

面向 Dreamina/即梦 Seedance 2.5 的视频导演 Skill。它将文本创意、人物参考图、视频、音频、分镜或旧提示词整理成可执行的视频脚本、导演方案、诊断结果和复制即用的提示词。

非字节跳动、Dreamina 或即梦官方项目。本仓库不会调用付费生成接口,不会自动消耗积分。

功能

安装

推荐:一行安装

已安装 Node.js 的用户,在 Windows、macOS 或 Linux 终端执行:

npx skills add liyue-aigc/seedance-2-5-video-director -g -y

这条命令会从 GitHub 获取 Skill,并安装到当前用户的 Agent Skills 目录;-g 表示全局安装,-y 表示跳过交互确认。它使用 npm 附带的 npx 启动安装器,但本仓库本身不是需要加入项目依赖的 npm 软件包,因此不使用 npm install。

如果电脑上没有 Node.js,也可以直接在 Codex 中发送:

请使用 $skill-installer,从 GitHub 安装 liyue-aigc/seedance-2-5-video-director。

手动安装(备用)

Windows PowerShell

$skillRoot = Join-Path $env:USERPROFILE '.codex\skills'
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
git clone https://github.com/liyue-aigc/seedance-2-5-video-director.git (Join-Path $skillRoot 'seedance-2-5-video-director')

macOS / Linux

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/liyue-aigc/seedance-2-5-video-director.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/seedance-2-5-video-director"

安装完成后重新打开Codex会话,并在提示词中调用:

使用 $seedance-2-5-video-director,把我的视频创意整理成可复制的 Seedance 2.5 提示词。

安装器明确提示刚完成安装时,Skill会展示一次学习指导;普通新对话会直接处理任务,不会重复教程。需要时可主动发送“显示 $seedance-2-5-video-director 使用教程”。

更新

通过 npx skills 安装的用户:

npx skills update seedance-2-5-video-director -g -y

手动克隆的用户:

git -C "${CODEX_HOME:-$HOME/.codex}/skills/seedance-2-5-video-director" pull

Windows默认安装路径更新:

git -C (Join-Path $env:USERPROFILE '.codex\skills\seedance-2-5-video-director') pull

快速使用

使用 $seedance-2-5-video-director。

任务:生成20秒、16:9的水上竞技综艺片段。
素材:@Image 1 是挑战者完整人物参考,保持原服装;不要继承图片背景。
故事:登场 → 滚筒失衡但通过 → 摆锤窄桥 → 成功冲线。
声音:普通话解说、现场欢呼、机关声和紧张BGM,无字幕。
输出:完整导演方案和最终提示词。

只要提示词

使用 $seedance-2-5-video-director。只要最终提示词,不要解释。
生成15秒、9:16的街头追逐戏:一名成年女性被三人追赶,写实手持动作片风格,人物与空间方向稳定。

诊断现有提示词

使用 $seedance-2-5-video-director。只诊断,不重写。
检查下面提示词的时间、运镜、人物、物理和声音是否互相冲突:<粘贴提示词>

更多模式与结构见 SKILL.md、提示词蓝图 和 首次使用引导。

人物参考原则

普通的“人物参考图”默认代表完整可见人物,而不是只参考脸:

目录

seedance-2-5-video-director/
├── SKILL.md
├── README.md
├── LICENSE
├── NOTICE.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── capabilities-and-limits.md
│   ├── first-use-onboarding.md
│   ├── multimodal-patterns.md
│   ├── official-examples.md
│   ├── prompt-blueprints.md
│   └── realistic-direction-patterns.md
├── scripts/
│   └── validate_skill.py
├── tests/
│   └── cases.json
└── .github/workflows/
    └── validate.yml

测试

本地运行:

python scripts/validate_skill.py

验证器会检查:

GitHub Actions会在每次push和pull request时运行同一验证器。

tests/cases.json 是行为契约测试集。它不会调用视频生成服务,而是记录输入场景和预期输出约束,适合人工回归或交给独立代理做前向测试。

能力边界

开源与第三方说明

代码与原创Skill内容采用 MIT License。平台名称、商标和第三方文档归各自权利人所有。能力摘要和示例来源说明见 NOTICE.md。

seedance-2-5-video-director (liyue-aigc/seedance-2-5-video-director)

Searching Database…

What is this?This is a 'Seedance 2.5 Video Director' Skill for Codex, built for the Dreamina (即梦) Seedance 2.5 video platform. It turns text ideas, character reference images, videos, audio, storyboards, or old prompts into ready-to-use video scripts, director plans, diagnostics, and copy-paste prompts.
Is this a video generator itself?No, it's a prompt and script generation Skill, not a video generator — it never calls paid generation APIs or consumes Dreamina credits. It only produces planning text, prompts and diagnostics that you paste into Dreamina yourself.
How do I install this Skill?If you have Node.js, run the one-line npx installer shown in the README from a Windows, macOS or Linux terminal: it fetches the Skill from GitHub and installs it into your Agent Skills directory with -g for a global install. A manual PowerShell (Windows) or shell (macOS/Linux) install is also provided.
Do I need Node.js to install it?Node.js is needed for the recommended npx installer, but if you don't have it you can trigger installation directly by sending a message inside a Codex session instead.
Does it guarantee consistent video results?No — the underlying generation model is random, so the Skill's prompts can only reduce identity drift, physics errors and camera conflicts, not guarantee the exact same result every time. It also never submits generation jobs itself, so you still run the final prompt in Dreamina manually.
What character reference rules does it follow?By default a reference image represents the whole visible person: identity, facial features, skin tone, hairstyle, height, body shape, visible clothing and accessories are kept, while background, pose, composition and lighting from the reference are not inherited unless you ask for a face-only reference.
What video lengths and editing modes does it support?It covers 4-30s normal clips with a precise 30-second timeline, 30-180s Long Video, pre/post continuation of existing clips, Smart Edit with marked-region or uploaded-video editing, seamless transitions between two clips, and multi-panel storyboard animation.
How is the Skill's quality checked?A local validator, also run by GitHub Actions on every push and pull request, checks the Skill's front matter and required files, install-guidance triggers, the agents/openai.yaml invocation name, and the behavioral test cases in tests/cases.json.
Is this an official Dreamina or ByteDance product?No, the README explicitly states it is not an official ByteDance, Dreamina or 即梦 project; it's a third-party Skill that only produces planning text and prompts for use on those platforms.
Creator
liyue-aigc
Size
<0.1 MB
Stars
706
Age
2mo
Commits · 90 Days