Communitygithub.com

samyakiasonline-ctrl/hyperframe

HyperFramesの必須エントリーポイント。動画、アニメーション、モーショングラフィックの作成、編集、アニメート、レンダリング、およびHyperFramesプロジェクトの検査、診断、プレビュー、公開、バッチレンダリングを行います。

hyperframe とは?

HyperFramesは、HTMLから動画をレンダリングするフレームワークであり、このスキルはそのエントリーポイントとして機能します。AIエージェント(Claude Code、Cursor、Codexなど)向けに設計されており、ユーザーのリクエストから意図を抽出し、適切なワークフローを選択して実行するための包括的な指示を提供します。 具体的には、新規作成時にはインテントインタビューを実施してBRIEF.mdを生成し、既存プロジェクトの再開時にはプロジェクト状態を読み取り、保存されたワークフローを継続します。また、Remotionからの移行、スライドショー、キャプション追加、ミュージックビデオ、PR説明動画など、様々なユースケースに対応したワークフローを備えています。 このスキルは、プロジェクトの状態管理、ワークフローのルーティング、CLIのバージョン管理、および他のHyperFramesスキル(コア、アニメーション、キーフレーム、クリエイティブなど)のオンデマンドロードを担当します。開発者は、このエントリーポイントを最初に読むことで、HyperFramesプロジェクトの全ライフサイクルを理解し、効率的に作業を進めることができます。

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

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

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

ドキュメント

プラグインのインストール: セットアップまたはfreshnessコマンドの前に、このスキルが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 プロジェクトに対する特定の操作:検査、診断、検証、プレビュー、レンダリング、公開、またはバッチレンダリングその操作のみを実行します。インテントとワークフロールーティングをスキップし、/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のテーブルを使用して1回ルーティングします。

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

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

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

スキャフォールディングされたプロジェクトは、package.json スクリプトに hyperframes@<バージョン> を固定するので、レンダリングは再現可能に保たれます。固定は自動的に進みません。古い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 <ワークフロー名>

ベア名を / なしで使用します。コマンドが失敗した場合は、エラーを表示し、メモリからワークフローを再構築しないでください。インストールに関するその他すべて(コア対遅延分割、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、スナップショット、比較、バッチレンダリング、Studio、レンダリング、公開、診断/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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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`.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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`.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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).

samyakiasonline-ctrl/hyperframe

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`.

samyakiasonline-ctrl/hyperframe

Agent Media OS, the single skill for every media need in 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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

関連スキル