Communitygithub.com

JantonioFC/skillsbank

從 Stitch 專案中,使用 Remotion 搭配流暢轉場、縮放和文字疊加,產生操作導覽影片。

skillsbank 是什麼?

這個技能讓開發者與 AI 代理能將 Stitch 設計稿中的畫面,自動組合成為專業的 Remotion 操作導覽影片。它會先透過 Stitch MCP Server 擷取專案與畫面資訊,下載螢幕截圖。接著,它會生成 React 元件(如 ScreenSlide、WalkthroughComposition)並管理畫面排序、轉場效果(淡入、滑動、縮放)、文字疊加與進度指示器。使用此技能時,代理需要存取 Stitch 與 Remotion 的 MCP Server,並具備 Node.js 環境。產出的影片可在 Remotion Studio 中預覽調整,最終透過 CLI 或 Remotion MCP 渲染為 MP4 等格式。適合用於產品展示、教學影片或使用者流程展示,並且支援語音旁白與互動熱點等進階功能。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/plugins/antigravity-awesome-skills-claude/skills/remotion

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Stitch 到 Remotion 操作導覽影片

您是一位專注於從應用程式設計稿製作引人入勝的操作導覽影片的影片製作專家。您將 Stitch 的畫面擷取能力與 Remotion 的程式化影片生成技術結合,製作出流暢且專業的簡報。

概述

此技能讓您能夠製作操作導覽影片,以專業的轉場效果、縮放動態與情境文字疊加來展示應用程式畫面。工作流程會從 Stitch 專案中擷取畫面,並將其編排成 Remotion 影片合成。

先決條件

必要條件:

  • 可使用 Stitch MCP Server
  • 可使用 Remotion MCP Server(或 Remotion CLI)
  • 已安裝 Node.js 和 npm
  • 一個包含已設計好畫面的 Stitch 專案

建議條件:

  • 熟悉 Remotion 的影片功能
  • 了解 React 元件(Remotion 使用 React)

擷取與網路設定

步驟 1:發現可用的 MCP Server

執行 list_tools 來識別可用的 MCP Server 及其前綴:

  • Stitch MCP:尋找 stitch: 或 mcp_stitch: 前綴
  • Remotion MCP:尋找 remotion: 或 mcp_remotion: 前綴

步驟 2:擷取 Stitch 專案資訊

  1. 專案查詢(如果未提供專案 ID):

    • 呼叫 [stitch_prefix]:list_projects 並使用 filter: "view=owned"
    • 根據標題識別目標專案(例如「計算機應用程式」)
    • 從 name 欄位中提取專案 ID(例如 projects/13534454087919359824)
  2. 畫面擷取:

    • 使用專案 ID(僅數值部分)呼叫 [stitch_prefix]:list_screens
    • 檢視畫面標題以識別導覽中的所有畫面
    • 從每個畫面的 name 欄位中提取畫面 ID
  3. 畫面中繼資料擷取: 對每個畫面:

    • 使用 projectId 和 screenId 呼叫 [stitch_prefix]:get_screen
    • 擷取:
      • 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": "Home Screen",
      "description": "Main calculator interface with number pad",
      "imagePath": "assets/screens/home.png",
      "width": 1200,
      "height": 800,
      "duration": 4
    },
    {
      "id": "2",
      "title": "History View",
      "description": "View of previous calculations",
      "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 維護其自己的代理技能,定義最佳實務。請查閱這些以獲得進階技巧:

可利用的關鍵 Remotion 技能:

  • 動畫時間點與緩動
  • 合成架構模式
  • 效能最佳化
  • 音訊同步

常見模式

模式 1:簡易幻燈片

使用淡入轉場的基本導覽:

  • 每個畫面 3-5 秒
  • 淡入轉場
  • 底部文字疊加顯示畫面標題
  • 頂部進度條

模式 2:功能突顯

專注於特定 UI 元素:

  • 縮放至特定區域
  • 指向功能的動畫圓形/箭頭
  • 關鍵互動的慢動作強調
  • 前後比較的並排顯示

模式 3:使用者流程

顯示逐步的使用者旅程:

  • 帶有方向性滑入的順序畫面流程
  • 編號步驟疊加
  • 突顯使用者操作(點擊、輕觸)
  • 使用動畫路徑連接畫面

疑難排解

問題解決方案
螢幕截圖模糊確保下載的圖片使用完整解析度;檢查 screenshot.downloadUrl 的品質設定
文字對齊錯誤確認畫面尺寸符合合成大小;根據實際畫面尺寸調整文字位置
動畫卡頓將影格率提高至 60fps;使用具適當阻尼的 spring 設定
Remotion 建置失敗檢查 Node 版本相容性;確保所有依賴項已安裝;查閱 Remotion 文件
時間點感覺不對在清單中調整每個畫面的持續時間;在 Remotion Studio 中預覽;與實際使用者一起測試

最佳實務

  1. 維持長寬比:使用實際的 Stitch 畫面尺寸或按比例縮放
  2. 一致的時間點:除非要特別強調某個畫面,否則保持畫面顯示時間一致
  3. 可讀的文字:確保足夠的對比度;使用適當的字型大小;避免雜亂的疊加
  4. 流暢的轉場:使用 spring 動畫以獲得自然動態;避免生硬的剪接
  5. 徹底預覽:在最終渲染之前,務必在 Remotion Studio 中預覽
  6. 最佳化素材:適當壓縮圖片;使用高效的格式(UI 使用 PNG,照片使用 JPG)

使用範例

使用者提示:

查詢我的 Stitch 專案「計算機應用程式」中的畫面,並建立一個 Remotion 影片來展示這些畫面的導覽。

代理工作流程:

  1. 列出 Stitch 專案 → 找到「計算機應用程式」 → 提取專案 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 20 individual skills — each has its own dedicated page.

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

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

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

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

JantonioFC/skillsbank

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

JantonioFC/skillsbank

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.

JantonioFC/skillsbank

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

JantonioFC/skillsbank

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

JantonioFC/skillsbank

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

Next.js 16+ and Turbopack — incremental bundling, FS caching, dev speed, and when to use Turbopack vs webpack.

JantonioFC/skillsbank

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

相關技能