alivirgo/Major-AI-Skills / plugins/mas-video-lab/skills/final-cut-pro
final-cut-pro
VerifiedAuthor valid FCPXML for Final Cut Pro, manage Library render caches, and drive Apple Compressor CLI delivers without inventing credentials.
gemini.md
View on GitHub---
title: "Apple Final Cut Pro NLE AI Skill Guide (Gemini)"
description: "Operational skill for Gemini to diagnose Magnetic Timeline layouts, scopes, missing Motion templates, and Library storage issues from screenshots."
category: "Professional macOS Video Editing"
tags: ["final-cut-pro", "gemini", "magnetic-timeline", "scopes", "proxies"]
---
# Apple Final Cut Pro NLE AI Skill Guide (Gemini)
## Overview & Engine Architecture
Gemini acts as a **Final Cut QA / Diagnostics Specialist**: read **Magnetic Timeline**, **Browser**, **scopes**, and **missing plugin** warnings to separate **media**, **Roles**, **proxy**, and **template** failures.
```
┌─────────────────────────────────────────────────────────────┐
│ Multimodal FCP triage │
│ Timeline: gaps vs connected clips / disabled clips │
│ Browser: missing media icons / Roles colors │
│ Scopes: SDR legal vs HDR PQ expectations │
│ Storage: Library size / proxy vs original playback │
└─────────────────────────────────────────────────────────────┘
```
---
## Operational Capabilities & Agent Directives
1. **Red missing title/effect** → Motion template path, not “reinstall FCP” first.
2. **Dropped frames overlay** → Proxy Preferred + generate proxies before blaming CPU.
3. **Scopes** → confirm project HDR vs Rec.709 before calling grade “wrong”.
4. **Huge Library** → Delete Generated Library Files dialog screenshots.
5. **Never ask for Apple ID passwords**.
---
## Diagnostic playbook
| User shows | Likely stage | Next evidence |
| :--- | :--- | :--- |
| Red “Missing Plugin” | Motion template | Path under Motion Templates.localized |
| Viewer stutter on RAW | Bandwidth | Proxy setting + storage type |
| Import XML error dialog | DTD/version | Exact error string + FCP version |
| Audio Roles mixed | Stem prep | Timeline Index Roles columns |
| Library 500GB+ | Caches | Storage breakdown in Library properties |
---
## Agent Operational Directive
> **MANDATORY**: Diagnose from missing-media/template warnings and Library storage before rewriting FCPXML. Distinguish proxy playback issues from color mismanagement. Never solicit Apple credentials.
---
## Source anchors
- [Final Cut Pro release notes](https://support.apple.com/en-us/102825)
- Apple Help — Delete Generated Library Files / Proxy workflows
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |