Communitygithub.com

oyi77/1ai-skills

使用 HyperFrames 為演講者或宣傳影片加入內嵌字幕/隱藏式字幕。適用於使用者需要內嵌字幕、逐字字幕軌,或主體後方呈現電影級文字的情況。涵蓋掉落/軌道/嵌入字幕模型、疊加層法則(字幕不是保留區域)、用於嵌入式高潮的遮罩遮擋,以及從 TTS 輸出對齊逐字時間戳。

1ai-skills 是什麼?

此技能透過 HyperFrames 疊加合成,為現有影片燒錄內嵌字幕。當原始素材需要可存取且有樣式的字幕,卻又不需要獨立字幕軌時,即可使用。它可根據 HTML 疊加層確定性地生成帶字幕的 MP4 影片。技能定義了三種字幕模型:掉落(drop,用於填充詞)、軌道(rail,用於一般口語內容,以乾淨的下三分之一方式顯示)和嵌入(embed,用於強化高潮詞,在主體後方以大字呈現並搭配遮罩遮擋)。關鍵的「疊加法則」強調字幕是疊加在影片之上,而非保留區域,因此構圖應以真正的垂直中心為準。流程包含使用 TTS 生成語音與逐字時間戳、對齊字幕,以及建立字幕軌。驗證步驟要求從語音時間範圍內取樣 3-4 個畫面,確認字幕軌確實顯示可見文字;若缺少字幕,則視為紅燈,不可發佈。此技能適用於 Claude Code 等 AI 代理工具,提供結構化的字幕嵌入方案。

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

在你喜歡的 AI 中提問

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

說明文件

概述

此技能透過 HyperFrames 疊加合成,為現有影片加入內嵌字幕。當原始素材需要可存取且有樣式的隱藏式字幕,卻又不需要獨立字幕軌時,即可使用。它會根據 HTML 疊加層確定性地生成帶字幕的 MP4 影片。

HyperFrames — 內嵌字幕

為演講者或宣傳影片加入字幕/隱藏式字幕。字幕模型(掉落/軌道/嵌入)和疊加法則(字幕不是保留區域)。

使用時機

  • 使用者想要在演講者影片上加入字幕/隱藏式字幕
  • 使用者想要逐字字幕軌(標準的下三分之一位置)
  • 使用者想要電影級嵌入文字顯示在主體後方(高潮節拍)
  • 使用者想要為影片增加可存取性
  • 使用者想要為社群媒體燒錄字幕(無需字幕軌)

不應使用時機

  • 使用者想要完整的影片工作流程(請使用 hyperframes-product-launch-video)
  • 使用者想要完整的解說影片(請使用 hyperframes-faceless-explainer)
  • 使用者想要側載字幕檔案(SRT/VTT)— 此技能為燒錄內嵌

字幕模型 — 掉落 / 軌道 / 嵌入

內容顯示方式
掉落填充詞 — 嗯、呃、結巴不顯示
軌道預設 — 一般口語內容乾淨的下三分之一字幕,顯示在前方
嵌入強化後的高潮 — 標題性節拍主體後方一個大字(遮罩遮擋)

軌道承載大部分文字;嵌入是稀有且應得的強化 — 每個節拍最多一個,永不連續相鄰,間隔至少一個節拍以上。

疊加法則

字幕行是疊加在影片之上的合成圖層;它不是保留區域。

  • 將構圖置於真正的垂直中心(y = H/2)。不要為了「騰出空間」給字幕而將內容上移。
  • 內容可以延伸到畫布底部。
  • 避免將重要的、微小的可讀文字(例如網址、法律聲明行)放在字幕行所在的底部 ~80px 中央區域。
  • 沒有機器強制保留區 — 以視覺判斷可讀性。

工作流程

1 · 生成語音 + 逐字時間戳

# 使用支援逐字時間戳的 TTS
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>

2 · 對齊字幕與顯示標記

node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

captions.json 是字幕軌的輸入(顯示拼字、口語時間)。

3 · 建立字幕軌

const LINES = /* captions.json 的內容 */ [
  { id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], ...] },
  ...
];

4 · 驗證字幕是否存在

在語音口語時間範圍內取樣 3-4 個畫面,確認字幕軌在每個畫面上都顯示了可見文字。若口語時間區間內的任何畫面缺少字幕,則表示建置結果為無字幕版本 — 將其視為紅燈。

反理性化對照表

合理化說法實際情況
「我會把中心設在 42% 以留空間給字幕」真正的中心(y = H/2)— 字幕是疊加層
「我會嵌入每個字」嵌入是稀有的 — 軌道承載大部分文字
「我會跳過逐字時間戳」音訊是時鐘 — 所有節拍時間都來自逐字時間戳
「我會在字幕中使用音標拼字」字幕永遠渲染顯示層
「我會猜發音」詢問使用者,然後擴充詞典

驗證

  • 在 3 個以上取樣畫面中確認字幕軌存在
  • 顯示拼字與稿本一致(非音標)
  • 逐字時間戳與音訊對齊
  • 構圖置於真正的中心(y = H/2)
  • 字幕疊加區域內無重要文字

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

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

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.

相關技能