Communitygithub.com

Biznomad/agent-skills

HyperFrames HTMLを使用した動画コンポジション、アニメーション、タイトルカード、オーバーレイ、キャプション、音声合成、音声駆動型ビジュアル、シーン遷移を作成します。

agent-skills とは?

このスキルは、HyperFramesフレームワークを使用して、HTMLベースの動画コンテンツを構築するための包括的なガイドを提供します。キャプションや字幕の同期、テキスト読み上げナレーション、音楽に合わせたビート同期アニメーションやグロー効果、ハンドドローンのサークルなどのアニメーションテキストハイライト、クロスフェードやワイプなどのシーン遷移など、多様な動画制作機能をサポートします。compositionの作成、タイミング設定、メディア管理、そして動画制作ワークフロー全体をカバーしており、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで利用できます。スキルは、デザインシステムの確立、プロンプトの拡張、計画、レイアウトとアニメーションの分離といった段階的なアプローチを採用し、HTMLを動画の唯一の真実のソースとして扱います。また、パラメータ化されたコンポジションによる変数管理や、サブコンポジションの読み込み機能も提供します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/hyperframes

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

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

ドキュメント

HyperFrames

HTMLは動画の唯一の真実のソースです。コンポジションは、タイミングのためのdata-*属性、アニメーションのためのGSAPタイムライン、外観のためのCSSを持つHTMLファイルです。フレームワークがクリップの可視性、メディア再生、およびタイムライン同期を処理します。

アプローチ

発見(探索的なリクエストのみ)

ユーザーが方向性を確定していない、オープンエンドなリクエスト(「プロダクトローンチ動画を作って」「ブランド用に何か作って」など)の場合、色を選ぶ前に意図を理解します。

  • オーディエンス — 誰が見るのか? 開発者? 経営幹部? 一般消費者?
  • プラットフォーム — どこで再生されるのか? ソーシャルメディア(15秒)、ウェブサイトヒーロー、製品デモ、社内向け?
  • 優先事項 — 最も重要なものは? モーションの品質? コンテンツの正確性? ブランドの忠実性? 速度?
  • バリエーション — ユーザーはオプションを望んでいるのか、それとも単一の最良の案を望んでいるのか?

具体的なリクエスト(「タイトルカードを追加して」「シーン3のタイミングを修正して」)の場合は、発見をスキップします。

探索的なリクエストの場合、意味のある違いを持つ2〜3のバリエーションを検討します。単なる色の変更ではなく、異なるペース、エネルギーレベル、または構造的なアプローチを提供します。一つは安全/期待どおりのもの、もう一つは野心的なもの。これは必須ではありません — 適切な場合に利用できるツールです。

ステップ1: デザインシステム

プロジェクトにdesign.mdまたはDESIGN.mdが存在する場合、まずそれを読みます(両方の大文字小文字を確認してください — Linuxでは別のファイルです)。ブランドカラー、フォント、および制約のための唯一の真実のソースです。その正確な値を使用してください — 色を発明したり、フォントを代用したりしないでください。どのような形式でも機能します(YAMLフロントマター、散文、テーブル — 単に値を抽出します)。

ローカルで見つけられないフォントが指定されている場合(fonts/ディレクトリに.woff2ファイルがなく、組み込みフォントでもない場合)、HTMLを書く前にユーザーに警告します:「design.mdで[フォント名]が指定されていますが、フォントファイルが見つかりません。fonts/に.woff2ファイルを追加してください。追加がない場合は、最も近い組み込みの代替フォントにフォールバックします。」

design.mdが存在しない場合、ユーザーに選択肢を提供します。

  1. ユーザーがスタイルやムードを指定した場合? → visual-styles.mdを読み、8つの名前付きプリセットから最も近いものを選びます。
  2. 視覚的にオプションを閲覧したい場合? → デザインピッカーを実行します:references/design-picker.mdを読み、完全なワークフローを確認します。これにより、視覚的なピッカーページが提供されます。ユーザーはブラウザ上でムード、パレット、タイポグラフィ、モーションを設定し、生成されたdesign.mdをコピーして会話に貼り付けます。
  3. スキップして速く進みたい場合? → 質問:ムード、ライトまたはダーク、ブランドカラー/フォントは? その後、house-style.mdからパレットを選びます。

