Communitygithub.com

laviedezidane/hyperframes-skill

専門化されたワークフローが合わない場合や、BRIEF.mdで flow: companion が設定されている場合に、カスタムHyperFramesコンポジションを作成または編集します。長尺・マルチシーン作品、ブランドリール、モンタージュ、静的ループ、タイトルカード、フッテージリミックス、自由形式のビルドに使用します。

hyperframes-skill とは?

このスキルは、HyperFramesプラットフォームにおいて、既存の専門化されたワークフローでは対応できないカスタムビデオコンポジションを作成・編集するためのものです。主に長尺・マルチシーン作品、ブランドリール、モンタージュ、静的ループ、タイトルカード、フッテージリミックス、自由形式のビルドを対象とします。短いアニメーションタイトルを含むナレーションなしのモーションファーストユニットには `motion-graphics` スキルを推奨します。このスキルは、コンパニオンフロー(共同制作)とオートメーションフローの両方をサポートし、ユーザーがプロジェクトのディレクターとして関与するか、自動実行を選択できます。クリエイティブな決定を導くために、トリートメントの「天井(最高水準)」という概念を採用し、ユーザーが承認を積み重ねるのではなく、最良のバージョンからスタートできるようにします。ビルドプロセスはプラン、スケッチ、バリデーション、最終プレビュー、レンダリング承認のゲートで構成され、各段階で関連する知識を読み込むことが必須です。また、メディアアセット、Figma統合、モーションエフェクト、シーントランジションなどを扱うためのアダプターと参照資料を提供します。

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

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

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

ドキュメント

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

一般ビデオ

ワークフローが直前に読み込んだ場合を除き、最初に npx hyperframes usage --json を実行し、ドラフト後やレンダリング前などのマイルストーンで再度確認してください。利用可能なウィンドウとリセット時間を読み取ってください。使用量が不明な場合は、許可を推測せずにその旨を伝え、ユーザーとスコープおよびワークフローの選択を一緒に検討してください。

このワークフローに依存する前に、以下を実行してください:

npx hyperframes skills update general-video

成功したno-op(何も変更がないこと)は、スキルが最新であることを意味します。メモリから続行する代わりに、更新の失敗を表示してください。

1. 横断的なソースアダプターを適用する

  • メディア: オーディオ、画像、アイコン、ロゴ、音声、グレーディング、LUT、トリートメント/エフェクト、キャプション、またはメディア操作のニーズについては、/media-use をロードし、../media-use/references/resolve.md(解決、採用、再利用)および ../media-use/references/setup-providers.md(プロバイダー、認証)に従ってください。曖昧なフッテージフィードバックや名前付きスタイルには、編集前に ../media-use/references/media-treatments.md を使用してください。CSS/SVG/不透明度でサポートされているメディアエフェクトを即興で作成しないでください。最初の認証済みプロバイダーアクションの前に、npx hyperframes auth status を実行し、その出力をそのまま中継してください。サインアウトしている場合は、../hyperframes/references/brief-contract.md のゲートを適用します: 共同制作の場合はサインインまたは明示的なオフライン選択を待ちます。自律モードの場合はステータスを通知し、利用可能なオフラインプロバイダーで続行します。必要な機能を満たせるオフラインプロバイダーがない場合は、ブロッカーを表示します。ローカル採用のみでは認証ゲートは必要ありません。
  • Figma: 入力が figma.com のURLである場合は、最初に /figma を実行してください。エクスポートされたアセット、トークン、コンポーネント、またはストーリーボードフレームからビルドしてください。生のFigmaコネクター呼び出しは使用しないでください。SVGのサニタイズ、メディアの発祥、ブランドトークンのバインディングをスキップするためです。

これらのアダプターは、/hyperframes によって選択されたワークフローを変更しません。

2. プロジェクトの状態から開始する

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

状態アクション
特定の編集編集を行い、既存のプロジェクト決定を維持し、影響を受けるチェックを再実行します。発見を再開しないでください。
BRIEF.md が存在するそれを読みます。workflow が別のワークフローを指定し、flow が companion でない場合は、引き継ぎます。ブリーフの質問は行いません。
ブリーフはないが、hyperframes.json または STORYBOARD.md が存在するファイルと記録された設定から再開します。BRIEF.md は既知の事実からのみバックフィルします。
新規作成/hyperframes とそのインテントレイヤーを実行します。workflow: general-video または flow: companion の場合のみここに戻ります。

新規プロジェクトの場合は、ブリーフからケバブケースのディレクトリ名を選び、ブリーフを書く前にスキャフォールディングしてください:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

次に、../hyperframes/references/brief-format.md を使用して、プロジェクトルートに BRIEF.md を書きます。既存のプロジェクトでは、ルートは hyperframes.json を含むディレクトリです。ブリーフフォーマットで指定された、確認済みの設定に基づくフィールドのみを記録し、node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT> を使用してください。推測されたデフォルトは決して記録しないでください。ここで <MEDIA_DIR> はインストールされた /media-use スキルディレクトリ、<PROJECT_ROOT> は hyperframes.json を含むディレクトリです。インテントレイヤーがレシピを採用した場合は、今すぐ node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> で適用し、再度尋ねないでください。

3. ランシェイプ(実行形状)を解釈する

../hyperframes/references/brief-contract.md の正規の用語のみを使用してください:

フィールド意味効果
flow誰が主導するかautomation: ルートを選択して実行します。companion: 会話の中で共同制作します。
storyboardビルド前に計画、スケッチ、レビューを行うかyes: 計画とスケッチレビューを実行します(storyboard.html)。no: それなしでビルドします。
派生した modeチェックポイントゲートの動作方法ブリーフコントラクトに従います。モードの名前をユーザーに尋ねないでください。

これらの状態の同義語を作成しないでください。進行中の「とにかくビルドして」というシグナルはインテントレイヤーによって処理され、flow: automation、storyboard: no として到着します。

  • flow: automation の場合、ルートを選択し、最初の進捗更新で1行でそれを述べてください。
  • 特定の編集の場合、新しいルートを発明せずに編集を行ってください。

既存のフッテージのハードカット、トリム、スプライス、または並べ替えには、同じビデオソースを複数のクリップ要素に複製します。各コピーで、data-media-start と data-duration でソース範囲を設定し、次に data-start で作成者の配置/順序を設定します。各ビデオセグメントはそのサウンドを保持します: サウンドはクリップ上に残るため(data-has-audio="true")、ビデオをカットするとそのサウンドもカットされます。/hyperframes-core がこの時間的編集を所有します。ズーム、パンチ、パン、クロップ、マスク、または内部ラッパーの clip-path などの視覚プロパティのアニメーションには /hyperframes-keyframes のみを使用してください。../hyperframes-core/references/creator-editing-recipes.md から完全なコントラクトをコピーしてください。

コンパニオンフロー

flow: companion の場合:

  • BRIEF.md を読み、受け入れられた ## Assets および ## Customizations をプロジェクトアーティファクトと照合します。まだ保留中の受け入れられた作業を完了します。完了した作業はそのままにしておきます。受け入れられた機能を新しいかのように再度提供しないでください。
  • 請負業者ではなく、ディレクターとして立ち現れてください。 コンパニオンを選択したユーザーは、関与と品質を選択したのです。正直な応答は、あなたがデザインできる最良のバージョンであり、防御できる最小のものではありません。最初のプランは天井のトリートメントです:ストーリーアーク(最も近いジャンルのレンズを借用する — メニュー § ジャンルレンズ)、デザイン仕様、名前で引用された各シーンのモーショントリートメント(§ 5の計画規律)、トランジション、オーディオアイデンティティ — 音楽とサウンドマーク、または意図的な無音 — ユーザーの素材の配置、そしてデザインされたオープンとクローズ。各レイヤーが何を追加するかを1行で述べてください。高価なもの(レンダリング時間、サインイン、課金)に名前を付ける際にフラグを立ててください。ユーザーはトリートメントを削減します。承認ごとに組み立てる必要はありません。
  • 天井はコンセプトに属し、ツールボックスに属しません。 すべてのレイヤーはブリーフのメッセージに奉仕しなければなりません — どんなビデオも同じように飾り立てるトリートメントは装飾です。クラフトは天井にまで高まります。コンテンツは決して求められたものを超えて成長しません(§ 6)。
  • チェックポイント間では、../hyperframes/references/capability-menu.md は2つの方法で機能します。トリガーリストとして: ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに関連する機能を提供します。各パスのアップグレードチャネルとして: 計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ているマテリアルに向けられた1つか2つのトレースされたオファーを運ぶことがあります(「シーン3の統計はカウントアップトリートメントを必要としています」)。提供する前にそれを読んでください。完全なカタログをダンプしないでください。
  • ユーザーが機能を受け入れた後、そのアーティファクトを生成し、即座に一致する BRIEF.md 本文セクションに決定を記録してください。ユーザーが明示的に変更した場合にのみ、フロントマターのフィールドを書き換え、確認済みの設定を記録してください。
  • 同じストーリーボード、バリデーション、最終プレビュー、レンダリング承認のゲートを維持してください。コンパニオンは誰が操縦するかを変更しますが、品質に必要なものを変更しません。

4. 各段階の前に必要な知識をロードする

これらの読み込みは、条件が一致する場合に必須です:

条件行動前の読み込み
任意のコンポジションHTMLまたはシーンレイアウト/hyperframes-core; レイアウトコントラクトについては references/determinism-rules.md を使用
任意の非自明な作成または視覚的トリートメント/hyperframes-creative → references/house-style.md および references/video-composition.md
任意のモーション、アニメーション、またはシーントランジション/hyperframes-animation; そのルーティングに従い、一致するルール、アダプター、ブループリント、またはトランジション参照に従ってください
storyboard: yes../hyperframes/references/storyboard-format.md および ../hyperframes/references/review-loop.md
任意のメディアアセットまたは操作(ナレーション、BGM、SE、キャプション、グレーディング、トランスフォームを含む)/media-use(それらのためのホストアプリ自身の音楽および効果音ツールが優先されます); フレームワークの再生と配置については /hyperframes-core → references/variables-and-media.md も読み込んでください
マルチシーンアセンブリ../hyperframes/references/production-loop.md
flow: companion、最初の計画の前/hyperframes-creative → references/story-spine.md および references/house-style.md; 最も近いジャンルのレンズと ../hyperframes/references/capability-menu.md の全文 — 天井トリートメントはこれらからデザインされ、記憶から呼び出されるものではありません
コンパニオン機能の提供、キャプチャ、ビートグリッド、生成ビデオ、マップ、公開、またはクロスワークフロー機能../hyperframes/references/capability-menu.md
デザイン仕様が存在する場合、最終承認前/hyperframes-creative → references/design-adherence.md

これらの読み込みを記憶に置き換えないでください。プログレッシブディスクロージャーは、一致する参照が実際にロードされた場合にのみコンテキストを保存します。

5. コンポジションを実行する

この依存関係順序を使用してください。入力がない場合にのみ段階をスキップしてください。

  1. 計画。 視聴者のアーク、構造、リズム、および期間ドライバーを述べてください。短い単一シーンには1つのファイルを使用してください。3つ以上のハードシーンカットまたは再利用されるシーンにはサブコンポジションを使用してください。ナレーション付きアークについては /hyperframes-creative → references/story-spine.md を、リズムについては references/beat-direction.md を、構造については /hyperframes-core → references/composition-patterns.md を読んでください。オープンエンドのマルチシーンブリーフの場合は、/hyperframes-creative → references/prompt-expansion.md を通じてプロンプトを拡張してください。マルチシーンプランは各シーンの形状を引用します: /hyperframes-animation → blueprints-index.md からのブループリントID(適合する場合)、または適合しない場合に構成する名前付きルールを rules-index.md から — モーション名はこれらのインデックスから取得され、決して発明されません。ストーリーの真実がどのシーンが存在するかを決定します。引用がそれらをドレスアップします。名前付きのルックを自分でビルドする計画を立てる前に、ライブカタログを検索してください: ブリーフが名前を挙げるすべてのルック、エフェクト、トリートメント、またはトランジションについて — 「CRTスキャンライン」、「グリッチ」、「フィルムグレイン」、「きらめくスイープ」、「紙吹雪の爆発」 — npx hyperframes catalog --query "<ルックを平易な英語で>" --json を実行し、計画がそのルックのビルド方法を命名する前に上位の結果を読んでください。この検索にはインストールは不要です: プロジェクトも、事前の add も、アカウントも必要ありません。任意のディレクトリからホストされたレジストリ全体(約400のブロックとコンポーネント)をランク付けするため、ビルド途中でユーザーが尋ねたルックにも適用されます。計画が命名するブロックはステージ3でインストールされます。検索しても適合するものがない場合にのみ、ルックを手動で作成してください。マルチシーンプランはディスパッチアーティファクトとしても記録されます: STORYBOARD.md にシーンごとに1つの ## Frame N ブロック — status: outline、宣言された src:、ブループリント/ルールの引用、および

…

[以降のtruncated部分は省略]

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

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

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

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.

関連スキル