Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

HyperFrames動画向けの非アニメーション・クリエイティブディレクション。デザイン仕様(frame.md / design.md)の処理、パレット、タイポグラフィ、ナレーション、ビート計画、オーディオリアクティブビジュアル、構図パターン、ブランド/スタイル決定に使用します。アニメーションのモーションパターンやシーンブループリントには `hyperframes-animation` を使用してください。

hyperframes-instruct とは?

このスキルは、HyperFrames プロジェクトにおいて、アニメーション以外のクリエイティブディレクションを担当します。具体的には、ブランドの一貫性、ペース配分、スタイルガイド、ナレーション、映像構図の方向性を定義します。`hyperframes-core` による技術的な下準備が完了した後に使用することを想定しており、モーションパターンやシーン遷移などのアニメーション関連は、`hyperframes-animation` スキルに委譲します。 主な機能として、フレームデザイン仕様(frame.md / design.md)の解析と適用、カラーパレットやタイポグラフィの選択、ビート単位のリズム設計、オーディオデータに基づく視覚表現、データインフォグラフィックのレイアウトなどをルーティングテーブルで定義されたリファレンス群から参照して行います。ユーザーからの曖昧な指示に対しては、`references/prompt-expansion.md` を使って構造的に拡張することも可能です。 このスキルはClaude Codeエージェント向けに設計されており、プロジェクトディレクトリ内の `frame-presets/` や `palettes/`、`references/` などのリファレンスファイルを読み込むことで動作します。また、コントラストレポートやオーディオデータ抽出などのスクリプトも同梱されています。

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

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

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

ドキュメント

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

HyperFrames Creative

ブランド、ペーシング、スタイル、ナレーション、構図の方向性を定義します。hyperframes-core からの技術的契約が整った後に使用してください。

モーションパターン、シーンブループリント、トランジション、CSSマーカーエフェクトについては hyperframes-animation を使用してください — このスキルは意図的にアニメーションを扱いません。

重要な構図には、まずこの2つを読んでください — Webの直感を上書きします:

  • references/house-style.md — 「プロンプトを解釈し、本物のコンテンツを生成する」、レイジーデフォルトリスト、背景/前景レイヤーレシピ。文字通りのスタイル変更を コンセプト に変えるものです。
  • references/video-composition.md — ビデオメディアのスケール、奥行き、前景の詳細。普遍的な要素数を強制せずに、空のWebページレイアウトを避ける方法を説明します。

これらをスキップすることは、ジェネリックでWebページのような出力を生む最大の原因です。以下のルーティングテーブルにおけるオプショナルな行ではありません — 1行の編集を超える場合は、色を選んだりHTMLを書いたりする前に、この両方を開いてください。

ワークフロー

  1. プロジェクトにデザイン仕様がある場合は、それを最初に読み、そのフロントマタートークンをブランドの真実(色、フォント、スペーシング、トーン、制約)として扱ってください。どのファイルを読むか(優先順位 frame.md → design.md → DESIGN.md)とその解析方法(フロントマター=規範、散文=コンテキスト)は references/design-spec.md で一度定義されています — そのドキュメントに従って解決してロードしてください。
  2. デザイン仕様が存在せず、ユーザーがビジュアルディレクションを求めた場合は、ルートを選択してください:
    • 既製のフレームプリセット(オプション)→ frame-presets/(FRAME.md を frame.md として採用; references/design-spec.md 参照)
    • 名前付きスタイルまたはムード → references/visual-styles.md
    • クイックデフォルト → references/house-style.md
    • インタラクティブ選択 → references/design-picker.md
  3. マルチシーン作業の場合は、HTMLを書く前にビートとリズムを計画してください → references/beat-direction.md。シーン遷移については hyperframes-animation/transitions/ にジャンプしてください。
  4. モーション重視の作業の場合は、references/motion-principles.md(高レベルのガードレール)を読み、その後 hyperframes-animation でアトミックルールを参照してください。

ルーティング

トピック読むもの
既製のフレームプリセットを frame.md として採用(オプション)frame-presets/ · references/design-spec.md
デフォルトのパレット、モーション、タイポグラフィ、レイジーデフォルトの疑問点references/house-style.md
名前付きスタイルプリセット、ムードからスタイルへのルーティングreferences/visual-styles.md
パレット固有のカラートークンpalettes/*.md
構図パターン — PiP、テキスト背景、タイトルカード、スライドショーreferences/composition-patterns.md
統計/インフォグラフィックのプレゼンテーションreferences/data-in-motion.md
オープンエンドなプロンプトの構造化された展開references/prompt-expansion.md
ビデオメディアの密度、スケール、色、フレーム構図references/video-composition.md
ビート単位の方向性、リズム計画、トランジションのタイミングreferences/beat-direction.md
作成後の仕様検証(色、タイプ、コーナー、スペーシング、奥行き)references/design-adherence.md
高レベルのモーションガードレールとGSAP品質ルールreferences/motion-principles.md
フォントの選択、組み合わせ、レンダリング動画のタイプガードレールreferences/typography.md
ストーリードクトリン — フック言語、証拠より価値、提案としてのストーリーボード、ソース追跡可能なビジュアルreferences/story-spine.md
スクリプトのペーシング、トーン、オープニング、数字の発音references/narration.md
モーションにマッピングされた事前計算済みオーディオバンドreferences/audio-reactive.md

スクリプト

  • scripts/contrast-report.mjs — レンダリングされたフレームからのコントラスト警告を検査します。
  • scripts/extract-audio-data.py — オーディオリアクティブコンポジションのためにオーディオバンドを事前抽出します。
  • scripts/package-loader.mjs — バンドルされたクリエイティブツールのサポートスクリプト。

contrast-report.mjs は最初に現在のプロジェクトからヘルパーパッケージを解決し、その後バンドルされたHyperFramesパッケージバージョンをブートストラップできます。このスキルをバンドルされたCLI/スキルインストールの外部で実行し、そのブートストラップバージョンを明示的に固定する必要がある場合にのみ、HYPERFRAMES_SKILL_PKG_VERSION=<version> を設定してください。

明示的なパスで実行してください。例:

python <SKILL_DIR>/scripts/extract-audio-data.py <audio-file>

アニメーション解析 (animation-map.mjs) は hyperframes-animation/scripts/ にあります。

境界

  • hyperframes-core の技術ルールを上書きしないでください。
  • 最小限の技術的構成にデザインシステムを要求しないでください。
  • リクエストで明示されている場合、またはまず拡張を提案しない限り、追加のシーン、ナレーション、音楽、キャプション、トランジションを追加しないでください。
  • レシピ参照はタスク固有に保ち、簡単な編集のためにすべての参照を読まないでください。

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

関連スキル