---
name: compressor-workflow
description: Guide safe Apple Compressor projects, presets, destinations, batches, watch-folder decisions, Final Cut Pro or Motion handoffs, job monitoring, and delivery-artifact verification. Use when a user needs to transcode or package media in Compressor without losing source media or overwriting the wrong output.
---

# Compressor Workflow

Use this skill for Compressor app operation, not low-level codec code or an assumed Compressor command-line interface.

## Source Check

Open Compressor Help or search the local Tips/Help Viewer catalog for `Compressor`. Confirm that the guide matches the installed app/version before relying on a menu path, preset behavior, or automation feature. Read `references/job-and-delivery-contract.md` for the shared preflight and verification contract.

## Workflow

1. Classify the task: one-off export, batch, preset customization, destination setup, watch-folder decision, Final Cut Pro/Motion handoff, failed job, or artifact verification.
2. Establish the artifact contract: source location, whether it must stay untouched, codec/container, dimensions, frame rate, audio layout/sample rate, captions/HDR/metadata requirements, destination, overwrite rule, and delivery target.
3. Inspect the active Compressor project before changing it: selected jobs, applied settings, destinations, job actions, output names, and any warning or missing-media state.
4. Preserve source state. Prefer a new project or duplicate when altering an existing reusable preset/job. Do not relink, remove jobs, replace source media, or overwrite a prior delivery without a visible user confirmation.
5. Choose the smallest correct setting/preset and destination. Explain any tradeoff between delivery requirements, quality, file size, compatibility, and time. Do not invent a platform specification the user has not supplied.
6. Before submitting, state the exact input, output name, destination, overwrite behavior, setting, and any batch/watch-folder effect. Get confirmation before starting a render, transcode, or operation that can overwrite an artifact.
7. Monitor the job and stop on an unexpected alert, missing-media/extension condition, failed status, or output-location mismatch. Report the concrete job, setting, destination, and error context.
8. Verify the completed artifact against the contract: existence, destination, file name, duration, dimensions, codec/container, audio, and any required captions/HDR/metadata. Record limits that require target-platform testing.

## Guards

- Do not treat the `Compressor Creator Studio` executable as a supported CLI. Use a separately verified command-line media workflow when reproducible CLI encoding is the requirement.
- Do not mistake a completed job for an acceptable delivery; inspect the artifact.
- Do not apply a preset merely because its label sounds right. Check its actual settings and target requirements.
- Do not turn on watch folders or job actions without explaining their persistent or automatic behavior and receiving confirmation.
- Hand framework code, custom readers/writers, or per-frame codec work to `apple-dev-skills` media workflows.

## Handoffs

- `logic-pro-workflow` for music/stem preparation before final delivery.
- `final-cut-pro-workflow` for editing, sharing, and source-master preparation; `motion-workflow` for composition and template authoring. Compressor owns the transcode/delivery step.
- `apple-dev-skills:video-codec-processing-workflow` or `avfoundation-media-pipeline-workflow` for code-level media processing.
- A verified `ffmpeg` workflow when a CLI artifact contract is explicitly required.