Claude Skill

remotion-video

Create, modify, and render Remotion React video projects in the current Astravia conversation workspace. Use for requests to make programmatic videos, motion graphics, animated explainers, social videos, data videos, or to edit an existing Remotion composition and export it as MP

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download maomaochong-ai-open-astravia-packages_plugins_presets_remotion-renderer_agent_skills_remotion-video-cf58759.zip · 1 KB

Install

skills CLI npx skills add https://github.com/maomaochong-ai/open-astravia/tree/main/packages/plugins/presets/remotion-renderer/agent/skills/remotion-video
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install maomaochong-ai-open-astravia@llmmart
Git git clone https://github.com/maomaochong-ai/open-astravia.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole maomaochong-ai/open-astravia collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Remotion Video

Treat the current workspace root as the Remotion project. Do not create another project directory inside it.

Workflow

  1. Inspect package.json, src/, public/, and existing compositions before editing.
  2. If no project exists, create a standard TypeScript Remotion project directly in the workspace root.
  3. Install dependencies with npm install. Astravia Desktop guarantees managed Node and npm; do not assume Bun is available to the packaged app.
  4. Build or edit compositions using normal Remotion React APIs.
  5. Call render_remotion_video with the exact Composition id after the source is complete.
  6. Report the returned out/*.mp4 path. Do not claim the render succeeded unless the tool returns ok: true.

New project baseline

Use exact matching Remotion versions. The supported baseline is 4.0.507:

{
  "name": "remotion-video",
  "private": true,
  "version": "0.1.0",
  "type": "module",
  "scripts": {
    "studio": "remotion studio src/index.ts",
    "render": "remotion render src/index.ts Main out/main.mp4"
  },
  "dependencies": {
    "@remotion/cli": "4.0.507",
    "react": "19.1.1",
    "react-dom": "19.1.1",
    "remotion": "4.0.507"
  },
  "devDependencies": {
    "@types/react": "^19.1.1",
    "@types/react-dom": "^19.1.1",
    "typescript": "^5.9.2"
  }
}

Create src/index.ts with registerRoot(), a root component that registers at least one <Composition>, composition modules under src/, public/ for media, and out/ for renders. Preserve an existing project's versions and structure instead of replacing them with this baseline.

Composition rules

  • Drive animation with useCurrentFrame(), interpolate(), spring(), <Sequence>, and other deterministic Remotion APIs.
  • Use staticFile() for files under public/.
  • Keep width, height, fps, and duration explicit on each Composition unless calculateMetadata() intentionally computes them.
  • Pass the same JSON props through the render tool that the Composition expects.
  • Keep remotion.config.ts when present. The renderer calls the project-local Remotion CLI, so normal CLI configuration and installed Remotion extensions continue to apply.
  • Install any additional package imported by the composition before rendering.

Rendering

Use:

render_remotion_video({
  compositionId: "Main",
  inputProps: {},
  outputName: "main.mp4"
})

entryPoint defaults to src/index.ts. The renderer writes only MP4/H.264 output in this version. Fix source, dependency, or Composition errors reported by the tool and retry; do not bypass the plugin by inventing a different render pipeline.

Files (open-astravia)
  • agents
    • openai.yaml 268 B
      Loading…
  • SKILL.md 2.9 KB
    ---
    name: remotion-video
    description: Create, modify, and render Remotion React video projects in the current Astravia conversation workspace. Use for requests to make programmatic videos, motion graphics, animated explainers, social videos, data videos, or to edit an existing Remotion composition and export it as MP4.
    ---
    
    # Remotion Video
    
    Treat the current workspace root as the Remotion project. Do not create another project directory inside it.
    
    ## Workflow
    
    1. Inspect `package.json`, `src/`, `public/`, and existing compositions before editing.
    2. If no project exists, create a standard TypeScript Remotion project directly in the workspace root.
    3. Install dependencies with `npm install`. Astravia Desktop guarantees managed Node and npm; do not assume Bun is available to the packaged app.
    4. Build or edit compositions using normal Remotion React APIs.
    5. Call `render_remotion_video` with the exact Composition id after the source is complete.
    6. Report the returned `out/*.mp4` path. Do not claim the render succeeded unless the tool returns `ok: true`.
    
    ## New project baseline
    
    Use exact matching Remotion versions. The supported baseline is `4.0.507`:
    
    ```json
    {
      "name": "remotion-video",
      "private": true,
      "version": "0.1.0",
      "type": "module",
      "scripts": {
        "studio": "remotion studio src/index.ts",
        "render": "remotion render src/index.ts Main out/main.mp4"
      },
      "dependencies": {
        "@remotion/cli": "4.0.507",
        "react": "19.1.1",
        "react-dom": "19.1.1",
        "remotion": "4.0.507"
      },
      "devDependencies": {
        "@types/react": "^19.1.1",
        "@types/react-dom": "^19.1.1",
        "typescript": "^5.9.2"
      }
    }
    ```
    
    Create `src/index.ts` with `registerRoot()`, a root component that registers at least one `<Composition>`, composition modules under `src/`, `public/` for media, and `out/` for renders. Preserve an existing project's versions and structure instead of replacing them with this baseline.
    
    ## Composition rules
    
    - Drive animation with `useCurrentFrame()`, `interpolate()`, `spring()`, `<Sequence>`, and other deterministic Remotion APIs.
    - Use `staticFile()` for files under `public/`.
    - Keep width, height, fps, and duration explicit on each Composition unless `calculateMetadata()` intentionally computes them.
    - Pass the same JSON props through the render tool that the Composition expects.
    - Keep `remotion.config.ts` when present. The renderer calls the project-local Remotion CLI, so normal CLI configuration and installed Remotion extensions continue to apply.
    - Install any additional package imported by the composition before rendering.
    
    ## Rendering
    
    Use:
    
    ```text
    render_remotion_video({
      compositionId: "Main",
      inputProps: {},
      outputName: "main.mp4"
    })
    ```
    
    `entryPoint` defaults to `src/index.ts`. The renderer writes only MP4/H.264 output in this version. Fix source, dependency, or Composition errors reported by the tool and retry; do not bypass the plugin by inventing a different render pipeline.
    
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.