Communitygithub.com

MattiaIppoliti/tia-skills

Remotion CLIの開発ループを駆動します。スキャフォールド、スタジオ、型チェック、コンポジション、静止画プローブ、単一およびバッチレンダリング、バンドル、LambdaおよびCloud Runレンダリング、ベンチマーク、バージョン、アップグレード、GPUチェックを行います。ビルドやレンダリングの失敗の診断や、廃止されたHyperFrames CLIが持っていた機能を探す場合にも使用します。

tia-skills とは?

このスキルは、開発者がRemotion CLIを使用して、ビデオ生成の全開発サイクル(スキャフォールドから本番レンダリングまで)を効率的に実行できるようにします。主な特徴は、`npx remotion`コマンドを介した高速な反復ループにあり、特に`npx remotion still`による静止画プローブは、フルレンダリングに比べて数分の1の時間で検証を可能にし、問題の早期発見に役立ちます。また、`npx remotion studio`はインタラクティブなレビュー環境を提供し、Zodスキーマに基づくプロップ編集やタイムライン操作をGUIで行えます。レンダリングパフォーマンスの最適化(`--concurrency`や`--jpeg`の使用)や、`npx remotion benchmark`による実測値に基づく設定変更もサポートします。このスキルは、Remotionが動作するすべてのプラットフォーム(ローカル、Lambda、Cloud Run)で利用可能であり、一般的なレンダリング障害(デッドロック、CSSアニメーション、バージョン不一致など)の診断表も提供しています。さらに、廃止されたHyperFrames CLIの各コマンドがRemotionのどの機能に置き換わったかを明確にマッピングしており、既存のワークフローからの移行をスムーズに行えます。

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

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

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

ドキュメント

Remotion CLI

ツールは remotion、@remotion/cli から提供されます。すべてのコマンドは npx remotion <command> で実行され、それぞれが最初にプロジェクトをバンドルするため、型エラーや不正なインポートはレンダリングエラーではなくバンドルエラーとして表面化します。

npx remotion --help と npx remotion <command> --help がフラグに関する正統な情報源です。 フラグはリリース間で変更されるため、このリストを含め、あらかじめ書かれたリストを信頼するのではなく、help出力を読んでください。以下に示すのはループと障害モードであり、フラグリファレンスではありません。

ループ

段階コマンド理由
スキャフォールドnpx create-video@latest --blank適切な package.json、remotion.config.ts、tsconfig を書き出します
型チェックnpx tsc --noEmit最もコストの低いゲート。レンダリング前にスキーマ/プロップのずれをキャッチします
一覧表示npx remotion compositionsレンダリングしようとしている id が実際に存在することを確認します
フレームプローブnpx remotion still <id> out/probe.png --frame=<n>数分ではなく数秒。イテレーションの主力です
レビューnpx remotion studioユーザーに渡します。ユーザーはスクラブしてプロップを自分で編集します
レンダリングnpx remotion render <id> out/video.mp4ユーザーが承認した後にのみ実行します
リモート出荷npx remotion bundle → npx remotion lambda render <url> <id>分散レンダリング。デプロイされたAWSインフラストラクチャが必要です

レンダリング前に静止画をプローブする

45秒の1080pコンポジションのフルレンダリングには数分かかります。静止画なら数秒で済み、ほとんどの疑問に答えます:テキストがフレーム内に収まっているか、アセットがロードされたか、色は正しいか。各シーンの中間点をプローブし、すべての画像を確認してからレンダリングしてください。

npx remotion still launch out/s1.png --frame=45
npx remotion still launch out/s2.png --frame=180

バンドルが成功したという理由だけでコンポジションが動作していると報告しないでください。ピクセルを見てください。

スタジオはレビュー画面であり、デバッガではありません

npx remotion studio は、タイムライン、Zodスキーマによって駆動されるプロップエディタ、フレーム精度のスクラビングを備えたプロジェクトを提供します。承認のためにユーザーに渡してください。自身の検証には still プローブを推奨します。スクリプト化可能であり、ユーザーに見えているものを説明してもらうことなく出力を確認できます。

プロップの渡し方

--props はJSON文字列またはJSONファイルへのパスを受け取り、defaultProps を上書きします:

npx remotion render launch out/video.mp4 --props='{"productName":"Acme"}'

コンポジションのZodスキーマに失敗するプロップは、レンダリングを大きなエラーで失敗させます。これがスキーマを宣言する目的なので、正確に保ってください。

バッチレンダリング

バッチサブコマンドはありません。シェルでidまたはプロップペイロードをループさせます:

for id in $(npx remotion compositions --quiet); do
  npx remotion render "$id" "out/$id.mp4"
done

1つのコンポジションをデータセットに対して多数レンダリングする場合は、Nodeスクリプトで @remotion/renderer の renderMedia() を使用することを推奨します。1回のレンダリングにつき1回ではなく、1回だけバンドルするため、ウォールクロック時間が大幅に短縮されます。

レンダリングパフォーマンス

  • --concurrency=<n> は並列ワーカー数を設定します。デフォルトはCPUコアの半分(最大8)です。最大値はコア数であり、それ以上を指定するとエラーになります(クランプされません)。メモリが逼迫しているマシンでは、これを下げるとレンダラのバグのように見えるクラッシュを修正できます。
  • --jpeg(デフォルトのPNGフレーム形式の代わり)は、透明度を保持する必要がない場合に大幅な高速化をもたらします。
  • npx remotion benchmark は実際のレンダリングを測定するため、推測ではなく、これを利用して同時実行数やコーデックの変更を正当化してください。
  • npx remotion gpu は、ブラウザが実際にどのGPUアクセラレーションを使用するかを報告します。シェーダーや重いフィルターがレンダリングの遅延原因であると非難する前に確認する価値があります。

障害診断

症状考えられる原因
バンドルに失敗する型エラーまたは不正なインポート。 npx tsc --noEmit を実行すると、同じエラーの読みやすいバージョンが表示されます。
「id … のコンポジションが見つかりません」Root.tsx 内の id が渡したものと異なります。 npx remotion compositions で解決します。
レンダリングがハングし、その後タイムアウトする対応する continueRender() がない delayRender()。すべてのdelayハンドルは解放されなければなりません。
すべてのフレームがフレーム0のように見えるCSSアニメーション/トランジション、または requestAnimationFrame。レンダラーはブラウザのクロックを進めません。
アニメーションがフレームごとにストロボまたはちらつくシードなしの Math.random()。代わりに random(seed) を使用してください。
前方にスクラブするとモーションは機能するが、ジャンプすると壊れる状態駆動型アニメーション。代わりに useCurrentFrame() から導出してください。
Lambdaまたはバンドルレンダリングでのみアセットが404になるstaticFile() の代わりにハードコードされたパス。
意味不明なバージョンエラーRemotionパッケージの不一致。 npx remotion versions で不一致を報告します。
レンダリング中にメモリ不足になるマシンに対して同時実行数が高すぎます。 --concurrency を下げてください。

障害を報告する際は、実際のエラー出力を提示してください。スタックトレースを言い換えないでください。

廃止されたHyperFrames CLIの機能はどこへ行ったか

以前の hyperframes CLIは、RemotionのCLIにはないオーサリング、メディア、QAコマンドをバンドルしていました。以下はRemotionコマンドではないため、実行しようとしないでください:

廃止されたコマンド現在の機能の場所
initnpx create-video@latest --blank、その後 /hyperframes-core → references/project-structure.md
lint, check, layout, validatenpx tsc --noEmit と still プローブ。これらのゲートが強制していた data-* 契約はなくなりました。
snapshot, compare, grade-compare選択したフレームで npx remotion still。PNGを独自のツールで差分比較します。
preview, play, presentnpx remotion studio
add, catalog/hyperframes-registry
capture/product-launch-video(サイトキャプチャ)および /media-use
tts, transcribe, remove-background/media-use
beats, keyframes/hyperframes-creative(ビート計画)、/hyperframes-keyframes
cloud, publishnpx remotion bundle + remotion lambda / remotion cloudrun、または独自のホスティング
skills, docs, upgrade, doctorこれらのスキルはこのリポジトリにベンダリングされています。npx remotion upgrade および npx remotion versions

もしワークフロースキルやリファレンスファイルが引き続き npx hyperframes <anything> を実行するよう指示している場合、その指示は古いものです。上記の表のRemotion相当のコマンドを実行し、サマリーで古いポインタに遭遇したことを報告して修正できるようにしてください。

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

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.

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

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.

関連スキル