Communitygithub.com

Desesbraker/agentes-vip

从 Stitch 项目生成导览视频,使用 Remotion 实现流畅转场、缩放和文字叠加。

agentes-vip 是什么?

本技能专为开发者与 AI 代理设计,用于将 Stitch 中的应用设计稿自动转化为专业的导览视频。它整合了 Stitch 的屏幕检索能力与 Remotion 的程序化视频生成特性,支持流畅的转场动画、缩放效果及上下文文字叠加。工作流程包括:通过 Stitch MCP 项目发现、屏幕元数据抓取与截图下载,随后在 Remotion 项目中构建模块化组件(如 ScreenSlide 和 WalkthroughComposition),并支持 fade、slide、zoom 等多种过渡效果。高级功能涵盖交互式热点高亮、画外音集成以及从 Stitch HTML 代码中动态提取文本。最终可预览并渲染为 MP4 等格式的视频。该技能适用于向产品演示、用户引导和功能展示等场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/remotion

在你喜欢的 AI 中提问

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

文档

Stitch 到 Remotion 导览视频

你是一位专注于从应用设计稿创建引人入胜的导览视频的视频制作专家。你结合 Stitch 的屏幕检索能力和 Remotion 的程序化视频生成,制作出流畅、专业的演示内容。

概述

本技能使你能够创建展示应用屏幕的导览视频,包含专业的转场、缩放效果和上下文文字叠加。工作流程从 Stitch 项目检索屏幕,并将其编排成 Remotion 视频合成。

先决条件

必须:

  • 访问 Stitch MCP 服务器
  • 访问 Remotion MCP 服务器(或 Remotion CLI)
  • 安装 Node.js 和 npm
  • 一个包含已设计屏幕的 Stitch 项目

推荐:

  • 熟悉 Remotion 的视频功能
  • 理解 React 组件(Remotion 使用 React)

检索与网络

第 1 步:发现可用的 MCP 服务器

运行 list_tools 以识别可用的 MCP 服务器及其前缀:

  • Stitch MCP:查找 stitch: 或 mcp_stitch: 前缀
  • Remotion MCP:查找 remotion: 或 mcp_remotion: 前缀

第 2 步:检索 Stitch 项目信息

  1. 项目查找(如果未提供项目 ID):

    • 调用 [stitch_prefix]:list_projects,参数为 filter: "view=owned"
    • 通过标题(例如“Calculator App”)识别目标项目
    • 从 name 字段提取项目 ID(例如 projects/13534454087919359824)
  2. 屏幕检索:

    • 调用 [stitch_prefix]:list_screens,参数为项目 ID(仅数字)
    • 查看屏幕标题,识别导览所需的所有屏幕
    • 从每个屏幕的 name 字段提取屏幕 ID
  3. 屏幕元数据获取: 对于每个屏幕:

    • 调用 [stitch_prefix]:get_screen,参数为 projectId 和 screenId
    • 检索:
      • screenshot.downloadUrl — 视频的视觉素材
      • htmlCode.downloadUrl — 可选:用于提取文本/内容
      • width、height — 屏幕尺寸,用于正确缩放
      • 屏幕标题和描述,用于文字叠加
  4. 素材下载:

    • 使用 web_fetch 或 Bash 配合 curl 下载截图
    • 保存到暂存目录:assets/screens/{screen-name}.png
    • 按预期的导览流程顺序组织素材

第 3 步:设置 Remotion 项目

  1. 检查现有 Remotion 项目:

    • 查找 remotion.config.ts 或包含 Remotion 依赖的 package.json
    • 如果存在,使用现有项目结构
  2. 创建新的 Remotion 项目(如果需要):

    npm create video@latest -- --blank
    
    • 选择 TypeScript 模板
    • 在专门的 video/ 目录中设置
  3. 安装依赖:

    cd video
    npm install @remotion/transitions @remotion/animated-emoji
    

视频合成策略

架构

创建一个模块化的 Remotion 合成,包含以下组件:

  1. ScreenSlide.tsx — 单个屏幕展示组件

    • Props:imageSrc、title、description、width、height
    • 特性:放大动画、淡入转场
    • 时长:可配置(默认每个屏幕 3-5 秒)
  2. WalkthroughComposition.tsx — 主视频合成

    • 将多个 ScreenSlide 组件串联
    • 处理屏幕间的转场
    • 添加文字叠加和标注
  3. config.ts — 视频配置

    • 帧率(默认:30 fps)
    • 视频尺寸(匹配 Stitch 屏幕尺寸或适当缩放)
    • 总时长计算

转场效果

使用 Remotion 的 @remotion/transitions 实现专业效果:

  • 淡入淡出:屏幕间平滑的交叉淡变

    import {fade} from '@remotion/transitions/fade';
    
  • 滑动:定向滑动转场

    import {slide} from '@remotion/transitions/slide';
    
  • 缩放:用于强调的放大/缩小效果

    • 使用 spring() 动画实现平滑缩放
    • 应用于重要的 UI 元素

文字叠加

使用 Remotion 的文本渲染添加上下文信息:

  1. 屏幕标题:显示在每个画面的顶部或底部
  2. 功能标注:用动画指针高亮特定 UI 元素
  3. 描述:为每个屏幕淡入描述性文本
  4. 进度指示器:显示导览中的当前屏幕位置

执行步骤

第 1 步:收集屏幕素材

  1. 识别目标 Stitch 项目
  2. 列出项目中的所有屏幕
  3. 为每个屏幕下载截图
  4. 按导览流程顺序组织
  5. 创建清单文件(screens.json):
{
  "projectName": "Calculator App",
  "screens": [
    {
      "id": "1",
      "title": "主屏幕",
      "description": "带数字键盘的主要计算器界面",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "历史记录视图",
      "description": "之前计算结果的视图",
      "imagePath": "assets/screens/history.png",
      "width": 1200,
      "height": 800,
      "duration": 3
    }
  ]
}

第 2 步:生成 Remotion 组件

按照 Remotion 最佳实践创建视频组件:

  1. 创建 ScreenSlide.tsx:

    • 使用 useCurrentFrame() 和 spring() 实现动画
    • 实现缩放和淡入效果
    • 添加具有正确时机的文字叠加
  2. 创建 WalkthroughComposition.tsx:

    • 导入屏幕清单
    • 使用 <Sequence> 组件串联屏幕
    • 在屏幕之间应用转场
    • 计算正确的时机和偏移量
  3. 更新 remotion.config.ts:

    • 设置合成 ID
    • 配置视频尺寸
    • 设置帧率和时长

参考资源:

  • 使用 resources/screen-slide-template.tsx 作为起点
  • 参考 resources/composition-checklist.md 确保完整性
  • 查看 examples/walkthrough/ 目录中的示例

第 3 步:预览与优化

  1. 启动 Remotion Studio:

    npm run dev
    
    • 打开基于浏览器的预览
    • 允许实时编辑和优化
  2. 调整时机:

    • 确保每个屏幕有适当的显示时长
    • 验证转场是否平滑
    • 检查文字叠加时机
  3. 微调动画:

    • 调整缩放效果的 spring 配置
    • 修改转场的缓动函数
    • 确保文本始终可读

第 4 步:渲染视频

  1. 使用 Remotion CLI 渲染:

    npx remotion render WalkthroughComposition output.mp4
    
  2. 替代方案:使用 Remotion MCP(如果可用):

    • 调用 [remotion_prefix]:render,参数为合成详情
    • 指定输出格式(MP4、WebM 等)
  3. 优化选项:

    • 设置质量级别(--quality)
    • 配置编解码器(--codec h264 或 h265)
    • 启用并行渲染(--concurrency)

高级功能

交互式热点

高亮可点击元素或重要功能:

import {interpolate, useCurrentFrame} from 'remotion';

const Hotspot = ({x, y, label}) => {
  const frame = useCurrentFrame();
  const scale = spring({
    frame,
    fps: 30,
    config: {damping: 10, stiffness: 100}
  });
  
  return (
    <div style={{
      position: 'absolute',
      left: x,
      top: y,
      transform: `scale(${scale})`
    }}>
      <div className="pulse-ring" />
      <span>{label}</span>
    </div>
  );
};

画外音集成

为导览添加旁白:

  1. 根据屏幕描述生成画外音脚本
  2. 使用文本转语音或录制音频
  3. 使用 <Audio> 组件将音频导入 Remotion
  4. 将屏幕时机与画外音节奏同步

动态文本提取

