timeline-clip-move

Move a Timeline clip to an absolute start time or by a relative offset in Unity.

Updated May 20, 2026
One-click install
npx skills add https://github.com/Alltwice/Unity-3D-Project --skill timeline-clip-move-alltwice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: timeline-clip-move
Source: https://github.com/Alltwice/Unity-3D-Project/tree/main/.agents/skills/timeline-clip-move
Command: npx skills add https://github.com/Alltwice/Unity-3D-Project --skill timeline-clip-move-alltwice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Repositioning clips on a Unity Timeline track by hand is slow and error-prone, especially when precise timing adjustments are needed across many clips. This Skill moves a clip along its track to an exact start time or by a relative shift while preserving its duration. ## Core Features & Use Cases - Absolute Positioning: Set a clip's start time directly in seconds, clamped to zero or above. - Relative Shifting: Nudge a clip forward or backward by a delta in seconds when no absolute start is given. - Track Targeting: Select the track by name or zero-based index, with the clip identified by its index. - Use Case: While editing a cutscene TimelineAsset, shift the third animation clip on the "Character" track two seconds later to sync it with an audio cue, then verify the returned old and new start times. ## Quick Start Ask the AI to move clip index 2 on the "Character" track of Assets/Timelines/Intro.playable to start at 5 seconds using the timeline-clip-move tool.

Frequently Asked Questions about timeline-clip-move

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move a clip on a Unity Timeline track?▼

Call the timeline-clip-move tool with the assetPath to the .playable TimelineAsset and the clipIndex of the clip. Provide either an absolute start time in seconds or a relative deltaSeconds shift, and the clip's duration stays unchanged.

How to shift a Timeline clip by a relative time offset in Unity?▼

Pass deltaSeconds with a positive or negative value and leave start null. The tool adds the delta to the current start time, clamps the result to zero or above, saves the asset, and returns the old and new start times.

Does moving a Timeline clip change its duration?▼

No, the clip's duration is preserved when moving. Only the start time changes, and the response includes the unchanged duration along with the new end time for verification.

Can I target a Timeline track by name instead of index?▼

Yes, provide trackName to select the track by name, which takes precedence over trackIndex. If trackName is null or empty, the zero-based trackIndex is used, defaulting to the first root track.

What happens if the new clip start time is negative?▼

The computed start time is clamped to zero or above, so a clip can never begin before the timeline origin. The operation runs on the Unity main thread and reports success in the response.