Communitygithub.com

laviedezidane/hyperframes-skill

HyperFrames Studioプロジェクトの共同作業時に使用します。変更リクエストの判断、新規フィルムの計画・ストーリーボード・構築、タイムラインのレイアウト規則(1キャプショントラック、1トラック1要素種別、各シーンはサブコンポジション)、セーフゾーンなどを定義します。個別の編集操作(分割、トリム、リタイム、音量、コピー、スワップ)には使用しません。

hyperframes-skill とは?

このスキルは、HyperFrames Studioを使用した動画編集プロジェクトにおいて、AIエージェントがユーザーと効果的に協力するためのルールとワークフローを定義します。主な目的は、変更リクエストの適切な解釈、プロジェクト構造の標準化、そして効率的な編集プロセスの実現です。 スキルは会話の最初に「変更か質問か」を判定することを重視し、不要な編集を防ぎます。また、全シーンをサブコンポジションとして管理し、キャプションは単一トラックに統合、各トラックには同一種類の要素のみを配置するなど、タイムラインの可読性を高める構造規則を提供します。さらに、アクションセーフ(90%)とタイトルセーフ(80%)のセーフゾーンを定義し、重要なコンテンツの配置をガイドします。 新しいフィルム作成時は、ブリーフ、方向性、ストーリーボード、構築、ノートの順で進める明確なステップに従います。このスキルは、HyperFrames CoreやHyperFrames Creativeの関連リファレンスと連携し、プラグインとしてもスタンドアロンとしても使用できます。コードやコマンドの変更は不要で、既存のHyperFramesプロジェクト構造を尊重します。

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

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

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

ドキュメント

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

HyperFrames Studioの規約

Studioはトップレベルの要素ごとにタイムラインの行を1つ描画します。以下のルールに従ったプロジェクトは短く読みやすいタイムラインとして開きます。従わないプロジェクトは、ラベルのない行の壁として開き、ユーザーは編集できません。これらは何を構築するかの規約です。クリップの変更方法については、/hyperframes-core references/creator-editing-recipes.mdに従い、同じ編集の別の形式を決して発明しないでください。

0. 構築の前に話す

ファイルを開く前にメッセージを読んでください。それが何を求めているかを判断します。

ユーザーあなた
変更を指定する(「タイトルを大きくして」「3番目のシーンをカットできる?」)実行する。
完成したフィルムについて感覚的な指摘をする(「イントロがぎこちない」「長さが足りない」)原因を見つけ、測定可能なものを変更し、指摘が何を意味し、何が動いたかを説明し、/hyperframes-creative references/storyboard-recipe.md § 4に従って記録する。
質問をし、変更を指定しない(「なぜタイトルがジャンプするの?」)答える。何も変更しない。
何も変更しない、待って、「考えているだけ」「話しましょう」と言うファイルを一切変更しない。気づいた修正も含めて。言葉で提案する。
具体的な変更なしにこのフィルムのアイデアを出す(「エンディングをもっと盛り上げたい」)変更を提案し、それを計画に追加する(下記)。コンポジションファイルは変更しない。
新しいフィルムを依頼する計画する(§ 5)。
計画を承認する(「作って」「GO」)承認されたものを構築する。

質問と変更の両方を含むメッセージには、回答と変更の両方を提供します。何かを求めているかどうか判断できない場合のみ、それは会話です。間違った回答は1メッセージのコストですみますが、間違った構築は長い実行と一連の指摘を招きます。

会話の返信:

  • 最初に、平易な言葉で、数文で回答します。
  • フィルムを変える答えになる質問のみを、それぞれに推奨回答とそのトレードオフを添えて行います(「30秒でフィードに収まる。60秒でデモの余地が残る」)。
  • 形にするアイデアがある場合: 新しいフィルムの場合は、/hyperframes references/pitch-round.mdに従った方向性。このフィルムに関するアイデアの場合は、指定された部分について2~3の選択肢を示し、1つを推奨します。
  • 次のステップとそれを開始する言葉で締めくくります(「『作って』と言ってください。始めます」)。

計画はチャットだけでなくプロジェクトに残します。次のメッセージはこのセッションを見られない新しいセッションで始まる可能性があるためです。/hyperframes-creative references/storyboard-recipe.md § 4がラウンドを記録する方法でSTORYBOARD.mdに追加します。ロックされたフレームを上書きしないでください。ユーザーが何も変更しないように依頼した場合、何も書き込まず、計画を返信に入れ、保存を提案します。

1. すべてのシーンはサブコンポジション

ルートコンポジションには、タイムドホスト、メディア、オーディオのみを保持します。ネストされた構造(子を含むdiv、サブタイトル付きタイトル、チャート)を持つシーンは、data-composition-srcで読み込まれる独自のファイルであり、/hyperframes-core references/sub-compositions.mdに配線します。

ルート内に残されたネストされたマークアップは、独自の行になりません。一部ずつトリミングや移動できない不透明な1行に隠れます。

構造リンターがすべての違反を拒否するかのように作成します。

2. 1つのキャプショントラック

  • すべてのキャプションは1つのトラックに配置します。data-track-kind="captions"とマークされた単一のサブコンポジションホスト(1つのdata-track-index)で、すべてのキャプショングループを順に保持します。
  • キャプショングループごとの1行や、キャプションを別の種類のトラックに混在させることは絶対にしません。
  • ワードタイミングルールは変更ありません。/embedded-captionsとcaption_*リントルールを参照してください。

3. トラックごとに1つの要素種別

種類ごとにグループ化することで、各行がユーザーがセットとして選択、ミュート、またはドラッグできる1つのものになります。

種類data-track-kind
ベースビデオ / Aロールvideo(タグから)
シーン、オーバーレイ、グラフィックスgraphics
キャプションcaptions
オーディオ(ナレーション、音楽、効果音)audio(タグから)

data-track-kindはサブコンポジションホストに設定します。ビデオとオーディオの種類はタグから来るため、<video>と<audio>には属性は不要です。各種類に独自のdata-track-indexを指定します。番号は表示のみで、上に何がレンダリングされるかを変更することはありません。レイヤリングにはCSSを使用します。

4. セーフゾーン

ルーラーやセーフボックスのオーバーレイはすべてプレビューペイン内に存在し、コンポジション内には決して配置しないでください。HTMLにガイド要素を追加しないでください。 両方のフレーミング(ワイドと縦)で同じ2つのセーフボックス(Premiereのデフォルト)を使用します。プレビュートグルは各エッジの中点にティックを付けて描画します。ソース: packages/studio/src/utils/previewSafeMargins.tsのACTION_SAFE_PERCENTとTITLE_SAFE_PERCENT。

ボックスフレームに占める割合各エッジからの内側オフセット
アクションセーフ90%5%
タイトルセーフ80%10%
  • セーフマージン: 表示されるすべてのものはアクションセーフボックス(90%)内に収め、キャプションとキーコンテンツはタイトルセーフボックス(80%)内に収めます。
  • 2分割および50/50レイアウトでは、各半分のコンテンツをタイトルセーフボックス内に収めます。

5. 新しいフィルム: 計画、ストーリーボード、構築

hyperframes-launchesのフィルムはこの順序で作成されました。各ステップには所有者がいます。それに従い、ここで再記述しないでください。

ステップ所有者
1. ブリーフ/hyperframes references/intent-interview.md。既存のプロジェクト内では、同じフィルムのフォローオン(新しいバージョンまたはカットダウン、同じワークフローとアスペクト比)のみが残ります。必須質問を尋ね、hyperframes initをスキップし、BRIEF.mdやSTORYBOARD.mdを上書きせず、それぞれに新しい日付セクションを追加し、その旨を返信で伝えます。異なるワークフローやアスペクト比のフィルムは新しいプロジェクトを開始し、その旨を返信で伝えます。
2. 方向性/hyperframes references/pitch-round.md
3. ストーリーボード/hyperframes-creative references/storyboard-recipe.md
4. 構築ブリーフがルーティングするワークフロー(/hyperframes § 2)とそれ自身のリファレンス
5. ノート/hyperframes references/review-loop.md

製品ローンチ用に、ローンチフィルムが追加するもの。ワークフローの選択されたアークが別のことを示す場合、アークが優先します。

  • ローンチする製品の実際の映像。 ワークフロー自体がキャプチャしない限り(URLからのサイト)、ブリーフでスクリーンレコーディングを依頼し、ラベル付きプレースホルダーでスロットを保持します。到着するまでローンチする製品のUIを近似しないでください。コンテキストとして表示されるサードパーティツール(チャットアプリ、エディター)は、キャプチャから忠実に再構築します。
  • 一つの世界。 同じウィンドウまたはキャンバスがビートを通して続きます。すべてのカットをスクラブします。持続するものはジャンプしてはいけません。
  • カーソルとスクロールされたコンテンツ。 カーソル、またはウィンドウ自体がスクロールアウトするコンテンツは、フレーム内でフェードアウトするのではなく、ウィンドウまたはフレームの端を通って出ます。要素とテキストのスワップは、ワークフローにcut-catalog.mdがある場合、それに従います。
  • コマンドまたはアドレスに近づく。 まだ動いている映像にロゴが着地します。
  • すべてのバージョンで実行時間を明記する。 ターゲットを超えて実行するかどうかはユーザーの判断であり、あなたの判断ではありません。

作業の確認

hyperframes check(リントを実行)を実行し、すべての指摘を修正します。その後、Studioでプロジェクトを開き、タイムラインにベース行、シーンホストごとの1行、1つのキャプション行、およびオーディオ行が表示されることを確認します。

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

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

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.

関連スキル