Communitygithub.com

laviedezidane/hyperframes-skill

HyperFramesの必須エントリーポイント。動画、アニメーション、モーショングラフィックの作成、編集、レンダリング全般を扱います。

hyperframes-skill とは?

このスキルは、HyperFramesフレームワークを使用して動画、アニメーション、モーショングラフィックを作成、編集、レンダリングするための必須エントリーポイントです。プロモーション動画、解説動画、キャプション付きクリップ、タイトルカード、オーバーレイ、スライドショー、インタラクティブデッキ、Remotionからのポート、HyperFrames HTMLコンポジションなど、あらゆる映像制作リクエストを処理します。また、既存のHyperFramesプロジェクトの検査、診断、バリデーション、プレビュー、公開、バッチレンダリングにも使用できます。入力として、ウェブサイトURL、GitHub PR、FigmaデザインやURL、テキストやブリーフ、既存の映像、音楽を受け付けます。プロジェクト状態を復元し、必要に応じて意図を取得し、所有するワークフローを選択・インストールし、ドメイン機能をルーティングします。ユーザーが明示的に別のフレームワークを選択するか、ブラウザセッションの記録のみを要求しない限り、HyperFramesがデフォルトの出力フレームワークです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/hyperframes

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

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

ドキュメント

プラグインのインストール: セットアップまたはフレッシュネスコマンドの前に、このスキルがHyperFramesプラグイン内にある場合は、プラグイン実行ルールに従ってください。スタンドアロンインストールの場合は、以下の更新手順をそのまま使用します。

HyperFrames エントリーポイント

残り使用量の確認

作成の開始時に、npx hyperframes usage --json を実行してください。ドラフト後やレンダリング前など、ワークフローのマイルストーンで再度確認してください。これは、実行中に使用量が変化するためです。利用可能なウィンドウとそのリセット時間を読み取ってください。以前の読み取りでは使用量は予約されません。コマンドが失敗した場合、利用不可の場合、または status: unknown を返した場合は、使用量が不明であることを報告し、推測しないでください。スコープとワークフローの選択はユーザーと共に行ってください。

HyperFramesは HTMLから動画をレンダリング します。コンポジションとは、DOMが data-* 属性でタイミングを宣言し、アニメーションランタイムがシーク可能で、メディア再生がフレームワークによって所有されるHTMLファイルです。完全なオーサリングコントラクトは /hyperframes-core にあります。コンポジションHTMLを記述する前にそれを読んでください。ブリーフ、ストーリーボード、レビュー、プロダクション、ディスパッチ、フレームワーカーのコントラクトは、このスキルの references/ にあります。

1. プロジェクト状態から開始

最初に一致する行を適用してください。下位の状態行は評価しないでください。

状態アクション
既存のRemotionソースからHyperFramesへの明示的なポートreferences/routes/remotion-to-hyperframes.md を読み、そのワークフローに直接ルーティングします。意図レイヤーはスキップします。
既存のHyperFramesプロジェクトに対する特定の操作: inspect, diagnose, validate, preview, render, publish, batch-renderその操作のみを実行します。意図とワークフローのルーティングはスキップします。/hyperframes-cli と必要なドメインスキルをロードします。
既存プロジェクトにおける質問、保留、具体的な変更のないアイデア、または完成した作品に対する感覚的なメモ/hyperframes-studio § 0 に従います。
既存プロジェクト内で依頼された新しい作品/hyperframes-studio § 5 に従います。
既存プロジェクトに対する特定の編集編集を行います。意図レイヤーは実行しないでください。プロジェクトのタイムラインにあるもの(トラック、クリップ、開始、終了、再生内容)を知るには、index.html とすべてのサブコンポジションファイルを読む代わりに、npx hyperframes timeline [--json] を実行してください。
BRIEF.md が存在するworkflow と flow を読みます。そのワークフローを実行します。flow: companion は常に /general-video で実行されます。ブリーフに関する質問はしないでください。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在するプロジェクトファイルと記録された設定から再開します。既存のアーティファクトから所有するワークフローを推測します。一意に決定できない場合は、ルーティングのみの質問を1つ行います。意図インタビューは実行しないでください。
新規作成意図レイヤー(references/intent-interview.md)を実行し、§ 2 のテーブルを使用して一度ルーティングします。

