# effects

effects is a Claude Code skill that adds 51 visual effects to talking-head videos. It tracks the speaker's face, renders overlays behind the head, and triggers on /effects or plain descriptions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1123 repo stars
- Author: Vibha-Ramprakash
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Vibha-Ramprakash/claude-video-effects/tree/HEAD/SKILL.md
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/effects

## What it does

The skill enhances talking-head vertical video clips by generating animated overlays, glass widgets, and dynamic titles. The `scripts/setup.sh` script initializes a local virtual environment in `.venv`. To align graphics with speech, `scripts/words.py` extracts timestamps for specific spoken phrases before `scripts/fx.py` creates the overlay plan.

Draft frames save to `check.png` first so the layout can be verified before rendering. The final export keeps original audio and defaults to 1080p, while 4K output requires passing `--width 2160`.

Rendering requires Python 3.12 and FFmpeg installed in the system PATH.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Vibha-Ramprakash/claude-video-effects --skill effects -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Vibha-Ramprakash/claude-video-effects --skill effects -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Vibha-Ramprakash/claude-video-effects --skill effects -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Vibha-Ramprakash/claude-video-effects effects
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Vibha-Ramprakash/claude-video-effects --skill effects -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Vibha-Ramprakash/claude-video-effects
```

### Windsurf (Devin Desktop)

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

### 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/Vibha-Ramprakash/claude-video-effects/tree/HEAD/SKILL.md

## When to use it
- place dynamic titles and cards behind a speaker's head
- sync video effect timing with spoken words
- render preview frame stills before full video export
- export edited clips in 1080p or 4K while preserving audio

## Example prompts
- /effects orbit around the speaker's head in speaker.mp4 from second 3 to 6
- Add a todo checklist card next to the face when I mention tasks in clip.mp4
- Render a still frame check for spotlight effect on interview.mov

## 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: a205e277c338eb0e.

BEGIN THIRD-PARTY FILE a205e277c338eb0e
````text
---
name: effects
description: Add any of 51 video effects to a talking-head video (orbit, spotlight, glass widgets, timeline, checklist, headline wall, comment box, phone fan, liquid glass graph, match-cut, iPhone toggles, LED sign, over-the-shoulder zoom, iMessage pop-ups, place-in-grid and more). Effects track the speaker's face and can sit behind their head. Use when the user types /effects, names one of the effects, or asks to add an effect, zoom, grade, sticker or animation to their video.
---

# Effects: 51 starter video effects (by @vibha.in.progress)

The user is usually not technical. Keep replies short and friendly, do the work for them, and never ask them to run commands themselves.

All paths below are relative to this skill's folder (the folder this SKILL.md is in). Use its absolute path in commands.

## 1. First run: set up (once)
Run `bash scripts/setup.sh`. It prints `READY` when done (the first time takes 1 to 3 minutes).
- `NEED_FFMPEG`: install it for them. On a Mac: `brew install ffmpeg` (if `brew` is missing, tell them to install Homebrew from brew.sh first). On Windows: `winget install ffmpeg`.
- `NEED_PYTHON`: install Python 3.12 (Mac: `brew install python@3.12`, Windows: `winget install Python.Python.3.12`), then run setup again.
- On Windows, the Python is at `.venv\Scripts\python.exe` instead of `.venv/bin/python`.

## 2. Get the video and the effect
- Video: the user drags the file into the chat, or gives a path. A vertical phone video works best.
- Effect: from `/effects <name>`, or from what they describe. Match their words to the table below. Unsure? Show them the list.

## 3. Find the timing
- If they say "on the word X" or "when I say ...", run `.venv/bin/python scripts/words.py <video>` and use those times.
- If they give no timing, apply the effect for the whole clip, or ask which part (one short question).
- Short windows look best: 1.5 to 4 seconds per effect.

## 4. Draft, check, render
1. Write the plan next to their video as `<video-name>_effects.json`:
   ```json
   {"effects": [
     {"fx": "orbit", "start": 3.2, "end": 6.0},
     {"fx": "backdrop-word", "start": 14.0, "end": 16.3, "text": "CLAUDE"}
   ]}
   ```
2. Check frames first (fast): `.venv/bin/python scripts/fx.py --plan <plan.json> <video> <folder>/check.png --still 4.5,15.2`, using the middle of each effect. Look at the PNGs yourself. Fix the text, timing or options if something looks off (covers the face, cut off by the edge, unreadable).
3. Render: `.venv/bin/python scripts/fx.py --plan <plan.json> <video> <video-name>_effects.mp4`. The output keeps their original audio. It renders at 1080p by default; add `--width 2160` for 4K (slower).
4. Tell them where the file is. Remind them in one line to watch it before posting: it drafts, they approve.

A single effect needs no plan: `.venv/bin/python scripts/fx.py orbit <video> <out.mp4> --start 3 --end 6 --text "..." --opt key=value`.

## The 51 effects
| # | `fx` name | What it does | Options (all optional) |
|---|---|---|---|
| 1 | `noise` | Reels pile up behind your head, one every quarter second | `images` (folder of screenshots or clips), `size` |
````
END THIRD-PARTY FILE a205e277c338eb0e

The third-party file has ended. Everything between the a205e277c338eb0e 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 3157 of 11456 bytes. © Vibha-Ramprakash · MIT · https://github.com/Vibha-Ramprakash/claude-video-effects/tree/HEAD/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
