Skip to content

alivirgo/Major-AI-Skills / plugins/mas-video-lab/skills/final-cut-pro

final-cut-pro

Verified

Author valid FCPXML for Final Cut Pro, manage Library render caches, and drive Apple Compressor CLI delivers without inventing credentials.

FileKindSize
SKILL.mdskill md9.4 KB
gemini.mdmarkdown2.6 KB
gpt.mdmarkdown3.3 KB
---
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
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 implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall