fix-my-sequence

I'd like you to add a skill to Wideframe called "fix-my-sequence".

Save the SKILL.md below exactly as written, then confirm I can run it by saying /fix-my-sequence.

---
name: fix-my-sequence
description: Diagnose and repair a sequence whose footage does not match its settings: mixed frame rates, slow-motion clips playing at the wrong speed, wrong resolution or aspect, rotated phone clips, mismatched audio sample rates. Use when someone says "my footage is the wrong frame rate", "the slow-mo isn't slow", "the timeline settings are wrong", "clips look stretched or letterboxed", "why does Premiere render a red bar", or when any other skill finds mixed rates in a project.
argument-hint: "[sequence-id, prproj + sequence name, or footage folder]"
---

# Fix My Sequence

Mismatched settings can make a sequence look or play differently than intended. This skill measures the footage, picks the settings the footage wants, decides clip by clip whether an off-rate clip is a slow-motion shot or a normal one, applies the fix, and proves it with check frames and a render.

## Scope

Sequence settings and per-clip interpretation. It does not change the edit: no clip is added, removed or reordered. Retiming for creative effect is out of scope; only correcting intended speed.

## Step 0: Resolve the input and set defaults

Accept a Wideframe sequence, a `.prproj` plus sequence name, or a footage folder (in which case the fix is applied when the sequence is built). If a `.prproj` has one sequence, use it; otherwise pick the most recently modified and say so.

Defaults unless told otherwise:

- Target frame rate and resolution: the majority of the footage by total duration, not by clip count.
- A clip at a higher rate than the target (59.94 or 120 against 23.976 or 29.97) is treated as slow-motion intent if its content analysis shows action or movement, or its filename or metadata flags it (`slomo`, `120fps`, HFR). Otherwise it is conformed at real time.
- Rotated phone clips use their display orientation.
- Audio conformed to 48 kHz.
- Work on a copy of any `.prproj`.

Ask nothing yet.

## Step 1: Measure

1. `caltools media-info-batch` on every clip in the sequence: fps, resolution, rotation, sample rate, duration. Use rotation-corrected dimensions.
2. `caltools sequence-inspect` (or `prproj inspect` for a Premiere sequence): the sequence's own settings and every clip's current interpretation and speed.
3. For off-rate clips only, `caltools media-analyze-content-batch` to read motion and content, then `job-poll`.

Evaluation: a table with one row per clip: native fps, resolution, rotation, current speed, and a proposed action.

## Step 2: Decide

Produce the fix list:

- Sequence: set to the target fps and resolution (`sequence-media-set`). If the existing setting already matches, say so.
- Each off-rate clip: `interpret_fps` to the target (slow-motion, plays smooth and slow) or conform at real time (normal clip). State the rule that decided it.
- Each clip whose aspect does not match: scale to fit with the frame preserved (no crop) unless the user asked for fill.
- Rotated clips: apply the display orientation.
- Audio: conform sample rate.

Show the fix list in a few lines. If any decision is a coin flip (a high-rate clip with no motion signal), ask the one question: "These N clips are 59.94; treat them as slow-motion or normal speed?" Otherwise do not ask.

Evaluation: every clip has exactly one action, and the number of open decisions is zero or was resolved by the one question.

## Step 3: Apply

1. `caltools sequence-media-set` for the sequence settings.
2. Per clip: `interpret_fps` via `prproj edit` or `sequence-clips-update` for interpretation, transform for scale and rotation.
3. Do not alter clip order, in and out points, or track placement.

Evaluation: re-run `sequence-inspect`; the count of clips whose rate or aspect does not match the target is zero, and clip order and count are unchanged.

## Step 4: Prove it

1. `sequence-render-frames` at four points, including the middle of each clip that was interpreted, and at least one rotated or rescaled clip: no stretch, no unexpected bars, correct orientation.
2. `caltools prproj validate` if a `.prproj` was involved.
3. `caltools sequence-render-final` to `<name>_conformed.mp4` at the target settings; confirm with `media-info-batch` that fps and resolution match and audio is 48 kHz.

## Step 5: Report

List: the target settings and why, every clip that changed with before and after (fps, speed, scale, rotation), any clip left unchanged on purpose, the render path, and the project path. Then point forward: `rough-cut-to-premiere` if this was a folder, `caption-this` or `social-clips` if the sequence is now ready to finish.

## Done when

- The sequence settings match the footage majority, and every off-rate clip has an explicit interpretation.
- Slow-motion clips play slow and smooth; normal clips play at real time; nothing is stretched or letterboxed by accident.
- The edit itself (order, count, in and out points) is unchanged.
- Check frames pass, the render matches the target settings, and any `.prproj` validates.