Kursach_StealthAction/.agent/skills/timeline-clip-set-timing/SKILL.md

name	description	metadata
timeline-clip-set-timing	Set the timing of a clip on a Timeline track: start, duration, clip-in (trim), blend-in / blend-out durations, ease-in / ease-out durations, and time scale. Only the values you supply are changed.	generated-by mcp-plugin-dotnet

Timeline / Set Clip Timing

Adjust the timing of an existing clip identified by track + clip index. Any value left null is untouched, so this tool can tweak a single property or several at once.

Inputs

• assetPath — required path to the .playable TimelineAsset.
• trackName / trackIndex — which track holds the clip (name wins; index default 0).
• clipIndex — required zero-based index of the clip on its track.
• start — optional new start time (seconds).
• duration — optional new duration (seconds).
• clipIn — optional clip-in / trim offset into the source asset (seconds).
• blendInDuration / blendOutDuration — optional crossfade blend durations (seconds).
• easeInDuration / easeOutDuration — optional ease (fade) durations (seconds).
• timeScale — optional playback time scale of the clip.

Behavior

Resolves the clip, applies each supplied value, saves the asset, and returns the resulting timing. Runs on the Unity main thread.

How to Call

unity-mcp-cli run-tool timeline-clip-set-timing --input '{
  "assetPath": "string_value",
  "clipIndex": 0,
  "trackName": "string_value",
  "trackIndex": 0,
  "start": "string_value",
  "duration": "string_value",
  "clipIn": "string_value",
  "blendInDuration": "string_value",
  "blendOutDuration": "string_value",
  "easeInDuration": "string_value",
  "easeOutDuration": "string_value",
  "timeScale": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool timeline-clip-set-timing --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool timeline-clip-set-timing --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Name	Type	Required	Description
assetPath	string	Yes	Assets-rooted path to the TimelineAsset (.playable).
clipIndex	integer	Yes	Zero-based index of the clip on its track.
trackName	string	No	Name of the track holding the clip. Takes precedence over trackIndex.
trackIndex	integer	No	Zero-based root-track index, used when trackName is null/empty.
start	any	No	Optional new start time in seconds.
duration	any	No	Optional new duration in seconds.
clipIn	any	No	Optional clip-in (trim offset into the source asset) in seconds.
blendInDuration	any	No	Optional blend-in (crossfade) duration in seconds.
blendOutDuration	any	No	Optional blend-out (crossfade) duration in seconds.
easeInDuration	any	No	Optional ease-in (fade) duration in seconds.
easeOutDuration	any	No	Optional ease-out (fade) duration in seconds.
timeScale	any	No	Optional playback time scale of the clip.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "assetPath": {
      "type": "string"
    },
    "clipIndex": {
      "type": "integer"
    },
    "trackName": {
      "type": "string"
    },
    "trackIndex": {
      "type": "integer"
    },
    "start": {
      "$ref": "#/$defs/System.Double"
    },
    "duration": {
      "$ref": "#/$defs/System.Double"
    },
    "clipIn": {
      "$ref": "#/$defs/System.Double"
    },
    "blendInDuration": {
      "$ref": "#/$defs/System.Double"
    },
    "blendOutDuration": {
      "$ref": "#/$defs/System.Double"
    },
    "easeInDuration": {
      "$ref": "#/$defs/System.Double"
    },
    "easeOutDuration": {
      "$ref": "#/$defs/System.Double"
    },
    "timeScale": {
      "$ref": "#/$defs/System.Double"
    }
  },
  "$defs": {
    "System.Double": {
      "type": "number"
    }
  },
  "required": [
    "assetPath",
    "clipIndex"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/com.IvanMurzak.Unity.MCP.Editor.API.Tool_Timeline-ClipTimingResponse"
    }
  },
  "$defs": {
    "com.IvanMurzak.Unity.MCP.Editor.API.Tool_Timeline-ClipTimingResponse": {
      "type": "object",
      "properties": {
        "assetPath": {
          "type": "string",
          "description": "Project path of the TimelineAsset."
        },
        "trackName": {
          "type": "string",
          "description": "Name of the track holding the clip."
        },
        "clipIndex": {
          "type": "integer",
          "description": "Index of the clip on its track."
        },
        "displayName": {
          "type": "string",
          "description": "Display name of the clip."
        },
        "start": {
          "type": "number",
          "description": "Resulting start time in seconds."
        },
        "duration": {
          "type": "number",
          "description": "Resulting duration in seconds."
        },
        "end": {
          "type": "number",
          "description": "Resulting end time in seconds."
        },
        "clipIn": {
          "type": "number",
          "description": "Resulting clip-in (trim) in seconds."
        },
        "blendInDuration": {
          "type": "number",
          "description": "Resulting blend-in duration in seconds."
        },
        "blendOutDuration": {
          "type": "number",
          "description": "Resulting blend-out duration in seconds."
        },
        "timeScale": {
          "type": "number",
          "description": "Resulting time scale of the clip."
        },
        "success": {
          "type": "boolean",
          "description": "Whether the operation succeeded."
        }
      },
      "required": [
        "clipIndex",
        "start",
        "duration",
        "end",
        "clipIn",
        "blendInDuration",
        "blendOutDuration",
        "timeScale",
        "success"
      ]
    }
  },
  "required": [
    "result"
  ]
}