Add Sfx

This automates the process of adding sound effects to Remotion's @remotion/sfx package, handling all the steps from repository setup to documentation. It walks through adding WAV files to remotion.media, creating camelCase exports, generating MDX documentation pages with audio players and metadata, and updating sidebars and tables of contents. The workflow is pretty specific to Remotion's infrastructure, requiring CC0 licensed files normalized to -3dB and coordination across multiple repositories. It's clearly designed for maintainers who regularly contribute sound effects to the library rather than one-off additions. The attention to naming conventions and version management suggests this comes from real pain points in keeping the package consistent.

skills.sh installs: 2.8K
GitHub stars: 72.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add remotion-dev/remotion --skill add-sfx --agent claude-code

Installs into .claude/skills of the current project.

Files

Prerequisites

Sound effects must first be added to the remotion.media package.
Then it can be deployed using bun run build. The .env may be missing if we are in a worktree, but on the main non-worktree branch it should be present.

The source of truth is generate.ts in that repo. A sound effect must exist there before it can be added to @remotion/sfx.

Sound effects must be:

WAV format
CC0 (Creative Commons 0) licensed
Normalized to peak at -3dB

Steps

1. Add to `remotion.media` repo (must be done first)

In the remotion-dev/remotion.media repo:

Add the WAV file to the root of the repo

Add an entry to the soundEffects array in generate.ts:

{
  fileName: "my-sound.wav",
  attribution:
    "Description by Author -- https://source-url -- License: Creative Commons 0",
},

Run bun generate.ts to copy it to files/ and regenerate variants.json
Deploy

2. Add the export to `packages/sfx/src/index.ts`

Use camelCase for the variable name. Avoid JavaScript reserved words (e.g. use uiSwitch not switch).

SKILL.md on GitHub

Details

Repository: github.com/remotion-dev/remotion
Category: Generative Media
First seen: May 16, 2026

More from remotion-dev/remotion

All 13