Kursach_StealthAction/.gemini/skills/timeline-modify/SKILL.md

name	description	metadata
timeline-modify	Generic write: apply a `SerializedMember` diff to a Timeline object (the `TimelineAsset`, a `TrackAsset`, or a clip's `PlayableAsset`) via ReflectorNet `TryModify`. Use 'timeline-get' first to inspect the structure. Remember: object *fields* must be supplied through the `fields` channel and *properties* through `props` — there is no cross-fallback.	generated-by mcp-plugin-dotnet

Timeline / Modify Object

Modify a Timeline object by applying a SerializedMember diff via ReflectorNet. This is the generic escape hatch for members not covered by the dedicated tools.

Inputs

• assetPath — required .playable TimelineAsset path.
• data — the SerializedMember diff to apply. Put C# fields in the fields array and properties in the props array; ReflectorNet resolves them on separate channels with no fallback.
• trackName / trackIndex — when set, target a track instead of the whole asset.
• clipIndex — when >= 0 (and a track is selected), target that clip's PlayableAsset.

Behavior

Resolves the target, applies the diff via Reflector.TryModify, and on success marks the asset dirty and saves. The applied logs are returned. Runs on the Unity main thread.

How to Call

unity-mcp-cli run-tool timeline-modify --input '{
  "assetPath": "string_value",
  "data": "string_value",
  "trackName": "string_value",
  "trackIndex": 0,
  "clipIndex": 0
}'

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

unity-mcp-cli run-tool timeline-modify --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool timeline-modify --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).
data	any	Yes	The SerializedMember diff to apply. Fields go in 'fields', properties in 'props'.
trackName	string	No	Optional track name to target a track instead of the asset.
trackIndex	integer	No	Root-track index used when trackName is null and a track target is wanted (-1 = asset only).
clipIndex	integer	No	Clip index to target that clip's PlayableAsset (-1 = the track/asset itself).

Input JSON Schema

{
  "type": "object",
  "properties": {
    "assetPath": {
      "type": "string"
    },
    "data": {
      "$ref": "#/$defs/com.IvanMurzak.ReflectorNet.Model.SerializedMember"
    },
    "trackName": {
      "type": "string"
    },
    "trackIndex": {
      "type": "integer"
    },
    "clipIndex": {
      "type": "integer"
    }
  },
  "$defs": {
    "com.IvanMurzak.ReflectorNet.Model.SerializedMemberList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/com.IvanMurzak.ReflectorNet.Model.SerializedMember"
      }
    },
    "com.IvanMurzak.ReflectorNet.Model.SerializedMember": {
      "type": "object",
      "properties": {
        "typeName": {
          "type": "string",
          "description": "Full type name. Eg: 'System.String', 'System.Int32', 'UnityEngine.Vector3', etc."
        },
        "name": {
          "type": "string",
          "description": "Object name."
        },
        "value": {
          "description": "Value of the object, serialized as a non stringified JSON element. Can be null if the value is not set. Can be default value if the value is an empty object or array json."
        },
        "fields": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/com.IvanMurzak.ReflectorNet.Model.SerializedMember",
            "description": "Nested field value."
          },
          "description": "Fields of the object, serialized as a list of 'SerializedMember'."
        },
        "props": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/com.IvanMurzak.ReflectorNet.Model.SerializedMember",
            "description": "Nested property value."
          },
          "description": "Properties of the object, serialized as a list of 'SerializedMember'."
        }
      },
      "required": [
        "typeName"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "assetPath",
    "data"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/com.IvanMurzak.Unity.MCP.Editor.API.Tool_Timeline-TimelineModifyResponse"
    }
  },
  "$defs": {
    "System.String-1": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "com.IvanMurzak.Unity.MCP.Editor.API.Tool_Timeline-TimelineModifyResponse": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "description": "Whether the modification was successful."
        },
        "assetPath": {
          "type": "string",
          "description": "Project path of the TimelineAsset."
        },
        "targetKind": {
          "type": "string",
          "description": "Kind of the modified target: TimelineAsset, TrackAsset, or ClipAsset."
        },
        "targetType": {
          "type": "string",
          "description": "Full type name of the modified target."
        },
        "logs": {
          "$ref": "#/$defs/System.String-1",
          "description": "Log of modifications and any warnings/errors."
        }
      },
      "required": [
        "success"
      ]
    }
  },
  "required": [
    "result"
  ]
}