/animator-skill

name: animator-skill
description: Use when converting static image sequences (sequence boards) into motion prompts for AI video generation platforms (Runway, Pika, SVD), or describing temporal movement for video synthesis
version: 1.0.0
allowed-tools: Read, Write
user-invocable: false

Animator Skill

为 Animator 提供创建动态 motion prompts 的专业知识，优化用于 AI 视频生成工作流。

概述

此技能将静态 4 格序列转换为时间运动描述，支持：

• **主体运动** - 角色动作、表情、姿态
• **镜头运动** - Pan, Dolly, Crane, Orbit
• **自然运动** - 风、水、光影
• **平台优化** - Runway Gen-3, Pika Labs, SVD, AnimateDiff

核心原则

1. 简洁胜于复杂

**一个主要动作，而非多个同时动作**

❌ **过于复杂**:

角色跑forward, 跳过obstacle, 空中旋转, 拔剑, 落地战斗姿态

✅ **专注简洁**:

角色跑forward并跳过obstacle, 落地蹲姿。快速节奏。3秒。

2. 物理合理性

时长必须与动作匹配：

• **3 秒**: 转头、拿物体、走 2-3 步
• **5 秒**: 穿过房间、坐下/站起、开门走入
• **❌ 不现实**: "跑 100 米"在 3 秒、"完整战斗"在 5 秒

3. 运动优先，细节其次

简化静态描述，强调运动：

❌ **过度详细** (120+ 词):

A 25-year-old woman with waist-length silver hair, pale skin, violet eyes,
wearing black coat over white shirt and black pants, silver ring on right hand,
walks from left to right...

✅ **运动优先** (25 词):

A woman with silver hair in a black coat walks from left to right across platform.
Steady pace. 4 seconds.

4. 明确运动源

清楚指明什么在动：

• **主体运动**: "Character walks left to right. Camera static."
• **镜头运动**: "Flower static. Camera pans right slowly."
• **组合**: "Runner moves toward camera while camera dollies backward at matching speed."

Motion Prompt 结构模板

[简化主体描述] [主要动作] [方向].
[镜头运动(如有)]. [速度描述]. [时长].

**示例**:

A woman with silver hair in a crimson coat walks from left to right along
a train platform, wind blowing her hair. Camera pans right to follow her.
Steady walking pace. 5 seconds.

快速开始

步骤 1: 分析 Sequence Board

确定 4 格序列中的关键运动：

• Frame 1 → Frame 2: 发生了什么变化？
• 主体移动了吗？镜头移动了吗？
• 环境有自然运动吗（风、水、光）？

步骤 2: 选择一个主要动作

不要试图描述所有变化，选择**最重要的一个**。

步骤 3: 指定方向

使用明确的方向性词汇：

• left to right / right to left
• toward camera / away from camera
• background to foreground
• clockwise / counterclockwise

步骤 4: 选择速度

参考 [MOTION_LIBRARY.md](MOTION_LIBRARY.md) 速度指导：

• **慢速** (4-5 秒): slowly, gradually, gently
• **中速** (3-4 秒): walks, moves, steady pace
• **快速** (2-3 秒): quickly, swiftly, rushes

步骤 5: 确定时长

根据平台和运动复杂度：

• Runway Gen-3: 3-5 秒
• Pika Labs: 3-4 秒
• SVD: 2-4 秒
• AnimateDiff: 1-3 秒

输出约束

**严格禁止**:

• ❌ Frontmatter 元数据
• ❌ 模板说明
• ❌ 超过 80 词的冗长描述
• ❌ 多个竞争性动作
• ❌ 物理上不可能的运动

**必须包含**:

• ✅ 40-80 词的简洁描述
• ✅ 一个清晰的主要动作
• ✅ 运动方向
• ✅ 速度/节奏
• ✅ 时长
• ✅ 主体 vs 镜头运动的区分

详细资源

方法论指南 📖

• [motion-prompt-methodology.md](motion-prompt-methodology.md) - Motion prompt 原则
• 简洁性和专注性
• 方向性和速度指定
• 主体与镜头运动区分
• 视频时长的物理合理性
• 视频模型优化技术

运动类型库 📖

• [MOTION_LIBRARY.md](MOTION_LIBRARY.md) - 完整运动参考
• 主体运动库（人物移动、动作、表情）
• 镜头运动库（Pan、Dolly、Crane、Orbit）
• 自然运动（风、水、光影）
• 运动速度指导（慢/中/快）
• 平台特性和优化（Runway, Pika, SVD, AnimateDiff）
• 物理合理性检查
• 常见运动组合示例

模板

• [templates/motion-prompt-template.md](templates/motion-prompt-template.md) - 输出格式

何时使用

**自动触发场景**:

• 用户请求"生成 motion prompts"
• 批准的 sequence board 需要转换为视频
• Director 反馈运动清晰度问题

**手动参考场景**:

• 选择合适的运动类型
• 确定运动速度
• 优化平台特定格式
• 检查物理合理性

平台快速选择

• **复杂运动** → Runway Gen-3
• **快速生成** → Pika Labs
• **本地部署** → Stable Video Diffusion
• **风格化动画** → AnimateDiff

常见错误与解决

❌ 错误: 过于冗长

(120+ words with excessive scene description)

✅ **解决**: 简化场景，强调运动 (~25 words)

❌ 错误: 多个动作

角色跑、跳、旋转、拔剑、落地

✅ **解决**: 选择一个主要动作

❌ 错误: 方向模糊

角色在房间里移动

✅ **解决**: 明确方向 "from background to foreground"

---

**用法**: Animator agent 自动引用此技能。方法论和库（标记 📖）采用渐进式披露，仅在需要时查阅。