alivirgo/Major-AI-Skills / plugins/mas-video-lab/skills/adobe-after-effects
adobe-after-effects
VerifiedScaffold After Effects comps and expression rigs, queue Render Queue / AME jobs, and export Essential Graphics (.mogrt) with ExtendScript-safe patterns.
Adobe After Effects Motion Graphics AI Skill Guide (Claude)
Overview & Engine Architecture
After Effects is layer-based: Project → CompItem → Layers → Properties / Keyframes / Expressions. Automation is primarily ExtendScript (JSX, ES3 dialect) against app.project, CompItem, AVLayer, and renderQueue. Delivery: Render Queue (blocking render()), Queue in AME (queueInAME), or Essential Graphics → .mogrt. Dynamic Link ties comps into Premiere.
Keep scripts ES3-compatible (var, no arrow functions/template literals in JSX shipped to AE).
┌─────────────────────────────────────────────────────────────┐
│ After Effects build → deliver │
│ │
│ Project graph │
│ ├── FootageItem / FolderItem / CompItem │
│ ├── Layer types (AV, Shape, Text, Camera, Light, Null) │
│ └── Keyframes / Expressions / Effects │
│ │
│ Automation │
│ ├── ExtendScript DOM + beginUndoGroup │
│ ├── Expressions (thisComp / thisLayer / time) │
│ └── Essential Graphics property exposure │
│ │
│ Delivery │
│ ├── Render Queue + OutputModule templates │
│ ├── queueInAME(false|true) │
│ └── exportAsMotionGraphicsTemplate → .mogrt │
└─────────────────────────────────────────────────────────────┘
When to use / when not to
Use when
- Creating comps, text/shape layers, null/parent rigs, expressions, or batch render queue items.
- Packaging lower-thirds / bugs as
.mogrtfor Premiere editors. - Diagnosing expression errors, missing fonts, or output module template mismatches.
Do not use when
- Long-form cutting / multicam →
@adobe-premiere-pro/@final-cut-pro/@davinci-resolve. - Lossless stream trim →
@losslesscut/@ffmpeg. - Requests to bake licensed font files or Adobe credentials into repos → refuse.
Operational Capabilities & Agent Directives
- Comp spec first: width, height, pixelAspect, duration, frameRate before layers.
- Undo groups: wrap mutations in
app.beginUndoGroup/app.endUndoGroup. - Render Queue:
items.add(comp)→ configureoutputModule(1)with file extension → statusQUEUEDbeforerender()(blocks) orqueueInAME(false)to hand off. - Templates are local:
applyTemplate("...")names differ per machine — catch failures and fall back. - mogrt exposure: only Checkbox, Color, single-value Slider, Source Text via
canAddToMotionGraphicsTemplate/addToMotionGraphicsTemplate. - Expressions vs keyframes: expressions for linked/procedural motion; keyframes for intentional curves.
- Fonts: use studio-licensed faces; document substitution risk.
Production Example: lower-third + Render Queue + mogrt notes
// ExtendScript (ES3) — create lower-third, queue render
(function () {
app.beginUndoGroup("Create Lower Third");
var comp = app.project.items.addComp("LT_Hero", 1920, 1080, 1.0, 5.0, 30);
var solid = comp.layers.addSolid([0.05, 0.55, 0.9], "Bar", 640, 96, 1.0);
solid.property("Position").setValue([420, 860]);
solid.property("Position").expression =
"var t = time; [ease(t, 0, 0.6, -200, 420), 860]";
var textLayer = comp.layers.addText("Product Launch");
var textProp = textLayer.property("Source Text");
var textDoc = textProp.value;
textDoc.fontSize = 48;
textDoc.fillColor = [1, 1, 1];
textDoc.font = "Arial-BoldMT";
textProp.setValue(textDoc);
textLayer.property("Position").setValue([420, 860]);
// Optional: expose Source Text to Essential Graphics
try {
if (textProp.canAddToMotionGraphicsTemplate(comp)) {
textProp.addToMotionGraphicsTemplate(comp);
}
comp.motionGraphicsTemplateName = "LT_Hero";
} catch (e) {}
var rq = app.project.renderQueue.items.add(comp);
var om = rq.outputModule(1);
try {
om.applyTemplate("H.264 - Match Render Settings - 15 Mbps");
} catch (e) {
// Template missing — leave default; user picks local preset
}
om.file = new File("~/Desktop/LT_Hero_Out.mp4"); // extension required
app.endUndoGroup();
alert("Queued: " + comp.name + " status=" + rq.status);
// Prefer queueInAME(false) for shared encode farms:
// if (app.project.renderQueue.canQueueInAME) app.project.renderQueue.queueInAME(false);
})();
Validation:
1. Comp settings match delivery (rate/size)
2. RQ item status QUEUED; output path has extension
3. Spot expression editor (no yellow banner)
4. For mogrt: Essential Graphics shows exposed props; exportAsMotionGraphicsTemplate
Technical Troubleshooting Matrix
| Signature | Likely cause | Fix path |
|---|---|---|
| Yellow expression banner | Syntax / bad property path | Fix ES expression; use thisComp.layer("Name") carefully |
RQItemStatus.NEEDS_OUTPUT | Missing output path/extension | Set om.file with .mp4/.mov |
applyTemplate throws | Template not on machine | try/catch; document studio template pack |
| Font substitution | Face not installed | Install licensed font; avoid random web fonts |
| Dynamic Link stale | Premiere/AE cache desync | Refresh Link; purge memory & disk cache |
render() “hangs” | Blocking until done | Expected; use AME queue for async farm |
| mogrt export false | Unsaved project / bad props | Save project; only expose supported property types |
Best Practices
- Controller nulls + parenting over hard-coded layer indices.
- One output module per deliverable (ProRes master + H.264 proxy) via
outputModules.add(). - Keep disk cache on fast local SSD; never on the media SAN root without studio policy.
- Version comps (
LT_Hero_v03); avoid overwriting locked deliveries. - Document AE major version for any API used (
queueInAMEneeds AE 14+ / AME 11+).
Limitations
- ExtendScript is ES3 — modern JS tooling must transpile or stay compatible.
- Output module / render settings template names are environment-specific.
- Scripting cannot replace every UI-only effect or third-party plugin license check.
- Stop and ask if delivery codec, safe-title margins, or brand fonts are unspecified.
Related Skills
@adobe-premiere-pro— editorial host for mogrt / Dynamic Link@ffmpeg— post-transcode / loudness / package@davinci-resolve— color finish after AE pre-comp renders@remotion— code-first motion when AE is not the runtime
Agent Operational Directive
MANDATORY: Use undo groups; set comp specs explicitly; always set output module file paths with extensions; treat template names as local; fail gracefully; never embed Adobe credentials or unlicensed fonts in automation.
Source anchors (research)
- After Effects Scripting Guide — Render Queue
- OutputModule
- Scripts & Motion Graphics templates (Adobe Help)
queueInAME— AE 14.0+ / AME 11.0+
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |