alivirgo/Major-AI-Skills / plugins/mas-video-lab/skills/adobe-premiere-pro
adobe-premiere-pro
VerifiedAutomate Premiere Pro sequences and markers via UXP/ExtendScript, exchange FCPXML/AAF/EDL, and queue Adobe Media Encoder jobs without baking secrets into projects.
Adobe Premiere Pro NLE Automation AI Skill Guide (Claude)
Overview & Engine Architecture
Premiere Pro is a track-based NLE: Project → Bins → Sequences → TrackItems, with Lumetri, captions, graphics, and audio mixers. Modern automation prefers UXP (require('premierepro')) — async DOM, project.lockedAccess + executeTransaction for mutations (enforced harder since 26.3). Legacy ExtendScript (JSX) remains common for studio scripts. Delivery usually goes through Adobe Media Encoder (AME) presets (.epr). Interchange: FCPXML, AAF, EDL, CME.
Pin the studio’s major version (e.g. 25.x / 26.x): marker APIs landed ~25.6; EncoderManager helpers and stricter action locks landed in 26.3.
┌─────────────────────────────────────────────────────────────┐
│ Premiere Pro build → deliver loop │
│ │
│ Editorial model │
│ ├── Project / Productions (shared media root) │
│ ├── Sequence (timebase, frame size, sample rate) │
│ └── TrackItem / Marker / Transition / Effect │
│ │
│ Automation │
│ ├── UXP: Project.getActiveProject → lockedAccess/Actions │
│ ├── ExtendScript: app.project.activeSequence (legacy) │
│ └── Interchange: FCPXML / AAF / EDL │
│ │
│ Delivery │
│ ├── EncoderManager / AME queue + .epr presets │
│ └── Match Source vs platform H.264/ProRes/DNx masters │
└─────────────────────────────────────────────────────────────┘
When to use / when not to
Use when
- Scaffolding sequences, chapter/comment markers, bin hygiene, or AME export handoff.
- Generating or validating FCPXML/AAF/EDL for finishing round-trips.
- Relinking media under Productions / shared storage with path conventions.
Do not use when
- Frame-accurate lossless trim without NLE →
@losslesscut/@ffmpeg. - Heavy motion design / expressions / mogrt authoring →
@adobe-after-effects. - macOS Magnetic Timeline / Compressor CLI primary path →
@final-cut-pro. - Someone asks to embed license keys, Creative Cloud passwords, or team project tokens in scripts → refuse; use OS keychain / studio secret store.
Operational Capabilities & Agent Directives
- Sequence-first: Confirm timebase, frame size, pixel aspect, and audio sample rate before inserts or markers.
- UXP transactions: Create
Actions insideproject.lockedAccess(() => { ... }), thenproject.executeTransaction(...). Do not invent sync ExtendScript patterns for UXP. - Markers: Prefer UXP
Markers.getMarkers(sequence)+createAddMarkerAction(types:Comment,Chapter,WebLink,FLVCuePoint). Guard null active sequence/project. - Export via presets: Queue AME with named
.epror Match Source; avoid one-off UI click recipes in automation docs. - Interchange honesty: EDL drops effects/graphics; FCPXML keeps more editorial metadata; AAF for Avid/Pro Tools adjacent finishing — state what will be lost.
- Media offline: Prefer Relink / Match File / Productions shared root over rewriting absolute paths blindly.
- Version gates: Document minimum Premiere version for any UXP API used (e.g. Markers ≥ 25.6).
Production Example: UXP chapter markers + AME handoff notes
UXP panel / script sketch (Premiere DOM via premierepro):
const ppro = require("premierepro");
async function addChapterMarkers(chapters) {
const project = await ppro.Project.getActiveProject();
if (!project) throw new Error("No active project");
const sequence = await project.getActiveSequence();
if (!sequence) throw new Error("No active sequence");
const markers = await ppro.Markers.getMarkers(sequence);
project.lockedAccess(() => {
project.executeTransaction((compound) => {
for (const c of chapters) {
const start = ppro.TickTime.createWithSeconds(c.t);
const duration = ppro.TickTime.createWithSeconds(0);
const action = markers.createAddMarkerAction(
c.name,
"Chapter",
start,
duration
);
compound.addAction(action);
}
}, "Add chapter markers");
});
}
// chapters = [{ t: 0, name: "Cold Open" }, { t: 12.5, name: "Act 1" }];
// await addChapterMarkers(chapters);
ExtendScript fallback (legacy studio installs) — always guard activeSequence:
(function () {
if (!app.project || !app.project.activeSequence) {
alert("Open a project and select an active sequence.");
return;
}
var seq = app.project.activeSequence;
var chapters = [
{ t: 0.0, name: "Cold Open" },
{ t: 12.5, name: "Act 1" },
{ t: 48.0, name: "Product Demo" }
];
for (var i = 0; i < chapters.length; i++) {
var m = seq.markers.createMarker(chapters[i].t);
m.name = chapters[i].name;
m.comments = "Auto chapter";
}
})();
Validation loop (human + agent checklist):
1. Confirm sequence settings (rate / size / sample rate)
2. Run marker script; scrub timeline index for Chapter markers
3. Queue AME with studio .epr (or Match Source ProRes/DNx)
4. Spot-check first/last frame + audio peaks; archive via Project Manager
Technical Troubleshooting Matrix
| Signature | Likely cause | Fix path |
|---|---|---|
activeSequence / getActiveSequence null | No sequence open | Open sequence in timeline; re-run |
UXP create*Action throws / ignored | Action created outside lockedAccess (26.3+) | Wrap action creation in project.lockedAccess |
| Markers on wrong frames | Seconds vs ticks / display format mismatch | Use TickTime APIs; verify sequence timebase |
| Media offline after drive move | Absolute paths broke | Relink / Match File; Productions shared root |
| AME rejects preset | Codec/container incompatible with source | Match Source or platform-safe H.264/ProRes .epr |
setSelection Promise hang | 26.3 made setSelection sync boolean | Drop await; use returned boolean |
| FCPXML round-trip loses Lumetri look | Interchange fidelity limits | Finish grade in Premiere or move stills/LUTs separately |
| Scrubbing stutters | Bloated media cache | Preferences → Media Cache; purge peak files |
Best Practices
- Prefer Productions for multi-editor media roots; document the shared volume UNC/POSIX path.
- Name sequences and bins with show codes (
SHOW_EP01_PictureLock_v03); never rely on “Sequence 01”. - Keep AME presets under version control as
.eprbinaries or documented preset names — not screenshots alone. - Separate picture lock from color/audio finish exports; tag markers for chapter delivery platforms.
- Clear or relocate Media Cache on shared machines; do not commit cache folders.
- For CEP→UXP migrations, rewrite sync ExtendScript assumptions; UXP methods are async.
Limitations
- UXP coverage is not a 1:1 clone of every ExtendScript API; verify against Premiere UXP reference.
- Team Projects / cloud collaboration auth is out of band — never hardcode credentials.
- Dynamic Link to After Effects can desync; purge caches when frames look stale.
- Stop and ask if sequence preset, delivery codec, or shared media root is unspecified.
Related Skills
@adobe-after-effects— comps, expressions, mogrt, render queue / AME from AE@final-cut-pro— FCPXML / Compressor when finishing on Apple@davinci-resolve— color finish / Studio scripting handoff@ffmpeg— transcode / proxy / CFR fixes outside the NLE@losslesscut— keyframe-aligned lossless trims before ingest
Agent Operational Directive
MANDATORY: Guard active project/sequence before mutations. For UXP, create Actions inside
lockedAccessand use transactions. Prefer preset-driven AME exports; document frame rate/timebase; never embed Creative Cloud or Team Project secrets in scripts or project sidecars.
Source anchors (research)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |