Communitygithub.com

MattiaIppoliti/tia-skills

専用ワークフローがない場合に、カスタムHyperFramesコンポジションを作成または編集します。長尺やマルチシーン作品、ブランドリール、モンタージュ、静止ループ、タイトルカード、フッテージリミックス、自由形式の構築に使用します。

tia-skills とは?

このスキルは、HyperFramesフレームワーク向けの汎用ビデオ制作ワークフローを提供します。専用のワークフローが存在しない状況で、長尺のマルチシーン作品、ブランドやセールスリール、モンタージュ、静止ループ、タイトルカード、フッテージリミックス、自由形式のビルドなど、あらゆる種類のビデオコンポジションを作成または編集するためのものです。 このスキルは、プロジェクトの状態管理(新規作成、既存BRIEF.mdからの再開、特定編集の適用)、メディアソースやFigmaデザインなどのクロスカッティングアダプターの適用、そして「companion」フロー(ユーザーと協調して作成)または「automation」フロー(自律的に実行)のいずれかをサポートします。ワークフローは、計画、スケッチ、構築、検証、プレビュー、レンダリング承認の各段階を依存関係に従って実行します。 重要なのは、このスキルは現在、廃止されたHTML + data-* + GSAPパイプラインを記述しており、新しいRemotion + Reactベースの`/hyperframes-core`への移行が保留中であることです。そのため、古いCLIコマンドやマークアップを直接使用せず、代わりにストーリー構成やカットのリズム、ビジュアルデザインなどのフレームワーク非依存のクラフトを活用し、最終的な出力はRemotionの`<Composition>`、`<Sequence>`、`useCurrentFrame()`を使用して表現する必要があります。 このスキルは、Claude CodeやCline、GitHub CopilotなどのAIエージェント向けに設計されており、開発者がHyperFramesプロジェクト内でビデオコンポジションを効率的に作成・編集できるよう支援します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/general-video

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

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

ドキュメント

⚠ 契約ステータス:Remotionにまだ移植されていません

このスタックの出力フレームワークは Remotion + React(/hyperframes-core)です。 このスキルは、廃止された HTML + data-* + 一時停止GSAPタイムライン パイプラインをまだ説明しており、 そのバンドルスクリプトはその契約で index.html を出力し続けています。

移植が完了するまで:

  • 実行しないでください npx hyperframes <anything> — そのCLIは廃止されています。/hyperframes-cli はすべての古いコマンドを対応するRemotionコマンドにマッピングします。
  • コピーしないでください そのdata-*マークアップやGSAPタイムラインコードをRemotionプロジェクトに。
  • 実行してください そのクラフトから学び取ること:ストーリーの形状、カットのリズム、ビジュアルデザイン、 画面上に何を表示するかの決定。その部分はフレームワークに依存せず、これがこのスキルが まだここにある理由です。
  • 表現してください 結果を /hyperframes-coreの契約を通じて:<Composition>、 <Sequence>、および useCurrentFrame() から導出された値。

この回避策をとらなければならなかったことを要約に記述し、移植を完了できるようにしてください。

汎用ビデオ

このワークフローに依存する前に、以下を実行します:

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-core/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 の場合のみここに戻ります。

新しいプロジェクトの場合、ブリーフからkebab-caseのディレクトリ名を選択し、ブリーフを書く前にスキャフォールディングします:

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

次に、プロジェクトルートに BRIEF.md を ../hyperframes-core/references/brief-format.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-core/references/brief-contract.md の正規の用語のみを使用します:

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

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

  • flow: automation の場合、ルートを選択し、最初の進行状況更新で1行で述べます。
  • 特定の編集の場合、新しいルートを発明せずに編集を行います。

既存のフッテージのハードカット、トリム、スプライス、または並べ替えの場合、同じビデオソースを複数のクリップ要素に複製します。各コピーで、data-media-start と data-duration でソース範囲を設定し、data-start で作成された配置/順序を設定します。個別に作成されたオーディオは、一致する <audio> 要素で同じクリップ範囲とタイミングに従います。/hyperframes-core がこの時間的編集を所有します。ズーム、パンチ、パン、クロップ、マスク、または内部ラッパーの clip-path などの視覚プロパティアニメーションには /hyperframes-keyframes のみを使用します。 完全な契約を ../hyperframes-core/references/editing-recipes.md からコピーします。

コンパニオンフロー

flow: companion の場合:

  • BRIEF.md を読み、受け入れられた ## Assets と ## Customizations をプロジェクト成果物と照合します。まだ完了していない受け入れられた作業を完了します。完了した作業はそのままにします。受け入れられた機能を新しいかのように再度提供しないでください。
  • 請負業者ではなく、監督として到着します。 コンパニオンを選んだユーザーは、関与と品質を選びました。正直な応答は、あなたが設計できる最善のバージョンであり、防御できる最小のバージョンではありません。最初の計画は天井の処理です:ストーリーアーク(最も近いジャンルレンズを借りる — メニュー § ジャンルレンズ)、デザイン仕様、各シーンのモーション処理を名前で引用(§ 5の計画規律)、トランジション、オーディオアイデンティティ — 音楽とサウンドマーク、または意図的な沈黙 — 配置されたユーザーの素材、そして設計されたオープンとクローズ。各レイヤーが何を追加するかを1行で述べます。高価なもの(レンダリング時間、サインイン、課金)を名前を付けるときにフラグを立てます。ユーザーは処理を削減します。承認ごとに組み立てる必要はありません。
  • 天井はコンセプトに属し、ツールボックスには属しません。 すべてのレイヤーはブリーフのメッセージに奉仕しなければなりません — すべてのビデオを同じようにドレスアップする処理は装飾です。クラフトは天井に上がります。コンテンツは要求されたものを超えて成長することはありません(§ 6)。
  • チェックポイント間では、../hyperframes/references/capability-menu.md は双方向に機能します。トリガーリストとして:ユーザーがその入力を言及したとき、またはビルドがそのニーズに達したときに、関連する機能を提供します。各パスのアップグレードチャネルとして:計画、スケッチ、またはビルドのチェックポイントは、ユーザーが見ている素材に向けられた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-core/references/storyboard-format.md および ../hyperframes-core/references/review-loop.md
任意のメディアアセットまたは操作(ナレーション、BGM、SFX、キャプション、グレーディング、トランスフォームを含む)/media-use; フレームワーク再生と配置のために /hyperframes-core → references/media.md も読む
マルチシーンアセンブリ../hyperframes-core/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/project-structure.md(構造)を読んでください。オープンエンドのマルチシーンブリーフの場合、/hyperframes-creative → references/prompt-expansion.md を通じてプロンプトを展開します。マルチシーン計画は各シーンの形状を引用します:/hyperframes-animation → blueprints-index.md からのブループリントID(適合する場合)、または適合しない場合に構成する名前付きルール(rules-index.md から)— モーション名はこれらのインデックスから取得され、発明されません。ストーリーの真実がどのシーンが存在するかを決定し、引用がそれらをドレスアップします。マルチシーン計画はディスパッチ成果物としても記録されます:STORYBOARD.md のシーンごとに1つの ## Frame N ブロック — status: outline、宣言された src:、ブループリント/ルールの引用、ビートテキスト — storyboard: no の場合でも。ブロックがディスパッチ単位です。ボードはレビューの表面にすぎません。
  2. リクエストに応じて計画をレビューします。 storyboard: yes の場合、これらのブロックに対して共有レビューループを実行します。storyboard: no の場合、ボードを開かずに続行します。とにかく計画の一時停止が発生した場合、

…

[翻訳のために切り捨てられました]

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

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), or automation envelopes drawn on a track's volume or any effect parameter. 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`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

関連スキル