Communitygithub.com

oyi77/1ai-skills

HyperFrames を使用して、トーキングヘッド動画やローンチ動画にキャプション/字幕を追加します。埋め込みキャプション、逐語的なキャプションレール、被写体背後に表示されるシネマティックテキストをユーザーが求める場合に使用します。ドロップ/レール/エンベッドのキャプションモデル、オーバーレイの法則(キャプションは予約帯ではない)、埋め込みクライマックス用のマットオクルージョン、TTS出力からの単語タイムスタンプアライメントをカバーします。

1ai-skills とは?

このスキルは、HyperFrames のオーバーレイ合成を使用して、既存の動画に焼き込みキャプションを追加します。別途字幕トラックを用意せずに、アクセシブルでスタイル設定された字幕が必要なソース映像に最適です。HTML オーバーレイから決定論的にキャプション付き MP4 をレンダリングします。主にトーキングヘッド動画や製品ローンチ動画向けに設計されており、標準的な下3分の1の字幕レール、被写体背後に表示されるシネマティックな埋め込みテキスト(クライマックスビート)、アクセシビリティ向上のための焼き込み字幕など、3つの表示モード(ドロップ/レール/エンベッド)を提供します。オーバーレイの法則に従い、キャプションは映像の上に重ねて表示され、予約された領域ではないため、映像は常に真の垂直中心(y = H/2)に配置されます。ワークフローは、TTS による音声生成と単語レベルのタイムスタンプ、キャプションアライメント、HTML オーバーレイ合成で構成され、最後にキャプションの存在確認とフレームサンプリングによる検証を行います。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

概要

このスキルは、HyperFrames オーバーレイ合成を使用して、既存の動画に焼き込みキャプションを追加します。ソース映像にアクセシブルでスタイル設定された字幕が必要だが、別途字幕トラックは不要な場合に使用します。HTML オーバーレイから決定論的にキャプション付き MP4 をレンダリングします。

HyperFrames — 埋め込みキャプション

トーキングヘッド動画やローンチ動画にキャプション/字幕を追加します。キャプションモデル(ドロップ/レール/エンベッド)とオーバーレイの法則(キャプションは予約帯ではない)について説明します。

使用するタイミング

  • ユーザーがトーキングヘッド動画にキャプション/字幕を希望する場合
  • ユーザーが逐語的なキャプションレール(標準的な下3分の1表示)を希望する場合
  • ユーザーが被写体背後にシネマティックな埋め込みテキスト(クライマックスビート)を希望する場合
  • ユーザーが動画にアクセシビリティを追加したい場合
  • ユーザーがソーシャルメディア向けにキャプションを焼き込みたい場合(字幕トラック不要)

使用すべきでないタイミング

  • ユーザーが完全な動画ワークフローを希望する場合(hyperframes-product-launch-video を使用)
  • ユーザーが完全な解説動画を希望する場合(hyperframes-faceless-explainer を使用)
  • ユーザーがサイドカーファイル(SRT/VTT)としてキャプションを希望する場合 — このスキルは焼き込みます

キャプションモデル — ドロップ / レール / エンベッド

内容表示方法
ドロップフィラー — えーと、あのー、言い間違い表示しない
レールデフォルト — 通常の話し言葉の内容クリーンな下3分の1字幕、前面に表示
エンベッド強調された山場 — 見出しとなるビート被写体の背後に表示される大きな単語1つ(マットオクルージョン)

レールがほとんどのテキストを担い、エンベッドは希少で獲得された山場です — ビートあたり1つ以下、隣接は不可、ビート間は1つ以上空ける。

オーバーレイの法則

キャプション行はフィルムの上にオーバーレイとして合成されます。予約ゾーンではありません。

  • 構図を真の垂直中心に配置する(y = H/2)。キャプションのためにコンテンツを上に移動しないでください。
  • コンテンツはキャンバスの下端まで達しても構いません。
  • 重要な小さな可読テキスト(URL、法的表記)は、キャプション行が表示される下部約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 · キャプションの存在を確認

VOの発話期間全体にわたって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.

関連スキル