Communitygithub.com

oyi77/1ai-skills

任意のテキスト(記事、メモ、トピック、概要など)から、HyperFramesを使って顔出しなしの解説動画を生成します。ユーザーがトピック解説、コンセプトの分解、ハウツー、リスト形式の記事を求めている場合に使用します。

1ai-skills とは?

このスキル「Faceless Explainer」は、任意のテキストを、顔出し不要の解説動画に変換するHyperFramesベースのAIアシスタンスキルです。ユーザーが提供する記事、メモ、トピック概要といった文章を入力として、ナレーションとともに各シーンのビジュアルをゼロから創作します(フォント、抽象グラフィック、図、データ可視化などを組み合わせた「顔出しなし」形式)。製品やWebサイトのキャプチャは行わず、純粋にテキストから教育用の動画を組み立てる点が特徴です。主なユースケースは、トピック解説、コンセプトの分解、How-toチュートリアル、リスト形式のアニメーション、データドリブンな解説など。製品ローンチやウェブサイトキャプチャが必要な場合は他のスキル(例:hyperframes-product-launch-video)を利用します。ワークフローは、BRIEF作成→デザインシステム選定→ストーリーボード&スクリプト作成→音声生成→各フレームのビジュアル設計→フレームビルド→キャプション・インデックス組み立て→レンダリング(最終MP4出力)という流れで進行し、各フレームはタイムコード付きのショットシーケンスで構成されます。ユーザー承認後にレンダリングが実行されるため、品質保証のステップも組み込まれています。

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

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

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

ドキュメント

概要

このスキルは、顔出し不要の解説動画(ナレーションドリブン、カメラ前のプレゼンターなし)をHyperFramesのコンポジションとして構築します。ナレーションとビジュアルでメッセージを伝える製品またはコンセプトの解説に使用します。提供されたスクリプトから最終的なMP4をレンダリングします。

HyperFrames — Faceless Explainer

任意のテキストを解説動画に変換します。デザインシステムを選択し、教育ストーリーを計画し、フレームごとに構築します。Faceless とは、すべてのビジュアルが創作されることを意味し、キャプチャステップや実際のアセットインベントリはありません。

使用するタイミング

  • ユーザーが記事、メモ、概要からトピック解説を求めている場合
  • ユーザーがコンセプトの分解(何かがどのように動作するか)を求めている場合
  • ユーザーがハウツーまたはチュートリアル(画面キャプチャなし)を求めている場合
  • ユーザーがリスト形式の記事またはアニメーションリストを求めている場合
  • ユーザーがデータドリブンな解説(チャート、統計、比較)を求めている場合

使用してはならないタイミング

  • ユーザーが製品ローンチを求めている場合(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

initの直後に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 を実行しないでください — URLはありません。Facelessビジュアルは後段で創作されます。

2 · デザインシステム

トピック、トーン、オーディエンスに合ったフレームプリセットを選択します:

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

これにより、プリセットのFRAME.mdがframe.mdにコピーされ、ブランドトークンがリミックスされます。Faceless解説動画には通常、ブランドカラーやフォントがないため、スクリプトはプリセット自身のパレットを保持します。

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> &

パイプラインデフォルト音声:Marcia(女性)(HeyGen)/ am_michael(Kokoro)。BGMのムードはストーリーボードのmusic:フィールドから取得されます。

正規のサイレントマーカー: STORYBOARD.mdの先頭YAMLブロックにmusic: noneと記述し、かつSCRIPT.mdが存在しない場合、完全に無音のプロジェクトになります。

4 · フレームビジュアルデザイン

すべてのフレームについて、タイムコード付きショットシーケンスを記述します:

  • フレームのブループリントを選択する(または構成する)
  • そのフレームの創作コンテンツでブループリントをインスタンス化する
  • 各シーンの表示をナレーションに合わせてペーシングし、フレームがその全長にわたって展開されるようにする

レイアウトとモーションは、シーンごとにインラインで記述します。動画全体にわたる## Video directionブロックを1つ追加します。

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"

フレームごとに1つのサブエージェントを起動します。各ワーカーには以下が渡されます:

  • _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

防止すべき誤った考え方

誤った考え方現実
「記事のウェブサイトをキャプチャしよう」Faceless = キャプチャなし。ビジュアルは創作され、キャプチャはしない
「テキストの段落順を使用しよう」ナラティブデザインがシーケンスを決定し、ソース順ではない
「デザインシステムをスキップしよう」frame.md が色/タイポグラフィ/レイアウトの信頼できる情報源
「すべてのコンテンツを先に詰め込んでから固定しよう」ナレーションに合わせて表示をペーシング — フレームは全長にわたって展開される
「1つのブループリントを書いて使い回そう」各フレームはコンテンツに基づいて独自のブループリントを選択する
「オーディオをスキップしてテキストだけを使おう」オーディオが時計 — すべてのビートタイムは単語のタイムスタンプから得られる
「表示の間にアイドルアニメーションを追加しよう」すべてのフェーズが何かを実行 — 段階的表示、意図を持ったカメラ、またはシーケンス化された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.

関連スキル