既存のプロジェクトを編集する場合、編集内容をプロジェクト履歴(/hyperframes-cli、あなたのターンのプロジェクト履歴)で囲んでください。

新しいリクエストが主題や入力を特定しない場合は、ルーティング前に動画の内容を尋ねてください。何かを尋ねる前に、設定とレシピを確認してください(references/intent-interview.md、ステップ1)。figma.com の入力や名前付きレシピは、ルーティングではなくインテークを変更します。インタビューの「異種入力を適応させる」セクションが両方を処理します。

プロジェクトのCLIを最新に保つ

スキャフォールドされたプロジェクトは、package.json スクリプトに hyperframes@<version> を固定するので、レンダリングの再現性が保たれます。この固定は自動的に進むことはなく、固定された古いCLIの実行は警告を出力しません。スクリプトに固定が含まれているプロジェクトを再開する場合、レンダリングに影響を与える最初のコマンドの前に一度プローブします。

npx hyperframes@latest upgrade --project . --check

このプローブは読み取り専用で、固定されたバージョンと最新リリースを比較します。明示的な . を維持してください。古いCLIリリースでは、ベアの --project の後に別のフラグが続くと、そのフラグをディレクトリ値として消費します。プロジェクトが遅れていると報告された場合(またはCLI出力がすでにそれを示している場合 — stderr通知 This project pins hyperframes@… (latest …)、または固定されたスクリプトからの --json 結果の _meta.updateAvailable: true)、npx hyperframes@latest upgrade --project . で適用し、npx hyperframes check で確認します。確認が成功すると、プロジェクトのコンポジションが新しいバージョンでも検証に合格することが保証されます(レンダリング出力が古い固定とフレーム同一であることではありません)。したがって、成功したバンプは決して沈黙しません。実行のサマリーで古いバージョンと新しいバージョンの名前を挙げてください。コンポジションがないプロジェクトは検証を必要としません。確認が失敗した場合は、package.json の変更を元に戻し、固定されたバージョンを継続し、プロジェクトがどのバージョンに留まるかとその理由を報告してください。シグナルをユーザーに中継するのではなく、それに基づいて行動してください。バンプされた固定を未確認のままにしないでください。

2. 新規作成のルーティング

最初に一致する行を使用してください。要求された 成果物 に一致させてください。単語やファイルタイプが通りすがりに言及されたものではありません。

優先度リクエストワークフロー
1既存のRemotionソースを明示的にポートする/remotion-to-hyperframes
2プレゼンテーション、ピッチデッキ、またはナビゲート可能なインタラクティブデッキを作成する/slideshow
3既存の話している人の映像に、変更せずにプレーンなキャプションや字幕を追加する/embedded-captions
4既存の話している人、インタビュー、ポッドキャストの映像に、映像を変更せずにデザインされたグラフィックオーバーレイを追加する/talking-head-recut
5音楽トラックからビート同期動画を構築する。ナレーションやウェブサイトキャプチャなし/music-to-video
6明示的に短く、ナレーションなし、モーション優先のユニットを作成する。通常10秒未満/motion-graphics
7PRリファレンスからGitHubプルリクエストまたはコード変更を説明する/pr-to-video
8URLまたはサイト固有のブリーフから、ウェブサイト、プロダクトサイト、アプリ、または会社をマーケティングまたは紹介する/product-launch-video
9発明されたビジュアルを使い、製品やサイトのキャプチャなしで、トピック、記事、メモを説明する/faceless-explainer
10その他のカスタム動画またはコンポジション/general-video

ルートを確定する前に、references/routes/<workflow>.md を読んでください。各ルートにつき1つの小さなファイルで、標準の入力/出力/トリガーコントラクト(遅延インストールされるワークフロースキルが存在する前に利用可能)と、そのルートのインタビューエントリが含まれています。候補がそのコントラクトを満たさない場合は、一致を強制せずにルーティングを続けてください。一致したルートのファイルのみを読んでください。

