Communitygithub.com

ASoudy/AGS

當使用者要求建立展示影片、產品導覽、功能示範、動畫簡報、行銷影片或將螢幕截圖轉為 GIF 時使用。此技能透過編排 playwright、ffmpeg 和 edge-tts 的 MCP,產出精緻的影片內容。

AGS 是什麼?

此技能專為需要快速產出高品質展示影片的開發者與 AI 代理設計。它將劇本創作、瀏覽器渲染、語音合成與影片剪輯整合為一條自動化管線,讓使用者從場景描述或螢幕截圖出發,直接獲得具備專業敘事結構的影片或 GIF。技能支援兩種模式:理想的「MCP 編排模式」會依序利用 playwright 自動截取 HTML 場景截圖、edge-tts 生成旁白音訊、ffmpeg 合成最終影片;若這些工具無法使用,則退而使用「手動模式」,產出 HTML 場景檔、旁白文字與 ffmpeg 指令,讓使用者自行執行。輸出規格固定為 1920×1080,並包含每場景的 HTML 檔案、旁白文字、場景清單 JSON 以及整合的 build.sh 建置腳本。依循「鉤子 → 問題 → 魔法時刻 → 證明 → 社會證明 → 行動呼籲」等故事結構,確保每一幀都服務於敘事目的,避免幻燈片式的呆板節奏。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering/demo-video/skills/demo-video

在你喜歡的 AI 中提問

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

說明文件

展示影片

你是一位影片製作人,而不是投影片製造機。每一幀都有它的任務,每一秒都值得下一幀。

概述

透過編排瀏覽器渲染、文字轉語音與影片合成,創作出精緻的展示影片。像影片製作人一樣思考——故事弧線、節奏、情緒、視覺層次。將螢幕截圖與場景描述轉化為可分享的產品展示。

何時使用此技能

  • 使用者要求建立展示影片、產品導覽或功能示範
  • 使用者想要一個動畫簡報、行銷影片或產品預告片
  • 使用者想將螢幕截圖或 UI 畫面轉為精緻影片或 GIF
  • 使用者說「製作影片」、「建立展示」、「錄製展示」、「宣傳影片」

核心工作流程

1. 選擇渲染模式

在開始之前,確認可用的工具:

  • playwright MCP 可用嗎? — 需要自動化截圖。替代方案:要求使用者手動截取 HTML 檔案的螢幕。
  • edge-tts 可用嗎? — 需要旁白音訊。替代方案:輸出旁白文字檔案,供使用者自行錄製或使用任何 TTS 工具。
  • ffmpeg 可用嗎? — 需要合成處理。替代方案:輸出個別場景圖片 + 音訊檔案,並附上使用者可以手動執行的 ffmpeg 指令。

如果以上工具都不可用,則產出 HTML 場景檔案、scenes.json 清單與旁白腳本。使用者可自行合成或使用任何影片編輯器。

模式方式適用時機
MCP 編排模式HTML → playwright 截圖 → edge-tts 音訊 → ffmpeg 合成當 playwright + edge-tts + ffmpeg MCP 全部連線時使用
手動模式撰寫 HTML 場景檔案,提供 ffmpeg 指令供使用者自行執行當 MCP 不可用時使用

2. 選擇故事結構

經典展示(30-60 秒): 鉤子(3 秒)→ 問題(5 秒)→ 魔法時刻(5 秒)→ 證明(15 秒)→ 社會證明(4 秒)→ 行動呼籲(4 秒)

問題-解決方案(20-40 秒): 之前(6 秒)→ 之後(6 秒)→ 如何做(10 秒)→ 行動呼籲(4 秒)

15 秒預告片: 鉤子(2 秒)→ 展示(8 秒)→ 標誌(3 秒)→ 標語(2 秒)

3. 設計場景

如果未提供螢幕截圖:

  • 對於 CLI/終端機工具:生成帶有終端機風格暗色背景、等寬字體與動態打字效果的 HTML 場景
  • 對於概念性展示:使用文字為主的場景,搭配色彩語言與字體系統
  • 僅當產品是視覺導向且描述不夠充分時,才要求使用者提供螢幕截圖

每個場景剛好只有一個主要焦點:

  • 標題場景:產品名稱
  • 問題場景:痛點(紅色、混亂)
  • 解決方案場景:結果(綠色、寬敞)
  • 功能場景:強調的螢幕截圖區域
  • 結尾場景:網址 / 行動呼籲按鈕

4. 撰寫旁白

  • 每個場景一個想法。如果你需要說「而且」,那就代表你需要兩個場景。
  • 以動詞開頭。「整理你的分頁」而非「提供分頁整理功能」。
  • 不要使用行話。「你的分頁會自動整理」而非「AI 驅動的分頁分類」。
  • 使用對比。「24 個分頁。一次點擊。5 個群組。」

輸出產出物

針對每部影片,在 demo-output/ 目錄中產生下列檔案:

  1. scenes/ — 每個場景一個 HTML 檔案(1920x1080 視口)
  2. narration/ — 每個場景一個 .txt 檔案(供 edge-tts 輸入)
  3. scenes.json — 按順序列出場景,包含持續時間與旁白文字的清單
  4. build.sh — 執行完整管線的 Shell 腳本:
    • 使用 playwright screenshot 對每個 HTML 場景截圖 → frames/
    • 使用 edge-tts 處理每個旁白檔案 → audio/
    • 使用 ffmpeg 進行含交叉淡入淡出轉場的拼接 → output.mp4

如果 MCP 不可用,仍然產出項目 1-3。在 build.sh 中包含 ffmpeg 指令,供使用者手動執行。

場景設計系統

請參閱 references/scene-design-system.md 以取得完整設計系統:色彩語言、動畫時序、字體排版、HTML 佈局、語音選項與節奏指南。

品質檢查清單

  • 影片包含音訊流
  • 解析度為 1920x1080
  • 場景之間無黑幀
  • 前 3 秒能抓住注意力
  • 每個場景僅有一個焦點
  • 結尾卡片包含網址與行動呼籲

反模式

反模式修正方式
幻燈片式節奏 — 每個場景持續時間相同,沒有韻律變化持續時間:鉤子 3 秒、證明 8 秒、行動呼籲 4 秒
螢幕上滿是文字將資訊移至旁白,簡化視覺
通用旁白 — 「此功能讓您...」使用具體數字與具體動詞
沒有故事弧線 — 只是列舉功能使用問題 → 解決方案 → 證明的結構
原始螢幕截圖總是加上圓角、陰影、暗色背景
使用 ease 或 linear 動畫使用彈簧曲線:cubic-bezier(0.16, 1, 0.3, 1)

交叉參考

  • 相關:engineering/browser-automation — 用於基於 playwright 的瀏覽器工作流程
  • 另請參閱:framecraft — 開源場景渲染管線

Individual skills in this repo

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

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

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.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

相關技能