Communitygithub.com

Biznomad/claude-skills

HyperFrames HTMLを使用して、ビデオコンポジション、アニメーション、タイトルカード、オーバーレイ、キャプション、ナレーション、オーディオ反応型ビジュアル、シーントランジションを作成します。

claude-skills とは?

このスキルは、HyperFramesフレームワークを使用してHTMLベースのビデオコンテンツを作成するための包括的なガイドです。開発者は、HTML、CSS、GSAPアニメーションを使用して、プロフェッショナルなビデオコンポジションをコードベースで構築できます。主な機能には、data-*属性によるタイミング管理、オーディオ同期キャプション、テキスト読み上げナレーション、ビート同期アニメーション、シーントランジション(クロスフェード、ワイプ、リビールなど)が含まれます。また、デザインシステムの確立からプロンプト拡張、レイアウト設計、アニメーション実装までの段階的なワークフローを提供し、`npx hyperframes` CLIツールと連携してプレビューやレンダリングを行います。変数を使用したパラメータ化されたコンポジションもサポートしており、同じテンプレートから異なるコンテンツを生成できます。

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

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

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

ドキュメント

HyperFrames

HTMLはビデオの信頼できる情報源です。コンポジションは、タイミング用のdata-*属性、アニメーション用のGSAPタイムライン、外観用のCSSを持つHTMLファイルです。フレームワークは、クリップの可視性、メディア再生、タイムライン同期を処理します。

アプローチ

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

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

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

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

探索的なリクエストの場合、意味のある違いがある2~3のバリエーションを検討します。単なる色の変更ではなく、異なるペース、エネルギー、または構造的アプローチです。安全で予想されるもの1つ、野心的なもの1つ。これを必須にしないでください。適切な場合に利用可能なツールです。

ステップ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いいえ宣言された変数(id/type/label/default)のJSON配列 — 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"
  data-variable-values='{"title":"Enterprise","price":"お問い合わせ"}'
></div>

Individual skills in this repo

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

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

関連スキル