design.mdはブランドを定義します。動画コンポジションのルールは定義しません。 それらのルールはreferences/video-composition.mdとhouse-style.mdにあります。ブランドカラーは、Web UIの不透明度ではなく、動画に適したスケールで使用します。

ステップ2: プロンプト拡張

すべてのコンポジションで常に実行します(単一シーンの作品や些細な編集は除く)。このステップは、design.mdとhouse-style.mdに対してユーザーの意図を具体化し、すべてのダウンストリームエージェントが同じように読む一貫した中間表現を生成します。

完全なプロセスと出力形式については、references/prompt-expansion.mdを読んでください。

ステップ3: 計画

HTMLを書く前に、ハイレベルで考えます。

  1. 何を — 視聴者は何を体験すべきか? ナラティブアーク、キーモーメント、感情的なビートを特定します。
  2. 構造 — コンポジションはいくつか、どのコンポジションがサブコンポジションかインラインか、どのトラックが何を運ぶか(ビデオ、オーディオ、オーバーレイ、キャプション)。
  3. リズム — 実装前にシーンリズムを宣言します。どのシーンがクイックヒットか、どれがホールドか、シェーダーはどこに配置されるか、エネルギーがどこでピークに達するか。パターンに名前を付けます: fast-fast-SLOW-fast-SHADER-hold。リズムテンプレートについてはreferences/beat-direction.mdを読んでください。
  4. タイミング — どのクリップが期間を決定するか、トランジションはどこに配置されるか、ペースはどうか。
  5. レイアウト — まず最終状態を構築します。下記の「アニメーションの前にレイアウト」を参照してください。
  6. アニメート — 次に、以下のルールを使用してモーションを追加します。

依頼されたものを構築します。 「タイトルカード」のリクエストは、「タイトルカード + 3つのサポートシーン + 環境音楽 + キャプション」のリクエストではありません。すべてのシーン、すべての要素、すべてのトゥイーンは、その存在を正当化する必要があります。追加のシーンや要素が作品を真に向上させる場合は、提案します — 追加しません。

小さな編集(色の修正、タイミング調整、1要素の追加)の場合は、ルールに直接スキップします。

アニメーションの前にレイアウト

すべての要素を、最も見える瞬間 — 完全に入力され、正しく配置され、まだ終了していないフレーム — に配置します。これを最初に静的なHTML+CSSとして記述します。まだGSAPは使用しません。

これが重要な理由: 要素をアニメーションの開始状態(画面外、スケール0、不透明度0)に配置し、それらが最終的に配置されるべき位置に向かってトゥイーンする場合、最終的なレイアウトを推測していることになります。重なりはビデオがレンダリングされるまで見えません。まず最終状態を構築することで、モーションを追加する前にレイアウトの問題を確認して修正できます。

プロセス

  1. 各シーンのヒーローフレームを特定します — 最も多くの要素が同時に表示される瞬間。これが構築するレイアウトです。
  2. そのフレームの静的CSSを記述します。.scene-contentコンテナは、width: 100%; height: 100%; padding: Npx;、display: flex; flex-direction: column; gap: Npx; box-sizing: border-boxを使用して、シーン全体を埋める必要があります。パディングを使用してコンテンツを内側に押し込みます — コンテンツコンテナにposition: absolute; top: Npxを決して使用しないでください。絶対配置されたコンテンツコンテナは、コンテンツが残りのスペースより高い場合にオーバーフローします。position: absoluteは装飾用にのみ予約してください。
  3. gsap.from()を使用してエントランスを追加します — 画面外/非表示からCSSの位置へアニメーションします。CSSの位置が真実のソースです。トゥイーンはそこに到達するまでの経路を記述します。(data-composition-srcを介して読み込まれたサブコンポジションでは、gsap.fromTo()を優先します — references/motion-principles.mdの耐荷重GSAPルールを参照してください。)
  4. gsap.to()を使用してエグジットを追加します — CSSの位置から画面外/非表示へアニメーションします。

例

/* scene-contentがシーンを埋め、パディングがコンテンツを配置 */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* コンテナは任意のシーンサイズ(1920x1080、1080x1920など)に適合します。
   パディングがコンテンツを配置します。Flex + gapが間隔を処理します。 */

誤り — ハードコードされた寸法と絶対配置:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// ステップ3: それらの位置にアニメーション
 tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
 tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
 tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// ステップ4: それらの位置からアニメーションアウト
 tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
 tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
 tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