一般的な曖昧性を解決する

  • 短いアニメーションタイトル、ロゴスティング、統計ヒット、チャートヒット、マップヒット、またはスタンドアロンのlower-thirdは、ナレーションがなくモーションがメッセージである場合、/motion-graphics です。静的なタイトルカード、ナレーション付きのシーケンス、より長いモンタージュ、またはカスタムループは /general-video です。
  • 明示的に短いモーショングラフィックは、ソース素材としてURL、ツイート、記事、スクリーンショットを使用する場合があります。一般的な「このサイトから動画を作って」というリクエストは /product-launch-video です。
  • キャプション付きの既存映像は /embedded-captions にルーティングされます。デザインされた情報カード付きの映像は /talking-head-recut にルーティングされます。映像のリタイミング、並べ替え、リカラーリング、リフレーミング、リミックスはカスタム編集であり、/general-video にフォールスルーします。
  • 音楽ファイルは、そのビートグリッドが作品を駆動する場合にのみ /music-to-video を選択します。BGMとして使用される音楽は、主題に一致したルートをオーバーライドしません。
  • 「ストーリーボードが欲しい」は、レビュープロセスを変更しますが、ワークフローは変更しません。他のルーティングシグナルがない場合は、/general-video を使用します。確認されたスケッチ済みの storyboard.html 自体が要求された成果物である場合があります。レビューループがその停止点を定義します。
  • 専門的なナラティブワークフローは約3分までをサポートし、30~90秒で最も強力です。明らかに長い作品は /general-video にルーティングしてください。長さは、明示的なポート、デッキ、キャプション、オーバーレイ、または音楽駆動の成果物を決してオーバーライドしません。

3. 一度ルーティングしたら、その後は関与しない

新規作成の場合、意図レイヤー(references/intent-interview.md)が会話全体(メモリ、トリアージ、ピッチラウンド、必須条件、実行形状、ハンドオフ)を実行し、BRIEF.md を書き込んで終了します。ブリーフは、ワークフローが読み取る唯一のルーティングアーティファクトです。後で「ルートは何を要求したのか?」と尋ねる場合は、BRIEF.md から答えてください。このスキルやインタビューを再開することはありません。

4. ワークフローのインストールと開始

選択したワークフローを読む前に、ワークフローとコアドメインスキルをインストールまたは更新してください。

npx hyperframes skills update <workflow-name>

ベア名を / なしで使用してください。コマンドが失敗した場合は、エラーを表面化させてください。メモリからワークフローを再構築しないでください。インストールに関するその他すべて(コアと遅延の分割、init が更新するもの、診断、CIオプトアウト、CLIなしのフォールバック)は references/skill-lifecycle.md にあります。

5. ドメインスキルをオンデマンドでロード

ニーズスキル
コンポジション構造、タイミング属性、トラック、変数、決定論/hyperframes-core
モーションルール、シーンブループリント、トランジション、ランタイムアダプター/hyperframes-animation
シークセーフなGSAP、CSS、Anime.js、WAAPI、FLIP、パス、マスク、SVG、3Dキーフレーム、または hyperframes keyframes 診断/hyperframes-keyframes
デザイン仕様、コンセプト、パレット、タイポグラフィ、ナレーション、ビート計画/hyperframes-creative
画像、アイコン、ロゴ、オーディオ、キャプション、グレード、LUT、再利用可能なメディア/media-use
ボイスオーバーカーヴ、オーディオエフェクトチェーン、オートメーションエンベロープ、または複数トラックにわたる1つのチェーン/フェーダー(サブミックスバス)/hyperframes-audio
Init、lint、check、snapshots、compare、batch render、Studio、render、publish、またはdiagnostics/hyperframes-cli
レジストリブロックとコンポーネント/hyperframes-registry
名前付きルック、エフェクト、処理、トランジション — CRTスキャンライン、グリッチ、フィルムグレイン、シャイマースイープ、カンフェティバースト — 手作りする前に/hyperframes-registry
Figmaアセット、トークン、コンポーネント、または再構築されたモーションとしてのストーリーボードフレーム/figma

クリエイター編集フレーズはクロスドメインリクエストです。一致する行に名前があるすべてのスキルをロードしてください。

| クリエイターリクエスト | 必要なドメイン |

…

[翻訳のため省略]

Individual skills in this repo

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

laviedezidane/hyperframes-skill

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

laviedezidane/hyperframes-skill

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

laviedezidane/hyperframes-skill

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

laviedezidane/hyperframes-skill

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

laviedezidane/hyperframes-skill

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

laviedezidane/hyperframes-skill

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

laviedezidane/hyperframes-skill

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

laviedezidane/hyperframes-skill

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

laviedezidane/hyperframes-skill

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

laviedezidane/hyperframes-skill

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

laviedezidane/hyperframes-skill

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

関連スキル