Communitygithub.com

Hownameee/短视频

所有 Remotion 技能的调度中心

短视频 是什么?

本技能充当 Remotion Agent 生态系统的中心路由器和决策节点。它不包含单一的视频生成逻辑,而是根据用户请求的性质(创建新视频、添加字幕、编辑标记、渲染输出或设置 SaaS 应用)智能地将任务分派到专门的子技能。每个子技能都对应一个独立的 REFERENCE.md 文件,涵盖 Remotion 项目创建、React 标记最佳实践、地图可视化、多媒体处理、交互性、渲染、字幕以及基于 SaaS 的自动化等场景。本技能还提供了启动 Remotion Studio 预览的具体命令,并适应不同的代理环境(Cursor 与其他代理客户端),推荐使用交互式预览而非直接渲染,除非用户明确要求导出 MP4。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/remotion-best-practices

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

保留用户的更改

用户可能会在对话之外对代码进行编辑。

如果你在此期间检测到意外的更改,请不要覆盖它,假设该更改是故意的或需要请求确认。

创建视频

如果用户要求制作、创建或构建新的视频或合成,请加载 创建新的 Remotion 视频,无论是否已存在 Remotion 项目。

新项目设置

如果当前不存在 Remotion 项目,请加载 创建新的 Remotion 项目

React 标记最佳实践

如果你正在编写 Remotion React 标记,请加载 Remotion 标记最佳实践

地图

对于静态地图、动画路径和标记、地理解说器、Mapbox、MapLibre、MapTiler、GeoJSON 或 3D 地理飞行漫游,请加载 Remotion 地图。

多媒体

为了在浏览器中实现多媒体任务,例如修剪、裁剪视频或获取元数据,请加载 Remotion 多媒体

提升交互性

通过良好地组织 Remotion 标记,用户可以交互式地更改 Studio 中的内容并写回代码。如相关,请参考:交互性最佳实践

打开预览

如果用户要求“制作”视频、“创建”视频等,除非用户非常明确,否则默认不要渲染视频。用户更希望看到交互式预览。 一旦项目可以运行,在构建或编辑合成之前启动 Studio 并在浏览器中打开预览。保持预览打开,以便用户实时查看进度并进行引导。

如果你正在使用 Cursor

运行 Studio 时不加 --no-open,以便自动打开浏览器:

npx remotion studio

如果你在使用其他带有应用内浏览器的代理客户端

你可以使用上述命令让 Studio 打开浏览器,或者运行:

npx remotion studio --no-open

这将启动一个长时间运行的过程,并打印预览的服务器 URL。 如果服务器已经启动,它将打印 URL。 如果你使用 --no-open,请在应用内浏览器中打开精确打印的 URL,并验证 Studio 是否加载。一旦存在合成,验证其视频预览是否加载。如果你无法在那里打开它,请在不加 --no-open 的情况下运行 Studio。 你可以通过导航到 /[composition-id] 来访问特定的合成,例如 http://localhost:3000/MapAnimation。

:::note Studio 支持 WebMCP 工具。 :::

如果你没有应用内浏览器

这将在浏览器中打开 Studio,如果它已经打开则重新聚焦。

npx remotion studio

更多选项

要启动 Remotion Studio 中的项目、打开其确切的本地 URL 或配置 Studio CLI 标志,请加载 Remotion Studio。

渲染视频

只有在用户非常明确地要求时才渲染。 例如“渲染视频”、“导出”、“给我 MP4”。

预览还提供了更直观的渲染界面,所以可以考虑使用它而不是命令行来渲染。

npx remotion render

更多选项,请参见 渲染。

对于超越简单 npx remotion render 的高级渲染,请参见:渲染最佳实践

字幕

当处理字幕时,请加载 Remotion 字幕。

创建 SaaS、自动化或应用程序

使用 Remotion SaaS 技能 来获取关于基于 Remotion 的 SaaS 应用程序的知识,例如 <Player>、在 Lambda、Vercel、Cloudflare 上渲染,通过 Express.js 渲染,客户端渲染,或寻找合适的 SaaS 模板。

查阅 Remotion API 和文档

要查找和阅读当前的 Remotion 文档,请加载 Remotion 文档。

升级

要升级 Remotion、相关包、兼容的 Mediabunny 包以及已安装的 Remotion Agent 技能,请加载 Remotion 升级。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

相关技能