Communitygithub.com

oyi77/1ai-skills

將任意文字——文章、筆記、主題或簡要說明——轉換成無人物解說影片,使用 HyperFrames。適用於用戶想要主題解說、概念拆解、操作指南或清單列表,且沒有特定產品或網站需要捕捉。每個場景的視覺畫面均為原創(字體排版、抽象圖形、圖表、數據視覺化)。不適用於從網站建置的影片(請改用 hyperframes-product-launch-video)。

1ai-skills 是什麼?

這個技能(Skill)專門用於建立「無人物解說影片」——以旁白驅動、沒有鏡頭前的主持人——作為 HyperFrames 的組合內容。它適合用於產品或概念解說,透過旁白與視覺畫面共同傳遞訊息。使用者提供文字腳本後,此技能會從頭開始生成最終的 MP4 影片,所有視覺元素皆為原創,無需擷取任何現有素材。支援的平台為 HyperFrames 生態系統,適用於 Claude Code、Coder、Codex 等 AI 代理工具。運作流程包括:初始化專案、撰寫簡報、選擇設計系統、規劃分鏡腳本、產出音訊(含旁白與背景音樂)、設計每個影格的視覺畫面(包括時間碼、藍圖與轉場),最後進行渲染與檢查。關鍵在於所有視覺皆為「發明」而非擷取,且影片節奏由敘事設計而非原始輸入文字的段落順序決定。驗證步驟包括確保必要檔案存在、音訊已處理、每個影格有時間碼、以及通過 lint 與 check 檢查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-faceless-explainer

在你喜歡的 AI 中提問

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

說明文件

概要

此技能用於建立無人物解說影片——以旁白驅動、無鏡頭前主持人——作為 HyperFrames 組合內容。適用於產品或概念解說,透過旁白搭配視覺畫面傳達訊息。最終會根據您提供的腳本,產出 MP4 格式影片。

HyperFrames — 無人物解說

將任意文字轉換為解說影片:選擇設計系統、規劃教學故事,然後逐格建置。無人物表示所有視覺元素均為原創——無需擷取步驟,也沒有真實資產庫。

使用時機

  • 使用者想要從文章、筆記或簡要說明中製作主題解說
  • 使用者想要概念拆解(說明某事物如何運作)
  • 使用者想要操作指南或教學(無螢幕錄製)
  • 使用者想要清單列表或動畫列表
  • 使用者想要數據驅動的解說(圖表、統計數據、比較)

不應使用時機

  • 使用者想要產品發布(請使用 hyperframes-product-launch-video)
  • 使用者想要人物訪談影片(請使用 hyperframes-embedded-captions)
  • 使用者想要動態圖形(請使用 hyperframes-motion-graphics)
  • 使用者想要擷取網站(請使用 hyperframes-product-launch-video)

工作流程

0 · 設定

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer

初始化後立即撰寫 BRIEF.md(永遠不要在初始化之前寫——init 會拒絕非空目錄)。使用以下指令記錄偏好設定:node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes .

1 · 簡報(無擷取)

將使用者的完整輸入內容逐字儲存:

  • capture/extracted/visible-text.txt — 完整的文章/筆記/主題/簡要說明
  • capture/extracted/tokens.json — { "title": "", "description": "", "colors": [], "fonts": [] }

請勿執行 npx hyperframes capture — 沒有網址。無人物視覺畫面將在後續流程中原創產生。

2 · 設計系統

選擇一個符合主題、語氣和觀眾的影格預設:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

這會將預設的 FRAME.md 複製為 frame.md,並重新混合品牌代碼。無人物解說通常沒有品牌顏色/字型 → 腳本會保留預設本身的調色盤。

3 · 分鏡腳本與旁白腳本

將文字轉換為逐格教學計劃。影片的順序來自敘事設計,而非輸入文字的段落順序——可以重新排序、合併、省略、壓縮。

撰寫 STORYBOARD.md 以及(需要旁白時)SCRIPT.md。每個影格需要:

  • focal / roles — 原創的視覺元素(主詞、圖表節點、數據視覺化序列)
  • blueprint — 鏡頭形狀(來自 hyperframes-animation/blueprints/)
  • transition_in — 影格如何進入

3.1 · 音訊

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &

預設管道語音:HeyGen 的 Marcia (女聲) / Kokoro 的 am_michael。背景音樂氛圍來自分鏡腳本的 music: 欄位。

標準靜音標記: STORYBOARD.md 頂端 YAML 區塊中設定 music: none 且沒有 SCRIPT.md = 完全無聲專案。

4 · 影格視覺設計

針對每個影格,撰寫時間碼鏡頭序列:

  • 選擇影格的藍圖(或組合)
  • 使用此影格的原創內容來實例化藍圖
  • 根據旁白安排每個場景的呈現節奏,使影格在全長度內持續發展

在每個場景中內嵌描述佈局與動畫。加入一個全影片範圍的 ## Video direction 區塊。

5 · 建置影格

等待步驟 3.1 音訊完成。然後:

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

為每個影格分派一個子代理。每個工作者會獲得:

  • _role.md(影格工作者角色)
  • 該影格的封包(精確的分鏡腳本區塊 + 藍圖主體 + 引用的規則配方,內嵌)

工作者只寫入 compositions/frames/NN-*.html。他們從不編輯 STORYBOARD.md。

全出血背景使用 class="clip" 圖層,不能使用 #root。 影格的地面就是它自己的全長背景剪輯片段。

在背景中建置字幕並組裝索引:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

6 · 最終確認

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <frame-midpoints>

僅在使用者核准後才進行渲染:

npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4

反合理化對照表

合理化行為實際情況
「我會擷取文章的網站」無人物 = 無擷取。視覺畫面是原創的,不是擷取的
「我會按照文字段落順序」敘事設計決定順序,而非來源順序
「我會跳過設計系統」frame.md 是顏色/字型/佈局的真相來源
「我會先把所有內容放好,然後凍結」依照旁白安排呈現節奏——影格在全長度內發展
「我會寫一個藍圖然後到處重用」每個影格根據內容選擇自己的藍圖
「我會跳過音訊,只用文字」音訊是時鐘——所有節拍時間都來自單詞時間戳
「我會在呈現之間加入閒置動畫」每個階段都有作用——階段性呈現、有目的的鏡頭移動、或順序 UI
「我會對齊 42% 以留出字幕空間」字幕是疊加層——對齊真正的中心(y = H/2)

驗證

  • hyperframes.json 和 BRIEF.md 已存在
  • frame.md 來自某個有名稱的預設
  • STORYBOARD.md 已存在,包含必要的敘事欄位
  • SCRIPT.md 已存在(當需要旁白時)
  • 音訊工作已啟動,或專案標記為無聲
  • 每個影格都有時間碼鏡頭序列,並根據旁白安排節奏
  • 每個影格指定了原創的 focal 和/或 roles
  • index.html 已存在
  • 字幕已建置或明確跳過
  • 渲染前已通過 lint 和 check
  • 使用者在審閱暫停時已核准

Individual skills in this repo

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

oyi77/1ai-skills

Turn a weekly changelog .md into a finished branded changelog video using HyperFrames. Use when the user provides a changelog/digest markdown and wants the weekly video, or says 'changelog video'. Self-contained — fonts, background, lexicon, and scripts ship in the skill. Produces square 1080, ~45-60s videos with animated brand mock-UIs.

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

相關技能