Skip to content

Production-ready animations, transitions, backgrounds, and scenes for Remotion

docs: README for Claude Code plugin, agent and MCP searches

kapishdimaf1bb3abb03cd
diff --git a/README.md b/README.md
index 7062510c..e86ef37a 100644
--- a/README.md
+++ b/README.md
@@ -1,51 +1,117 @@
<p align="center">
- <img src="./public/hero.png" alt="remocn — shadcn registry for Remotion" />
+ <img src="./public/hero.png" alt="Remocn: Claude Code plugin and agent skill for making Remotion videos" />
+</p>
+
+<p align="center">
+ <a href="https://skills.sh/remocn/remocn"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fskills.sh%2Fapi%2Fbadge%2Fremocn%2Fremocn" alt="Remocn on skills.sh" /></a>
+ <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-black" alt="MIT license" /></a>
+ <a href="https://remocn.dev/docs/getting-started/mcp-server"><img src="https://img.shields.io/badge/MCP-remocn.dev%2Fmcp-black" alt="Hosted MCP server at remocn.dev/mcp" /></a>
</p>
![GitHub Health](https://shieldcn.dev/group/github/stars/kapishdima/remocn+github/forks/kapishdima/remocn+badge/%E2%9D%A4%EF%B8%8F%20Sponsor-this%20project-FF69B4.svg?variant=secondary)
-# Remocn
+# Remocn: Claude Code plugin & agent skill for making Remotion videos
-Remocn is a copy-paste component library for building videos in Remotion. Instead of writing every fade, wipe, and kinetic title from scratch, you `npx shadcn add` a polished primitive into your project and own the code. Built for solo builders and small teams who need a product demo video shipped today, not next week.
+Remocn is a Claude Code plugin, agent skill and MCP server for making Remotion videos from 932 MIT-licensed Remotion components. Your agent plans a storyboard, installs the components into your Remotion project with the shadcn CLI and writes the video: a product demo, a launch video, a changelog video or a social clip.
-Rather direct the video than write it? [Remocn Studio](https://remocn.studio) is a free, open-source macOS app where your own coding agent (Claude Code, Codex, GitHub Copilot or Grok) builds the video from Remocn components while you watch the live preview.
+**Works with Claude Code, Codex, Cursor, GitHub Copilot and any agent that loads skills or connects to MCP.**
-## Why Remocn
+```bash
+npx skills add Remocn/remocn
+```
-Production-ready Remotion code: every component uses useCurrentFrame(), interpolate(), and spring() correctly. No Math.random() traps that break rendering.
-Own your code: components are copied into your project, not installed as a dependency. Tweak them however you like.
-Live previews: each component page mounts a real @remotion/player you can scrub frame-by-frame
+## Install
-## Installation
+Pick one. The plugin already includes the skill and the MCP server.
-Remotion is a prerequisite — set up a Remotion project first if you don't have one (`npx create-video@latest`). Then add any component from the registry:
+| You use | Install | You get |
+|---|---|---|
+| Claude Code | `/plugin install remocn --marketplace Remocn/remocn` | The `/remocn:video` workflow, helper agents, the skill and the MCP tools |
+| Codex | `codex plugin marketplace add Remocn/remocn` then `codex plugin add remocn@remocn` | The same plugin |
+| Cursor, Copilot or any agent that loads skills | `npx skills add Remocn/remocn` | The [agent skill](https://remocn.dev/docs/getting-started/agent-skill) |
+| Any MCP client | `https://remocn.dev/mcp` | The [MCP server](https://remocn.dev/docs/getting-started/mcp-server): search, docs, video plans, previews |
+| Your own hands | `npx shadcn@latest add @remocn/blur-reveal` | One component's source in your repo |
-```bash
-npx shadcn@latest add @remocn/blur-reveal
-```
+Remotion is a prerequisite. The plugin creates a project in an empty folder; by hand it's `npx create-video@latest`.
-## Setup with AI
+## Demo
-You need two things: an AI coding agent and an empty folder.
+<p align="center">
+ <a href="https://cdn.remocn.dev/videos/intoducing-remocn.mp4"><img src="https://cdn.remocn.dev/posters/intoducing-remocn.png" alt="Introducing Remocn: launch video made with Remocn components (MP4)" width="720" /></a>
+ <br />
+ <sub>▶ <a href="https://cdn.remocn.dev/videos/intoducing-remocn.mp4">Watch the MP4</a> · built with Remotion and Remocn components</sub>
+</p>
-**1. Get an agent.** We recommend Claude Code, also works with ChatGPT, Opencode and others.
-**2. Open the agent in an empty folder and paste:**
+## Make a Remotion video with Claude Code
```text
-Set up a new Remotion video project in this folder, then install the remocn agent skill: npx skills add Remocn/remocn --yes. When you're done, start the preview studio so I can watch the video while we work
+/remocn:video 30-second product demo for Tasklane, a shared task inbox for small teams
```
-When a browser tab opens with an empty video player, you're ready. Pick a [guide](https://remocn.dev/docs/guides) and make it yours.
+`/remocn:video` runs brief → storyboard → install → compose → visual check → hand-off. It stops after the storyboard so you can change direction before any code is written. Then the `scene-reviewer` agent renders stills of every beat and checks them for clipped text, empty frames and low contrast. The video lands in `src/videos/<slug>/index.tsx`; render it with `npx remotion render <slug>` or open it in [Remocn Studio](https://remocn.studio).
-## Plugin for Claude Code and Codex
+Also in the plugin: `/remocn:changelog` turns git tags, commits or merged PRs into a changelog video, `/remocn:add <name>` installs and places one component, `/remocn:studio` opens the project in Remocn Studio. [Plugin docs](https://remocn.dev/docs/getting-started/plugin).
-The [remocn plugin](https://remocn.dev/docs/getting-started/plugin) bundles the skill with a `/remocn:video` workflow: brief → storyboard → install → compose → visual check → open in [Remocn Studio](https://remocn.studio).
+## What you can make
-```text
-/plugin install remocn --marketplace Remocn/remocn
-```
+| Video | Guide |
+|---|---|
+| Product demo video from your codebase | [Product demo](https://remocn.dev/docs/guides/product-demo) |
+| Launch video | [Launch video](https://remocn.dev/docs/guides/launch-video) |
+| Changelog video | [Changelog video](https://remocn.dev/docs/guides/changelog-video) |
+| Feature announcement | [Feature announcement](https://remocn.dev/docs/guides/feature-announcement) |
+| Teaser | [Teaser](https://remocn.dev/docs/guides/teaser) |
+| Showcase reel | [Showcase reel](https://remocn.dev/docs/guides/showcase-reel) |
+
+The registry has text animations, transitions, backgrounds, shaders, camera and physics shots, captions, filters, UI primitives, app-screen simulations (AI chat composers, Claude Code, v0, terminals), animated icons and full video templates (Release Teaser, Brand Guidelines, Workflow Console, Product Showcase, Order Flow).
+
+## Gallery
+
+<table>
+ <tr>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/typography.mp4"><img src="https://cdn.remocn.dev/posters/typography.png" alt="Text animations" width="260" /></a><br /><sub>Text animations</sub></td>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/new-transitions.mp4"><img src="https://cdn.remocn.dev/posters/new-transitions.png" alt="Transitions" width="260" /></a><br /><sub>Transitions</sub></td>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/paper-shaders.mp4"><img src="https://cdn.remocn.dev/posters/paper-shaders.png" alt="Shader backgrounds" width="260" /></a><br /><sub>Shader backgrounds</sub></td>
+ </tr>
+ <tr>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/remocn-chat.mp4"><img src="https://cdn.remocn.dev/posters/remocn-chat.png" alt="Chat and messaging primitives" width="260" /></a><br /><sub>Chat primitives</sub></td>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/remocn-ui.mp4"><img src="https://cdn.remocn.dev/posters/remocn-ui.png" alt="UI primitives" width="260" /></a><br /><sub>UI primitives</sub></td>
+ <td align="center"><a href="https://cdn.remocn.dev/videos/remocn-icons.mp4"><img src="https://cdn.remocn.dev/posters/remocn-icons.png" alt="Animated icons" width="260" /></a><br /><sub>Animated icons</sub></td>
+ </tr>
+</table>
+
+Every clip above was made with Remocn components. More in the [video changelog](https://remocn.dev/changelog/video), and every component has a live, scrubbable preview in the [docs](https://remocn.dev/docs).
+
+## Craft rules: what we ban
+
+Agent-made Remotion videos look generic for the same few reasons. The Remocn skill and the plugin's `scene-reviewer` hold your agent's own additions to these rules ([why AI videos look generic](https://remocn.dev/docs/guides/non-generic-ai-video), [Craft](https://remocn.dev/docs/craft)):
+
+- **No glow halos** or blurred color blobs behind headings
+- **No gradient-filled text.** Mark the one word that matters with weight, the accent or a highlight
+- **No decorative ALL-CAPS or wide letter-spacing.** Sentence case, default tracking
+- **No more than one accent color**
+- **No panels that all pop in on the same frame.** Stagger entrances, one focal action per beat
+- **No clipped animations.** Every component states its length in frames; a `Sequence` is never shorter
+- **No invented generic dashboards.** Show a believable product surface or your real screenshots
+- **No lorem or "Scene A" placeholder copy**
+- **No `Math.random()`.** Randomness is seeded, so every render is the same
+- **No invented props or durations.** The agent reads the component's page before it uses it
-In Codex: `codex plugin marketplace add Remocn/remocn`, then `codex plugin add remocn@remocn`.
+Components whose effect is the point (`tracking-in`, shader gradients) are exempt; the rules apply to what the agent writes by hand.
+
+## Remotion's official skills vs Remocn
+
+They answer different questions and work together.
+
+| | Remotion's official skills and plugin | Remocn plugin and skill |
+|---|---|---|
+| Answers | How to write correct Remotion code | What goes on screen: which component for each beat, for how many frames |
+| Install | `npx skills add remotion-dev/skills` | `/plugin install remocn --marketplace Remocn/remocn` or `npx skills add Remocn/remocn` |
+| Output | Code the agent writes from scratch | Code built from installed component source files, in your repo |
+| Ready-made scenes | No | 932 components and full video templates |
+| Cost | Free; Remotion may need a company license | Free, MIT; Remotion's license still applies |
+
+We ran both setups on the same 15-second brief on November 10, 2026, with timings, costs and both MP4s: [the test](https://remocn.dev/docs/getting-started/plugin#test-the-same-15-second-promo-with-and-without-remocn).
## Remotion MCP server (hosted)
@@ -89,7 +155,36 @@ Cursor (`.cursor/mcp.json`):
}
```
-Your agent installs what it picks with `npx shadcn@latest add @remocn/<name>`, and you render with Remotion as usual. The plugin above already includes the server. Setup for every client: [MCP server docs](https://remocn.dev/docs/getting-started/mcp-server).
+Your agent installs what it picks with `npx shadcn@latest add @remocn/<name>`, and you render with Remotion as usual. Setup for every client: [MCP server docs](https://remocn.dev/docs/getting-started/mcp-server). Comparing options? See [Remotion MCP servers compared](https://remocn.dev/docs/guides/remotion-mcp-servers).
+
+## Remocn Studio
+
+Rather direct the video than write it? [Remocn Studio](https://remocn.studio) is a free, open-source macOS app where your own coding agent (Claude Code, Codex, GitHub Copilot or Grok) builds the video from Remocn components while you watch the live preview and export.
+
+## Why Remocn
+
+- **Production-ready Remotion code.** Every component uses `useCurrentFrame()`, `interpolate()` and `spring()` correctly, with no `Math.random()` traps that break rendering.
+- **Own your code.** Components are copied into your project by the shadcn CLI, not installed as a runtime dependency. Change them however you like.
+- **Live previews.** Each component page mounts a real `@remotion/player` you can scrub frame by frame.
+- **Built for agents.** [`/llms.txt`](https://remocn.dev/llms.txt), [`/llms-components.txt`](https://remocn.dev/llms-components.txt) and a Markdown version of every docs page (append `.md`). The skill reads the live index, so it never goes stale.
+
+## FAQ
+
+### Is there a Claude Code plugin or skill for creating Remotion videos?
+
+Yes. Remocn's plugin (`/plugin install remocn --marketplace Remocn/remocn`) adds the `/remocn:video` workflow and 932 ready-made components; the skill (`npx skills add Remocn/remocn`) adds the catalog alone. Remotion also maintains official skills that teach Claude its API, and the two work together.
+
+### Does it work in Cursor or Codex?
+
+Yes. The plugin installs in Claude Code and Codex. In Cursor, install the skill with `npx skills add Remocn/remocn` or add the MCP server at `https://remocn.dev/mcp`.
+
+### Is Remocn free? Is it official?
+
+Remocn is free and MIT-licensed, with no account, servers or usage limits; you render wherever you run Remotion. It is an independent community project, not affiliated with Remotion or shadcn. Remotion keeps its own license, and larger companies may need a Remotion company license.
+
+### Is it a video editor or text-to-video API?
+
+No. There's no timeline and no hosted rendering, and it doesn't edit footage. The agent writes React code from components into your Remotion project.
## Sponsors
diff --git a/lib/docs-meta.test.ts b/lib/docs-meta.test.ts
index e46aa5a9..6808e1b8 100644
--- a/lib/docs-meta.test.ts
+++ b/lib/docs-meta.test.ts
@@ -353,6 +353,7 @@ describe("stated catalog size matches the registry", () => {
"content/docs/getting-started/introduction.mdx",
"content/docs/guides/after-effects-alternatives-for-developers.mdx",
"content/docs/guides/remotion-mcp-servers.mdx",
+ "README.md",
];
it("states the real number of installable components", async () => {
diff --git a/plugins/remocn/.claude-plugin/plugin.json b/plugins/remocn/.claude-plugin/plugin.json
index cd9ba74a..6a294a02 100644
--- a/plugins/remocn/.claude-plugin/plugin.json
+++ b/plugins/remocn/.claude-plugin/plugin.json
@@ -11,7 +11,7 @@
"homepage": "https://remocn.dev/docs/getting-started/plugin",
"repository": "https://github.com/Remocn/remocn",
"license": "MIT",
- "keywords": ["remotion", "video", "shadcn", "motion", "animation"],
+ "keywords": ["remotion", "video", "claude-code", "agent-skills", "mcp", "product-demo", "demo-video", "shadcn", "motion", "animation"],
"icon": "./assets/icon.png",
"documentationUrl": "https://remocn.dev/docs/getting-started/plugin",
"supportUrl": "https://github.com/Remocn/remocn/issues",
diff --git a/plugins/remocn/plugin.json b/plugins/remocn/plugin.json
index 30c175e8..97b24bf6 100644
--- a/plugins/remocn/plugin.json
+++ b/plugins/remocn/plugin.json
@@ -10,7 +10,7 @@
"homepage": "https://remocn.dev/docs/getting-started/plugin",
"repository": "https://github.com/Remocn/remocn",
"license": "MIT",
- "keywords": ["remotion", "video", "shadcn", "motion", "animation"],
+ "keywords": ["remotion", "video", "claude-code", "agent-skills", "mcp", "product-demo", "demo-video", "shadcn", "motion", "animation"],
"extensions": {
"com.openai": {
"interface": {