要素が時間とともにスペースを共有する場合

要素Aが要素Bが同じ領域に入る前に終了する場合、両方ともそれぞれのヒーローフレームに対して正しいCSS位置を持つ必要があります。タイムラインの順序により、それらが視覚的に共存することはありません — しかし、レイアウトステップをスキップすると、タイミングエラーによって誤って重なるケースを捕捉できません。

意図的な重なりと見なされるもの

レイヤードエフェクト(テキストの背後にあるグロー、シャドウ要素、背景パターン)とzスタックデザイン(カードスタック、奥行きレイヤー)は意図的です。レイアウトステップは、意図しない重なり — 2つの見出しが互いに重なる、統計がラベルを覆う、コンテンツがフレームからはみ出す — を捕捉することです。

データ属性

すべてのクリップ

属性必須値
idはい一意の識別子
data-startはい秒数またはクリップID参照 ("el-1", "intro + 2")
data-durationimg/div/コンポジションに必須秒数。動画/音声はメディアの長さがデフォルト。
data-track-indexはい整数。同じトラックのクリップは重複できません。
data-media-startいいえソースへのトリムオフセット(秒数)
data-volumeいいえ0-1(デフォルト 1)

data-track-indexは視覚的なレイヤリングに影響しません — CSS z-indexを使用してください。

コンポジションクリップ

属性必須値
data-composition-idはい一意のコンポジションID
data-startはい開始時間(ルートコンポジション:"0"を使用)
data-durationはいGSAPタイムラインの長さよりも優先
data-width / data-heightはいピクセル寸法(1920x1080 または 1080x1920)
data-composition-srcいいえ外部HTMLファイルへのパス
data-variable-valuesいいえサブコンポジションホスト上のインスタンスごとの変数オーバーライドのJSONオブジェクト

ルートの<html>要素:

属性必須値
data-composition-variablesいいえ宣言された変数のJSON配列(id/type/label/default) — Studio編集UIを駆動し、getVariables()のデフォルトを提供します

コンポジション構造

data-composition-srcを介して読み込まれるサブコンポジションは、<template>ラッパーを使用します。スタンドアロンコンポジション(メインのindex.html)は<template>を使用しません — data-composition-id divを直接<body>に配置します。スタンドアロンファイルで<template>を使用すると、すべてのコンテンツがブラウザから隠され、レンダリングが壊れます。

サブコンポジション構造:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- コンテンツ -->
    <style>
      [data-composition-id="my-comp"] {
        /* スコープ付きスタイル */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // トゥイーン...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

ルートで読み込み: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

変数(パラメータ化されたコンポジション)

ソースHTMLを編集せずに、同じコンポジションを異なるコンテンツ(タイトル、テーマカラー、価格、キャプション)でレンダリングします。

3ステップのパターン:

  1. 宣言 コンポジションの<html>ルートにdata-composition-variablesを使用して変数を宣言します。各エントリにはid、type(string、number、color、boolean、enumのいずれか)、label、defaultが必要です。列挙型エントリにはoptions: [{value, label}, ...]も必要です。
  2. 読み取り コンポジションのスクリプト内でwindow.__hyperframes.getVariables()を使用して解決された値を読み取ります。宣言されたデフォルト + インスタンスごとのオーバーライド + CLIオーバーライドのマージ結果を返します。
  3. オーバーライド レンダリング時にnpx hyperframes render --variables '{...}'(トップレベル)またはホスト要素のdata-variable-values='{...}'(サブコンポジションのインスタンスごと)でオーバーライドします。
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"タイトル","default":"こんにちは"},
  {"id":"theme","type":"enum","label":"テーマ","default":"light","options":[
    {"value":"light","label":"ライト"},
    {"value":"dark","label":"ダーク"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# 開発プレビューは宣言されたデフォルトを使用
npx hyperframes preview

# オーバーライドを使用してレンダリング
npx hyperframes render --variables '{"title":"Q4レポート","theme":"dark"}' --output q4.mp4

# またはJSONファイルから
npx hyperframes render --variables-file ./vars.json

サブコンポジションのインスタンスごとの値: 同じgetVariables()がdata-composition-srcを介して読み込まれたサブコンポジション内で動作します。各ホスト要素は独自の値を渡します:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"$29"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"

...

[翻訳のため省略]

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

関連スキル