# vfx-compositing

The vfx-compositing skill for Claude Code provides provider-independent direction for visual effects compositing in generated video, ads, and trailers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 235 installs · ★ 252 repo stars
- Author: calesthio
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/production/post-production/vfx-compositing/SKILL.md
- Updated: 2026-07-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/vfx-compositing

## What it does

The skill guides planning, briefing, integration, repair, and quality checks for visual effects composites involving plates, alpha mattes, keying, rotoscoping, tracking, and color matching. It structures work around camera, audience, image, and production contracts to keep generated elements grounded in the plate.

It covers strategies from simple 2D overlays and 2.5D projections to full 3D matchmoves and deep image compositing. The instructions detail alpha channel handling, matte separation, garbage mattes, and pre-generation plate inventories.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill vfx-compositing -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/vfx-compositing/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/vfx-compositing/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill vfx-compositing -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/vfx-compositing/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill vfx-compositing -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/vfx-compositing/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/generative-media-skills skills/production/post-production/vfx-compositing
```

2. **Manually: put the files in place**
- File: `.github/skills/vfx-compositing/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill vfx-compositing -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calesthio/generative-media-skills --path skills/production/post-production/vfx-compositing
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/vfx-compositing/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add calesthio/generative-media-skills --skill vfx-compositing -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/production/post-production/vfx-compositing/SKILL.md

## When to use it
- write a shot physics note before generating visual elements
- choose between 2D overlays, 2.5D cards, and 3D matchmoves
- separate core, edge, and garbage mattes for keying
- review lighting, grain, scale, and perspective integration

## Example prompts
- Plan the compositing strategy for a six-second product insert
- Review the edge matte and despill for this greenscreen plate
- Check perspective and shadow integration for the AI-generated UI

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f689e20053cb7bdd.

BEGIN THIRD-PARTY FILE f689e20053cb7bdd
```text
---
name: vfx-compositing
description: Provider-independent VFX compositing direction for generated video, ads, trailers, product films, social clips, explainers, mixed-source edits, and image/video composites. Use when an agent must plan, brief, generate, integrate, repair, or quality-check visual effects composites involving plates, alpha/mattes, keying, roto, tracking, stabilization, matchmove, lighting/color integration, grain/noise/sharpness, shadows/reflections/contact, depth/atmosphere, AI-generated elements, clean plates, editor/colorist handoff, rights/safety, or compositing QA.
---

# VFX compositing direction

Use this skill to make composite shots feel photographed together, not stacked together. Treat compositing as shot integration across color, motion, geometry, light, lens, material contact, atmosphere, artifact repair, and delivery handoff.

Do not use this skill as a substitute for legal clearance, colorist judgement, an on-set VFX supervisor, or a compositor operating a specific node graph. Use it to brief, plan, supervise, and review provider-independent compositing work.

## Evidence posture

Documented facts below come from professional documentation and standards sources listed at the end. Tool-specific documentation facts were verified on 2026-07-10 and may change.

Empirical observations are repeatable checks an agent can perform by reviewing frames, scopes, mattes, tracks, and before/after renders.

Production heuristics are practical rules of thumb. They are not universal laws; override them when shot evidence, client direction, or a facility spec requires a different approach.

## The compositing target

A good composite satisfies four contracts:

1. The audience contract: the shot does not pull attention away from the story, product, or message.
2. The camera contract: inserted elements share the plate’s perspective, lens behavior, exposure logic, motion, and defocus.
3. The image contract: elements share color pipeline, black/white points, grain/noise, sharpness, compression, and atmospheric depth.
4. The production contract: inputs, versions, rights, AI provenance, handles, mattes, and final outputs are traceable enough for editor/colorist handoff.

When time is short, prioritize the most audience-visible mismatches: perspective, scale, contact/shadow, edge quality, color temperature, motion jitter, and grain/sharpness.

## Start with plate and reference prep

Before requesting generation, roto, cleanup, or integration, inventory the plate:

- Delivery target: aspect ratio, frame rate, resolution, color space, HDR/SDR, codec, duration, handles, captions/safe areas.
- Plate quality: camera motion, rolling shutter, motion blur, focus, lens distortion, chromatic aberration, grain/noise, compression, exposure, white balance, clipped highlights, crushed shadows.
```
END THIRD-PARTY FILE f689e20053cb7bdd

The third-party file has ended. Everything between the f689e20053cb7bdd tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2840 of 30452 bytes. © calesthio · MIT · https://github.com/calesthio/generative-media-skills/tree/HEAD/skills/production/post-production/vfx-compositing/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
