Skip to content
Remotion Captions

Remotion Captions Skill

Remotion's official skill for captions in programmatic videos: it holds the agent to the @remotion/captions Caption type and routes it to guides for transcribing audio, rendering animated captions and importing .srt files.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from remotion-dev/skills.

$ npx skills add remotion-dev/skills --skill remotion-captions

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/remotion-captions/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/remotion-dev/skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/remotion-captions ~/.claude/skills/remotion-captions

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/remotion-captions/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Standardises captions on the @remotion/captions Caption type (text, startMs, endMs, timestampMs, confidence)
  • Routes to a bundled guide for transcribing video and audio into captions
  • Routes to a guide for displaying and animating captions in a composition
  • Covers importing existing .srt subtitle files
  • Hands over to the remotion-best-practices skill and Remotion Studio when done

Remotion Captions is one of the skills Remotion publishes in its remotion-dev/skills repository for agents that write videos in React with Remotion. It covers the whole caption workflow, from producing timed text out of an audio or video file to drawing and animating it on screen.

The skill starts from one rule: every caption is handled as JSON in the Caption type exported by @remotion/captions, with text, startMs, endMs, a nullable timestampMs and confidence, and an optional pageBreakAfter. Keeping one shape means transcripts, imported subtitle files and the rendering code all speak the same format.

From there the skill splits the task in three and tells the agent which bundled file to load for each: transcribing video and audio to generate captions, displaying captions in a composition, and importing an existing .srt subtitle file. When the work is done it hands over to the remotion-best-practices skill and asks the agent to open Remotion Studio, unless told otherwise, so the result can be previewed.

Use it in a Remotion project whenever a video needs subtitles, word-by-word or TikTok-style captions, or a transcript turned into on-screen text. It assumes a Remotion project and the @remotion/captions package; the skill folder ships its reference files alongside SKILL.md. The repository carries no licence file of its own, and Remotion itself is distributed under the Remotion License.

SKILL.md

The instructions your agent loads, as published by Remotion.

SKILL.md
name
remotion-captions
description
Transcribing, displaying and animating captions
version
4.0.544

All captions must be processed in JSON. The captions must use the `Caption` type which is the following:

import type { Caption } from "@remotion/captions";

This is the definition:

type Caption = {
  text: string;
  startMs: number;
  endMs: number;
  timestampMs: number | null;
  confidence: number | null;
  pageBreakAfter?: boolean;
};
Generating captions

To transcribe video and audio files to generate captions, load the [transcribe-captions.md](transcribe-captions.md) file for more instructions.

Displaying captions

To display captions in your video, load the [display-captions.md](display-captions.md) file for more instructions.

Importing captions

To import captions from a .srt file, load the [import-srt-captions.md](import-srt-captions.md) file for more instructions.

Post-creation

After you're done, load this skill: Remotion Best Practices (remotion-best-practices skill)

If not already done, open the Remotion Studio, unless instructed otherwise.

Install
New

Remotion's official skill for writing the React markup of a video: frame-driven animation with interpolate(), Studio-editable timing, media components, built-in visual effects, transitions, captions and fonts.

New

Remotion's official skill for exporting a Remotion video: npx remotion render and still, input props, license keys and free-license renders, frame sequences and transparent video output.

Browse all skills →