Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via
GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Building cutscenes or sequences
- Creating Timeline assets
- Adding tracks and clips
- 制作过场或序列、创建 Timeline 资产、添加轨道与片段
Timeline Skills
Create and modify Unity Timeline assets — add typed tracks, drop clips on tracks, bind objects, set duration / wrap mode, and play/pause/stop the editor preview through the PlayableDirector.
Operating Mode
- Approval：查询类 skill（
timeline_list_tracks，源码标SkillMode.SemiAuto）直接执行；其余变更/播放类（timeline_create/ add_*_track /timeline_add_clip/timeline_set_duration/timeline_play/timeline_set_binding，标SkillMode.FullAuto）需用户 grant，grant 后服务端一步执行返结果。 - Auto / Bypass：未被禁列表拦截的 skill 直接执行。
- 本模块含 Delete 类 skill：
timeline_remove_track标记为SkillOperation.Delete，被IsForbiddenInSemi静态拦截 —— 仅 Bypass 模式或加入 Allowlist 才能调用。 timeline_play仅驱动 Editor 预览（PlayableDirector.Evaluate / Play 在编辑器上下文），不会进入 Play mode。
DO NOT (common hallucinations):
timeline_create_animation/timeline_add_trackdo not exist → use the typed track skills:timeline_add_animation_track,timeline_add_audio_track,timeline_add_activation_track,timeline_add_control_track,timeline_add_signal_tracktimeline_add_keyframedoes not exist → Timeline uses clips, not direct keyframes; usetimeline_add_cliptimeline_set_durationsets the Timeline asset duration, not individual clip duration
Routing:
- For Animator parameters/states → use
animatormodule - For runtime animation playback → use
editor_playor write C# viascriptmodule
Skills
timeline_create
Create a new Timeline asset and Director instance.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | Yes | - | Name of the timeline/object |
| folder | string | No | "Assets/Timelines" | Folder to save asset |
Returns: { success, assetPath, gameObjectName, directorInstanceId }
timeline_add_audio_track
Add an Audio track to a Timeline.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | No | "Audio Track" | Name of the new track |
Returns: { success, trackName }
timeline_add_animation_track
Add an Animation track to a Timeline, optionally binding an object.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | No | "Animation Track" | Name of the new track |
| bindingObjectName | string | No | - | Name of the GameObject to bind (animator) |
Returns: { success, trackName, boundObject }
timeline_add_activation_track
Add an Activation track to control object visibility.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | No | "Activation Track" | Name of the new track |
Returns: { success, trackName }
timeline_add_control_track
Add a Control track for nested Timelines or prefab spawning.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | No | "Control Track" | Name of the new track |
Returns: { success, trackName }
timeline_add_signal_track
Add a Signal track for event markers.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | No | "Signal Track" | Name of the new track |
Returns: { success, trackName }
timeline_remove_track
Remove a track by name from a Timeline.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | Yes | - | Name of the track to remove |
Returns: { success, removed }
timeline_list_tracks
List all tracks in a Timeline.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
Returns: { count, tracks: [{ name, type, muted, clipCount }] }
timeline_add_clip
Add a clip to a track by track name.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | Yes | - | Name of the target track |
| start | double | No | 0 | Clip start time in seconds |
| duration | double | No | 1 | Clip duration in seconds |
Returns: { success, trackName, clipStart, clipDuration }
timeline_set_duration
Set Timeline duration and wrap mode.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| duration | double | No | 0 | Fixed duration in seconds |
| wrapMode | string | No | - | Wrap mode: Hold/Loop/None |
Returns: { success, duration, wrapMode }
timeline_play
Play, pause, or stop a Timeline (Editor preview).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| action | string | No | "play" | Action: play/pause/stop |
Returns: { success, action, time }
timeline_set_binding
Set the binding object for a track.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| name | string | No | - | GameObject name with PlayableDirector |
| instanceId | int | No | 0 | GameObject instance ID |
| path | string | No | - | GameObject hierarchy path |
| trackName | string | Yes | - | Name of the track |
| bindingObjectName | string | Yes | - | Name of the object to bind |
Returns: { success, trackName, boundTo }
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
