frame-smith plugin
A director skill for Remotion that writes promo video compositions: it picks an effect engine, lays out beats and matches sound.
- 118 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill creates and registers files in a Remotion project.
Install
- Works in
Manual install
git clone https://github.com/mouse-lin/frame-smithClaude Code has the manifest `.claude-plugin/plugin.json` and the source `skills/frame-smith/`. A video runtime is required: the `hyperframe` or `remotion` skill.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill creates and registers files in a Remotion project.
This is third-party code. Review the repository files before installing.
What it does
frame-smith is a director, not a renderer. It reads the brief, picks a register, chooses one of four effect engines, lays out events for every beat in seconds, matches music and sound accents, writes a `.tsx` file and registers the composition in the Remotion `Root`. Rendering is done by the attached runtime. There are two registers: `cinematic` for 1920 by 1080 landscape without voice-over and `short` for 1080 by 1920 portrait with subtitles. The engines are a poster cube, theme-flipping capsules, a data pulse and a circular particle carousel. Before writing, the skill checks that `hyperframe` or `remotion` is present, and afterwards it runs an anti-cheap checklist and proves a frame renders. Rule mirrors exist for Cursor, Codex, GitHub Copilot, Trae and CodeBuddy.
Who it is for. Designers and developers making promo videos in Remotion who want considered animation rather than template output.
Good fit when
- A vertical clip with subtitles is needed for Douyin or Xiaohongshu.
- A horizontal product intro without voice-over is assembled.
- Sound and music must land on the same frames.
- An existing Remotion project gets a new composition from a brief.
Not a fit when
- Rendering is wanted without a `hyperframe` or `remotion` runtime.
- The project does not use Remotion.
- A clip must be cut from shot footage.
Example request
Make a 20-second vertical clip for an app launch: poster cube engine, beat-matched music and subtitles.Limitations
The skill writes the composition and does not render it: an installed `hyperframe` or `remotion` runtime is required, otherwise the skill stops and guides installation. Documentation is in Chinese, and mirrors for different agents are synced by `scripts/sync-mirrors.sh`. `AGENTS.md` and the Copilot instructions are hand-written in a shortened form and updated separately. Music and sound are matched from the description and audio rights stay with the user. The last commit dates from July 2026.
How to disable. Remove the plugin or the `skills/frame-smith/` folder from the skills directory. Compositions already created remain in the Remotion project.
FAQ
Is a separate renderer needed?
Yes. The skill writes compositions while a `hyperframe` or `remotion` runtime renders them; one of the two is enough.
Which formats does it support?
The `cinematic` register for 1920 by 1080 without voice-over and the `short` register for 1080 by 1920 with optional subtitles.
Which effect engines are there?
Four: a poster cube, theme-flipping capsules, a data pulse and a particle carousel.
Which agents does it work with?
With Claude Code as a plugin, and with Cursor, Codex, GitHub Copilot, Trae and CodeBuddy through rule mirrors.
How are rule mirrors updated?
Edit only the `skills/frame-smith/` source and run `bash scripts/sync-mirrors.sh`; the `--check` mode reports drift without changes.
Discussion
No questions or reviews yet.
Related
PluginsA skill that makes your agent film a short product video: concept, edit, sound and render on Remotion or HyperFrames
A motion design skill: the agent writes Remotion video code with voice, music and sound and delivers only after measuring frames
One prompt becomes a finished MP4: voiceover, music, stock footage, AI clips, captions and review on Remotion
motion-video-production: a skill for motion videos
motion-video-production
A skill that takes an agent through seven stages for a 15 to 90 second video, a script checking each stage before the next
A Codex skill that turns a script or a voice recording into video with motion graphics, captions and an editable Remotion project.
Claude Code skill: turns a one-line theme into a beat-synced HyperFrames showreel with morph transitions and generated sound.
README in short
The README presents the director idea, four engines, an eight-step workflow and the criteria for a good clip. Supported agents and dependencies are listed separately.