🎬 导演Skill · Director Skills

导演Skill：让 Agent 像导演一样，把创意、剧本、分镜、生成与成片组织成可执行的 AI 视频工作流。

导演Skill（Director Skills） 是一套面向 AI 视频创作的开源 Agent Skills。每个 Skill 都是一位专项“AI 导演”，用结构化流程帮助 Agent 完成从需求理解到可交付结果的创作任务。

适用于 Claude Code、Codex，以及其他支持 Agent Skills 开放标准的 Agent。

当前状态：导演Skill 已收录 4 个专项 Skill，覆盖文旅视频、影视资产提示词、动作打戏提示词与 Miora 视频生成可靠性工作流。

📋 Skills

名字	一句话	状态
🏝️ travel-skill	规划、编写、审阅和修复真实素材与 AI 镜头混合制作的文旅宣传片	可用
🎨 cinematic-asset-prompts	从剧本提取角色、场景、道具与载具，并输出中英双语视觉资产提示词	可用
⚔️ action-fight-prompt	设计带时序、动作因果、环境反馈和资产锁定的电影级动作打戏提示词	可用
🎞️ miora-video-studio	为 WorkBuddy / Miora 视频生成补充参数闸门、任务轮询、落盘核验与失败恢复	可用（需 Miora 环境）

🔎 Skills 说明

`cinematic-asset-prompts`

适合在正式分镜或视频生成前，把剧本中的角色、场景、道具、载具拆成可复用的视觉资产。它会先统一影调与色彩科学，再输出中英双语提示词，并严格区分角色定妆、场景空镜和道具/载具设定图。

`action-fight-prompt`

面向近身格斗、怪兽对决、载具追逐、群战和机甲大场面。它用 2–3 秒时序拆段、动作因果链、环境反馈和参考图映射来减少瞬移、穿模与无效动作。该 Skill 只负责提示词设计，不直接提交视频生成任务。

`miora-video-studio`

面向已配置 WorkBuddy / Miora 工具的环境，重点解决“参数是否齐全、任务是否真的完成、成片属于哪个并发作业、规格是否与请求一致”等可靠性问题。仓库内附 scripts/miora_watch.py，用于登记、等待、轮询、认领和读取 MP4 文件头；它不包含凭据，也不能替代 Miora 视频生成通道。

🎬 一个导演Skill 应该做什么

理解创作目标、受众、平台、时长与制作约束
完成创意定位、叙事结构、视觉风格和镜头设计
输出可直接生成的分段提示词、首尾帧衔接和一致性锚点
检查事实、版权、文化表达、模型能力与交付边界
通过可重复的验收标准评估画面、连续性和成片完整度

🗂️ 仓库结构

director-skills/
├── README.md
├── CONTRIBUTING.md
├── LICENSE
├── action-fight-prompt/
├── cinematic-asset-prompts/
├── miora-video-studio/
├── templates/
│   └── SKILL.template.md
└── <skill-name>/
    ├── SKILL.md
    ├── scripts/       # 可选：可执行脚本
    ├── references/    # 可选：方法、规范与评估标准
    └── templates/     # 可选：可复用交付模板

📦 安装方式

当某个 Skill 状态标记为“可用”后，在 Claude Code、Codex 等工具中可以直接说：

帮我安装这个 skill：https://github.com/kangarooking/director-skills/tree/main/<skill-name>

也可以手动安装：

git clone https://github.com/kangarooking/director-skills.git

# Codex
mkdir -p ~/.codex/skills
cp -R director-skills/<skill-name> ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R director-skills/<skill-name> ~/.claude/skills/

✅ 发布标准

一个 Skill 只有在满足以下条件后，才会在目录中标记为“可用”：

包含合法 frontmatter 和完整的 SKILL.md。
写清触发场景、输入、输出、步骤和边界。
需要工具或脚本时，提供安装与错误处理说明。
至少跑通一个真实案例，并保留可复查的验收结果。
不伪造生成结果，不隐藏模型、平台、版权或资料限制。

🤝 贡献

欢迎提交新的导演 Skill、案例、评估方法和实用工具。开始前请阅读 CONTRIBUTING.md。

📜 开源许可

本项目以 MIT License 开源。使用第三方模型、素材、字体或工具时，仍需遵守对应条款。