CREATIVE PRODUCTION / Remotion
Remotion Captions
Routes Remotion caption work through one typed Caption contract: transcribing audio with whisper.cpp, displaying TikTok-style paged captions with word highlighting, and importing existing .srt subtitle files.
“Transcribing, displaying and animating captions”
01 / THE REASONING
Why this made the selection.
- Defines one typed Caption contract (text, startMs, endMs, timestampMs, confidence, pageBreakAfter) and routes transcription, display and SRT import through it, so caption data cannot drift between pipeline stages.
- Each sub-workflow loads on demand from its own reference — whisper.cpp transcription, paged display with word highlighting, parseSrt import — keeping the entry skill small and the context cost proportional to the task.
- The transcription path is local and deterministic (whisper.cpp via @remotion/install-whisper-cpp) rather than a cloud speech API, which matters for reproducible renders.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- packages/codex-plugin/skills/remotion-captions/SKILL.md
- transcribe-captions.md
- display-captions.md
- import-srt-captions.md
- LICENSE.md
Our findings
- All three referenced workflow files exist in the skill directory alongside the router SKILL.md, plus an agents and assets directory.
- The display reference holds rendering back with useDelayRender() until captions are fetched, which is the correct Remotion pattern for deterministic server-side rendering.
- The import path uses parseSrt() from @remotion/captions rather than hand-rolled SRT parsing, avoiding the timestamp-format edge cases that break naive parsers.
Not established by this review
- No audio was transcribed and no composition was rendered; the references were read, not executed.
- whisper.cpp installation and model download were not run.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add remotion-dev/remotion/packages/codex-plugin/skills/remotion-captions --skill remotion-captions Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/remotion-dev/remotion/tree/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions --skill remotion-captions - Install the complete skill directory; the router SKILL.md is useless without its three reference files.
- Add @remotion/captions (and @remotion/install-whisper-cpp when transcribing) to the Remotion project before starting.
Before you start
- Node.js/npm for the installer
- An agent that supports the Agent Skills format
- A Remotion project; whisper.cpp for the transcription path
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/remotion-dev/remotion/blob/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/remotion-dev/remotion/blob/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions/transcribe-captions.md
Supports: review, whySelected, bestFor
https://github.com/remotion-dev/remotion/blob/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions/display-captions.md
Supports: review, whySelected
https://github.com/remotion-dev/remotion/blob/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions/import-srt-captions.md
Supports: review, whySelected
https://github.com/remotion-dev/remotion/blob/05d80c67439a1c744687712ed4f629d62b799cf7/LICENSE.md
Supports: license, access
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://raw.githubusercontent.com/remotion-dev/remotion/05d80c67439a1c744687712ed4f629d62b799cf7/packages/codex-plugin/skills/remotion-captions/SKILL.md
Supports: limitations, review.notTested, review.reviewedAt