1仕組みと動作原理

SKILL.md 自体は単なるインデックス/ルーターとして機能し、モデルに対してトピックごとに個別の rule ファイルを参照して詳細な説明とコード例を取得するよう指示します。

skills/remotion-best-practices/SKILL.md

Read individual rule files for detailed explanations and code examples:

ここで行われていること: 段階的開示（Progressive Disclosure）を採用し、SKILL.md を極めて簡潔（44行）に保っています。

29個の rule ファイルを1つずつ一覧表示し、それぞれに1文のトピック説明を付与することで、検索可能なナレッジマップを形成しています。

skills/remotion-best-practices/SKILL.md

- [rules/animations.md](rules/animations.md) - Fundamental animation skills for Remotion

ここで行われていること: ドメイン知識を1ファイル1トピックに分割し、オンデマンドでのロードを容易にしています。

アニメーションは必ず useCurrentFrame() で駆動させ、時間は秒単位で記述した後に fps を乗算する必要があります。

skills/remotion-best-practices/rules/animations.md

All animations MUST be driven by the `useCurrentFrame()` hook.

ここで行われていること: Remotion におけるアニメーション駆動の唯一正しい基準を確立しています。

レンダリングの不具合を防ぐため、CSS transition/animation および Tailwind のアニメーションクラスは禁止されています。

skills/remotion-best-practices/rules/animations.md

CSS transitions or animations are FORBIDDEN - they will not render correctly.

ここで行われていること: フレーム単位のレンダリングモデルと競合する実装アプローチを排除しています。

アセットは public/ に配置して staticFile() で参照する必要があり、コンポーネントはレンダリング前に読み込みが完了していることを保証します。

skills/remotion-best-practices/rules/assets.md

You MUST use `staticFile()` to reference files from the `public/` folder:

ここで行われていること: アセット参照を標準化し、サブディレクトリへのデプロイ時にパスが無効化されるのを防ぎます。

メディアのメタデータ取得は Mediabunny に統一：長さ、解像度、デコード可否、フレーム抽出に対応し、ブラウザ/Node/Bun で汎用的に動作します。

skills/remotion-best-practices/rules/get-audio-duration.md

Mediabunny can extract the duration of an audio file. It works in browser, Node.js, and Bun environments.

ここで行われていること: 環境に依存しないメディア検出ソリューションを提供しています。

音声から字幕への変換には、トレードオフを持つ3つの公式アプローチ（ローカル whisper.cpp / ブラウザ WASM / OpenAI API）を提供しています。

skills/remotion-best-practices/rules/transcribe-captions.md

`@remotion/install-whisper-cpp` - Transcribe locally on a server using Whisper.cpp. Fast and free, but requires server infrastructure.

ここで行われていること: コストや環境の違いに応じて文字起こし手法を提示し、モデルが状況に応じて選択できるようにしています。

Tailwind のルールでは、まずインストールして有効化することを要求し、WebFetch を使用して公式ドキュメントを取得するようモデルに指示します。

skills/remotion-best-practices/rules/tailwind.md

Tailwind must be installed and enabled first in a Remotion project - fetch https://www.remotion.dev/docs/tailwind using WebFetch for instructions.

ここで行われていること: ルールファイル内で唯一、ホスト側に外部ドキュメントの取得を明示的に指示する項目であり、スキル自体の呼び出しではなくガイダンスとして機能します。

2コア機能

0129トピックのルールベースルーティング：3d/animations/assets/audio/... をオンデマンドでロード

02アニメーション実装仕様：useCurrentFrame 駆動、秒×fps の計時、CSS/Tailwind アニメーションの禁止

03アセットのインポート：public/ + staticFile()、画像/動画/音声/フォント、リモート URL のサポート

04字幕：.srt のインポート（@remotion/captions）、TikTok スタイルの表示、単語ごとのハイライト

05メディア検出（Mediabunny）：長さ、解像度、デコード可否、フレーム抽出

063つの音声文字起こし手法：whisper.cpp / whisper-web / openai-whisper

07トランジションとシーケンス制御：@remotion/transitions、Sequence による遅延/トリミング/時間制限

08グラフ、3D、Lottie、Tailwind などの統合トピック

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

自動ロード可能

管理者向け

ソースとバージョンの記録

判定根拠（ファイルパスと抜粋）

SKILL.md: プロンプト指示とルールテキストのみで構成され、スクリプト実行や外部への副作用はありません。

監査ノート： 判定 🟢 green：全33ファイルがマークダウンドキュメントおよび .tsx サンプルコードで構成されています。§3スキャンにおいてスクリプト実行、自己ネットワークリクエスト、認証情報読み取り、ディスク書き込みはいずれも検出されませんでした。ルール内の npx/fetch/WebFetch はドキュメント上の例示であり、実行面ではありません。

5二重目の独立検証

[ok] 文件面核对 — §1 共 33 个文件：SKILL.md + 29 个 rules/*.md + 3 个 rules/assets/*.tsx，无 .py/.sh 可执行脚本。
[ok] URL 命中性质 — §3 的 21 条 URL 全为示例（example.com / remotion.media）或官方文档（remotion.dev），非技能发起的请求。
[ok] 外部程序命中性质 — §3 的 12 条命中均为规则中的 npx remotion add 安装示例，不是技能执行。
[ok] 网络请求命中性质 — §3 的 5 条 fetch 命中出现在规则代码示例里（calculate-metadata/compositions/import-srt-captions/lottie），属示例代码。
[ok] 档位判定复核 — 纯文档规则库，无执行面 → 🟢 green 成立；WebFetch 指引已写入 reason 与 injection_surface。