Communitygithub.com

samyakiasonline-ctrl/hyperframe

専用ワークフローが合わない場合やBRIEF.mdにflow: companionと指定された場合に、カスタムHyperFramesコンポジションを作成・編集します。長尺・マルチシーン作品、ブランドリール、サイゼルリール、モンタージュ、静的ループ、タイトルカード、フッテージリミックス、自由形式のビルドに使用します。ショートアニメーションユニット(アニメーションテロップを含む)にはmotion-graphicsを使用してください。新規作成は、このスキルを使う前にhyperframesを経由してください。

hyperframe とは?

このスキルは、HyperFramesプラットフォーム上でカスタム動画コンポジションを作成・編集するための包括的なワークフローを提供します。主に、既存のワークフローが適さない場合や、BRIEF.mdファイルに`flow: companion`と明示された場合に使用されます。ブランドリール、モンタージュ、フッテージリミックス、タイトルカード、静的ループなど、長尺または複数シーンにわたる自由形式の作品制作を想定しており、単発のアニメーションタイトルには`motion-graphics`スキルを推奨します。 このスキルの核心は、プロジェクトの状態(新規作成、既存BRIEF.md、特定の編集依頼など)に応じて適切なアクションを自動的に選択・実行する、状態駆動型の分岐ロジックにあります。`flow: automation`モードでは自律的にルートを決定し、`flow: companion`モードではユーザーと共同制作しながら、品質を最大化する「天井治療(ceiling treatment)」を最初から提案します。 また、画像・音声・Figmaデザインなどの「ソースアダプター」を横断的に適用する段階から始まり、計画、スケッチ、検証、レンダリング、承認といった各ゲートで必要な知識ベース(`/hyperframes-core`, `/hyperframes-creative`, `/hyperframes-animation`など)を強制的に読み込む設計になっています。これにより、記憶に頼った推測や不適切なデフォルト値の記録を防ぎます。 特筆すべきは、HTMLコンポジションを基本とする映像編集方式です。カット編集は`data-media-start`と`data-duration`属性でソース範囲を指定し、エフェクトやトランジションはカタログ検索(`npx hyperframes catalog --query ...`)で発見した既存ブロックを優先して使用します。手動でのCSS/SVG実装は、カタログに適切なブロックがない場合の最終手段とされています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/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サニタイゼーション、メディアプロvenance、およびブランドトークンバインディングをスキップするため、使用しないでください。

これらのアダプターは/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チェックポイントゲートの動作brief contractに従う。モード名をユーザーに尋ねないでください。

これらの状態に対して同義語を作成しないでください。進行中の「とにかく作れ」というシグナルはインテントレイヤーによって処理され、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は双方向に機能します。トリガーリストとして: ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに関連する機能を提供します。各パスのアップグレードチャネルとして: 計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ているマテリアルを指す1つまたは2つのトレースされたオファーを運ぶことがあります(「シーン3の統計はカウントアップ処理を必要としています」)。提供する前にそれを読み、カタログ全体を一気に表示しないでください。
  • ユーザーが機能を受け入れた後、その成果物を生成し、すぐに一致するBRIEF.mdボディセクションに決定を記録してください。ユーザーが明示的に変更した場合のみ、frontmatterフィールドを書き換え、確認済みのプリファレンスを記録してください。
  • 同じストーリーボード、検証、最終プレビュー、およびレンダリング承認ゲートを維持してください。協調フローは誰が操縦するかを変更しますが、品質に必要なものを変更するわけではありません。

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、SFX、キャプション、グレーディング、トランスフォームを含む)/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スキャンライン」、「グリッチ」、「フィルムグレイン」、「シャマースイープ」、「紙吹雪の burst」 — npx hyperframes catalog --query "<その外観を平易な英語で>" --jsonを実行し、計画がその外観をどのように構築するかを指定する前に、上位の結果を読んでください。この検索には何のインストールも必要ありません: プロジェクトも、事前のaddも、アカウントも不要です。任意のディレクトリからホストされているレジストリ全体(約400ブロックとコンポーネント)をランク付けするため、ビルド中にユーザーが要求した外観にも適用されます。計画が指定したブロックはステージ3でインストールされます。検索で適合するものが何も返ってこなかった場合にのみ、外観を手動で作成してください。マルチシーンの計画は、ディスパッチ成果物としても記録されます。STORYBOARD.md内のシーンごとに1つの## Frame Nブロック — status: outline、宣言されたsrc:、ブループリント/ルールの引用、そして`target-dur

…

[翻訳のため省略]

…

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

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

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.

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.

関連スキル