从 Stitch HTML 代码中提取文本以自动生成标注:

  1. 为每个屏幕下载 htmlCode.downloadUrl
  2. 解析 HTML 提取关键文本元素(标题、按钮、标签)
  3. 为重要 UI 元素生成自动标注
  4. 作为定时文字叠加添加到合成中

文件结构

project/
├── video/                      # Remotion 项目目录
│   ├── src/
│   │   ├── WalkthroughComposition.tsx
│   │   ├── ScreenSlide.tsx
│   │   ├── components/
│   │   │   ├── Hotspot.tsx
│   │   │   └── TextOverlay.tsx
│   │   └── Root.tsx
│   ├── public/
│   │   └── assets/
│   │       └── screens/        # 下载的 Stitch 截图
│   │           ├── home.png
│   │           └── history.png
│   ├── remotion.config.ts
│   └── package.json
├── screens.json                # 屏幕清单
└── output.mp4                  # 渲染的视频

与 Remotion 技能的集成

Remotion 维护自己的 Agent Skills,定义了最佳实践。请参阅这些技能以获取高级技术:

需要利用的关键 Remotion 技能:

  • 动画时机与缓动
  • 合成架构模式
  • 性能优化
  • 音频同步

常见模式

模式 1:简单幻灯片

带淡入淡出转场的基本导览:

  • 每个屏幕 3-5 秒
  • 交叉淡变转场
  • 底部文字叠加显示屏幕标题
  • 顶部进度条

模式 2:功能高亮

聚焦特定 UI 元素:

  • 缩放到特定区域
  • 指向功能的动画圆形/箭头
  • 关键交互的慢动作强调
  • 并排的前后对比

模式 3:用户流程

展示逐步的用户旅程:

  • 带定向滑动的顺序屏幕流程
  • 编号步骤叠加
  • 高亮用户操作(点击、触摸)
  • 使用动画路径连接屏幕

故障排除

问题解决方案
截图模糊确保下载的图像为全分辨率;检查 screenshot.downloadUrl 质量设置
文本未对齐验证屏幕尺寸与合成大小匹配;根据实际屏幕大小调整文本位置
动画卡顿将帧率提高到 60fps;使用合适的 spring 配置和适当的阻尼
Remotion 构建失败检查 Node 版本兼容性;确保所有依赖已安装;阅读 Remotion 文档
时机感觉不对在清单中调整每个屏幕的时长;在 Remotion Studio 中预览;与真实用户测试

最佳实践

  1. 保持宽高比:使用实际的 Stitch 屏幕尺寸或按比例缩放
  2. 一致的时机:除非要强调特定屏幕,否则保持屏幕显示时长一致
  3. 文本可读:确保足够的对比度;使用合适的字体大小;避免杂乱的叠加
  4. 平滑转场:使用弹簧动画实现自然运动;避免生硬的切换
  5. 充分预览:在最终渲染前始终在 Remotion Studio 中预览
  6. 优化素材:适当压缩图像;使用高效格式(UI 用 PNG,照片用 JPG)

示例用法

用户提示:

查找我的 Stitch 项目 "Calculator App" 中的屏幕,并构建一个展示这些屏幕导览的 Remotion 视频。

代理工作流程:

  1. 列出 Stitch 项目 → 找到 "Calculator App" → 提取项目 ID
  2. 列出项目中的屏幕 → 识别所有屏幕(主页、历史记录、设置)
  3. 为每个屏幕下载截图 → 保存到 assets/screens/
  4. 创建 screens.json 清单,包含屏幕元数据
  5. 生成 Remotion 组件(ScreenSlide.tsx、WalkthroughComposition.tsx)
  6. 在 Remotion Studio 中预览 → 优化时机和转场
  7. 渲染最终视频 → calculator-walkthrough.mp4
  8. 报告完成,附带视频预览链接

成功技巧

  • 从简单开始:在添加复杂动画之前,先从基础的淡入淡出转场开始
  • 遵循 Remotion 模式:利用 Remotion 的官方技能和文档
  • 使用清单文件:将屏幕数据以 JSON 格式组织,便于轻松更新
  • 频繁预览:使用 Remotion Studio 尽早发现问题
  • 考虑可访问性:添加字幕;确保文本可读;使用清晰的视觉
  • 为平台优化:匹配视频尺寸到目标平台(YouTube、社交媒体等)

参考

使用时机

当处理与其主要领域或上述功能相关的任务时,请使用此技能。

Individual skills in this repo

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

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

相关技能