AGENT SKILL

remotion-video-builder

Use when building, reviewing, or refactoring a Remotion project, especially parameterized launch or demo videos with shared props schemas, calculateMetadata, Sequence and Series timing, multiple aspect ratios, terminal or footage layers, and render scripts. Prefer official Remotion docs or MCP for API details because package behavior may change.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
remotion-video-builder
description
Use when building, reviewing, or refactoring a Remotion project, especially parameterized launch or demo videos with shared props schemas, calculateMetadata, Sequence and Series timing, multiple aspect ratios, terminal or footage layers, and render scripts. Prefer official Remotion docs or MCP for API details because package behavior may change.

02 资源文件 2

03 SKILL.md 正文

Remotion Video Builder

Your Remotion knowledge may be stale. When exact API behavior matters, prefer the official remotion-documentation MCP server or the docs at remotion.dev.

Start Here

  • If the project does not exist yet, scaffold it with npx create-video@latest and prefer the blank template.
  • Keep every remotion and @remotion/* package on the exact same version and avoid caret ranges.
  • Standard entry shape:
    • src/index.ts calls registerRoot()
    • src/Root.tsx registers all videos with <Composition> or <Still>

Build Order

  1. Model the input contract first:
    • top-level props schema
    • timeline or event data
    • render profile
  2. Define shared props with zod and pass the schema to each <Composition>.
  3. Use calculateMetadata to derive durationInFrames, width, height, transformed props, and defaultOutName.
  4. Build the scene structure with <Series> for narrative order and <Sequence> for overlays, entrances, footage windows, and callouts.
  5. In Remotion v4.x projects, explicitly set premountFor on <Sequence> elements that need assets loaded before they appear.
  6. Add sample data and render scripts before polishing animation.

Defaults And Rules

  • Default to fps={30} and 1920x1080 for landscape unless the brief says otherwise.
  • Use AbsoluteFill for layering.
  • Use staticFile() for anything coming from public/.
  • Use useCurrentFrame() and useVideoConfig() for frame-based logic.
  • Prefer subtle motion:
    • spring() with high damping
    • interpolate() with clamping
  • Do not use Math.random(). Use random(seed) from remotion.
  • Keep text animation simple and legible.
  • Keep landscape and vertical outputs on the same business logic unless the brief truly requires divergence.

Parameterized Video Checklist

  • One shared top-level z.object() schema
  • defaultProps matching the component prop shape
  • calculateMetadata returning dynamic duration or dimensions when inputs require it
  • Sample JSON or TypeScript data for local preview
  • Render scripts for every target output

Footage Strategy

Support at least these modes when footage is optional:

  • none
  • placeholder
  • real

The timeline and overlays should still render when no real footage exists.

Millrace Launch Video

If the request is about Millrace or the launch video pipeline, read references/millrace-launch-video.md before implementing.

References

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k