Communitygithub.com

pragma-sh/pragma

PragmaのRemotion起動フィルムを編集、プレビュー、検証、およびREADME用にレンダリングする際に使用します。

pragma とは?

このスキルは、PragmaのREADMEに埋め込まれたRemotion起動フィルムのメンテナンスと再現性を確保するためのものです。具体的には、`launch-video/` ディレクトリ内のソースコードとアセットを管理し、`.github/assets/pragma-launch.mp4` としてレンダリングされる動画を、リポジトリ内のソースから常に再現可能な状態に保ちます。主な機能として、Remotion Studioによるタイムライン全体のレビュー、型チェック、レンダリングをサポートしており、コマンドは `bun run video:studio`、`bun run video:typecheck`、`bun run video:render` を使用します。また、`launch-video/generate-lofi.ts` によって決定論的に生成されるサウンドトラックの管理や、`apps/www/public/media` にあるプロダクト録画の差し替えとシーン時間の調整もガイドします。このスキルは主にClaude CodeなどのAIエージェントで利用することを想定しており、コンポジションIDやシーン時間の管理など、手動では見落としがちな整合性を保つためのワークフローを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pragma-sh/pragma/tree/HEAD/skills/launch-video

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

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

ドキュメント

Pragma 起動フィルムのメンテナンス

README の起動フィルムを、リポジトリで管理されたソースとアセットから再現可能な状態に保ちます。

プロジェクト構成

  • launch-video/index.ts は Remotion のルートを登録します。
  • launch-video/Root.tsx は PragmaLaunch コンポジションを 1920x1080、30 fps で定義します。
  • launch-video/PragmaLaunch.tsx はタイムライン、シーン時間、およびプレゼンテーションを管理します。
  • remotion.config.ts は apps/www/public を Remotion のパブリックディレクトリとして使用します。クリップ、オーディオ、エージェントマークは、そのディレクトリから staticFile() を使用して解決してください。launch-video 以下にアセットを重複させないでください。
  • .github/assets/pragma-launch.mp4 はレンダリングされた README の成果物です。

コンポーネントを含む .tsx ファイルは PascalCase を使用します。コンポジション ID PragmaLaunch をルートレンダリングコマンドと一致させ、コンポジションの総時間はシーン時間から派生させてください。これにより、タイムライン編集でレジストリが古くなるのを防ぎます。

ワークフロー

リポジトリルートからコマンドを実行します:

bun run video:studio
bun run video:typecheck
bun run video:render

Studio を使用して、シーン、タイミング、タイポグラフィ、またはアセットを変更した後は、タイムライン全体を確認してください。レンダリング前に、対象となる型チェックを実行します。レンダリングコマンドは、remotion.config.ts のコーデックと品質設定を使用して、追跡対象の README フィルムを .github/assets/pragma-launch.mp4 に書き込みます。

サウンドトラックは launch-video/generate-lofi.ts によって決定論的に生成されます。そのジェネレーターを変更する場合は、bun run video:music を実行してください。これにより、apps/www/public/media/pragma-lofi.wav が置き換えられます。無関係なビデオ編集のためにサウンドトラックを再生成しないでください。

プロダクト録画は apps/www/public/media にあります。録画を交換する場合は、Studio でその再生を完全に確認し、PragmaLaunch.tsx の対応するシーン時間を更新して、途切れたり、フリーズしたテールが続かないようにしてください。最後に、変更したすべてのソースファイルに対して、リポジトリの通常のフォーマットおよび品質チェックを実行してください。

関連スキル