Cookbook

Deliver H.264 + AAC MP4

Probe first, then transcode for delivery.

Skills: `inspect` → `video-transformation` → `inspect`

Steps

Stay in the workspace. Replace each <skill_directory> with the absolute path of that skill (where its SKILL.md lives). Do not cd into the skill folder.

Step 1 — Inspect source

# 1. Inspect source
uv run <inspect_skill_directory>/scripts/describe.py --input /path/to/master.mov

# 2. Transcode (use output from inspect to confirm duration/codecs)
uv run <video-transformation_skill_directory>/scripts/transcode.py \
  --input /path/to/master.mov \
  --codec libx264 \
  --bitrate 5M \
  --output /path/to/deliverable.mp4

Step 2 — Re-probe the deliverable (require H.264 + AAC; duration ≈ source)

# 3. Re-probe the deliverable (require H.264 + AAC; duration ≈ source)
uv run <inspect_skill_directory>/scripts/describe.py --input /path/to/deliverable.mp4
uv run <inspect_skill_directory>/scripts/compare.py --input-a /path/to/master.mov --input-b /path/to/deliverable.mp4

Agent notes

Parse `inspect.describe` → `data.duration` before setting trim bounds.
Use `transcode.py` output `output_paths[0]` as the deliverable path.
For web, consider `--crf 23` instead of bitrate (see script `--help`).

Deliver H.264 + AAC MP4

Steps

Agent notes

Skills in this workflow