Communitygithub.com

oyi77/1ai-skills

週次のチェンジログ(.md)を、HyperFramesを使ってブランド化された完成度の高い動画に変換します。ユーザーがチェンジログやダイジェストのMarkdownを提供し、週次動画を希望した場合、または「チェンジログ動画」と発言した場合に使用します。フォント、背景、用語集、スクリプトがスキル内に含まれており、自己完結しています。1080pの正方形動画(約45~60秒)を、アニメーション化されたブランドモックUIと共に生成します。

1ai-skills とは?

このスキルは、製品アップデートの週次チェンジログ(Markdown形式)を、ブランド化されたアニメーション動画に変換します。HyperFramesのHTMLベースレンダリングを活用し、ヒーローフレーム、キーとなる箇条書きのコールアウト、背景パターンを含む、プロフェッショナルな動画を生成します。主なユースケースは、製品発表やモーショングラフィックスではなく、週次のチェンジログ動画の作成です。ワークフローは、チェンジログの解析、ビジュアライゼーションの選択(実際のUIモックを推奨)、音声スクリプト作成、HeyGen TTSによるナレーション生成、そして最終的なMP4レンダリングまでをカバーします。スキルはフォント、背景音楽、背景動画、用語集を含む資産を同梱しており、自己完結型で動作します。最終的な動画は1080x1080の正方形、45〜60秒で、キャプション表示も必須です。

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

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

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

ドキュメント

概要

このスキルは、リリースのチェンジログを、HyperFramesのHTMLベースレンダリングを使用して洗練された動画構成に変換します。製品アップデートに視覚的な発表がふさわしい場合に使用します。ヒーローフレーム、キーとなる箇条書きのコールアウト、背景パターンが含まれます。入力されたチェンジログエントリからMP4をレンダリングします。

HyperFrames — チェンジログ動画

入力: チェンジログ .md (テーマ+項目)。出力: リンター通過済み、シームゲートグリーンのHyperFramesプロジェクト。レンダリングは明示的に要求された場合のみ行います。

使用するタイミング

  • ユーザーが チェンジログ/ダイジェストMarkdown を提供し、週次動画を希望した場合
  • ユーザーが 「チェンジログ動画」 または 「週次ダイジェスト動画」 と発言した場合
  • ユーザーが アニメーション化されたモックUIとナレーションを含むブランド動画 を希望した場合

使用しないタイミング

  • ユーザーが製品ローンチ動画を希望する場合 (hyperframes-product-launch-video を使用)
  • ユーザーがモーショングラフィックスを希望する場合 (hyperframes-motion-graphics を使用)
  • ユーザーがトーキングヘッド動画を希望する場合 (hyperframes-embedded-captions を使用)

最重要原則: リスト表示するな、可視化せよ

すべてのテーマは、実際のUIまたはその忠実な類似物のアニメーションモックで表現し、UIがその変更を体験する様子を動作で示すこと。テキストの箇条書きは使用禁止。スクリプトを書く前に、すべてのテーマ/項目を必ずビジュアライゼーションレジストリ経由でルーティングしてください。

ワークフロー

0 · スキル資産からブートストラップ(必須)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

次に references/build-spec.md を最初から最後まで読んでください。ここにブランドトークンが定義されています。

1 · 解析と編集カット

  • 週の範囲、見出しの統計、テーマ、項目を抽出
  • 予算: 合計45~60秒。 タイトル 2秒以下、アウトロ 3.5秒以下、4テーマで各約9~12秒
  • テーマごとに、1つのヒーロービジュアライゼーションと最大 3つの読み上げ項目 を保持
  • テーマはストーリー順に並べる: 目玉機能 → プロダクトサーフェス → パフォーマンス → 信頼性

2 · ビジュアライゼーションルーティング

各テーマについて、ビジュアライゼーションレジストリからサーフェスを選択し、1行で記述する: テーマ → サーフェス → モックが実行する2~4の順序付けられたアクション(各アクションはスクリプトのフレーズに対応)

3 · 2層スクリプト(読み上げ用 vs 表示用)

スクリプトをトークン行として記述する: 会話調で、すべての技術用語について spoken に発音記号形を持たせ、display には標準スペルを保持。キャプションは display を表示し、VOは spoken を読み上げます。

4 · VO + 単語タイムスタンプ

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

単語タイミングは厳格なゲートです。 次に進む前に、vo-words.json が空でなく、words: [...] 配列に各単語の start/end が含まれていることを確認してください。

5 · ビルド

references/build-spec.md に正確に従ってください: ブランドトークン + フォント + アニメーション背景エンコード + シーン基盤 + クローム + キャプションレール。その後、ドクトリン順序: ベクターレジャー → シームスタンプ → VO単語上の内部ビート → シームゲート検証。

キャプションは必須です。 先に進む前に captions.json から LINES 配列を設定してください。

6 · ゲート(すべてグリーンになってから提示)

  1. hyperframes check — エラー0
  2. seam-gate.mjs verify — 失敗0
  3. プレビューサーバーを再起動し、3~4ビートをスポットチェック
  4. ユーザーが要求しない限りレンダリングしない
  5. キャプション存在確認ゲート — 3~4フレームをサンプリングし、キャプションレールが表示されていることを確認

アンチ過最適化テーブル

過最適化現実
「UI変更に箇条書きスライド」変更を動作で表現するサーフェスのモックを作成
「表現できない項目に偽のUI」正直なチェックリストシーン
「TTSテキストにプレーンな'JSON'」用語集の発音記号形を使用。表示は標準のまま
「発音を推測する」質問し、用語集を拡充する
「すべてのチェンジログ項目を読み上げる」テーマごとに3項目まで。残りはダイジェストリンクでカバー
「あらゆる場所に緑のアクセント」シーンごとに1つの緑の瞬間
「以前の動画のindex.htmlから開始」常に master-skeleton.html をコピーする
「空のLINES配列でも問題ない」空のLINES = キャプションなしの出荷 = やり直し

検証項目

  • hyperframes check がエラー0でパスする
  • seam-gate.mjs verify が失敗0でパスする
  • キャプションレールが3つ以上のサンプルフレームで表示されている
  • 単語タイムスタンプが音声と一致している
  • ブランドトークンが build-spec.md と一致している
  • レンダリングはユーザーが明示的に要求した場合のみ行う

Individual skills in this repo

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

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

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.

関連スキル