Communitygithub.com

CambridgeMonorail/WallRun

WallRun 用の Remotion デモ動画を Nx モノレポ内の demos ディレクトリで構築・編集するためのスキルです。

WallRun とは?

このスキルは、Nx モノレポ構造内で Remotion を使用して WallRun の開発者向け説明動画を構築・保守するためのものです。動画は demos/wallrun-video ディレクトリに配置され、シーン作成、コンポジション構造、再利用可能なモーションコンポーネント、ビデオのペーシング、開発者向け説明のための構造を提供します。このスキルは主に Claude Code、Cursor、Codex などの AI エージェントと連携して動作し、開発者はこれを利用して新しいシーンの作成、既存の動画構造の編集、モーションプリミティブの追加を効率的に行えます。編集的なトーンを重視し、マーケティング的な表現を避け、React と TypeScript に精通したフロントエンド開発者向けに設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CambridgeMonorail/WallRun/tree/HEAD/skills/remotion-demo-video

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

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

ドキュメント

Remotion デモ動画スキル

このスキルは、以下の場所にある Remotion ビデオデモの構築と保守を支援します。

demos/wallrun-video

以下のための構造を提供します:

  • シーン作成
  • コンポジション構造
  • 再利用可能なモーションコンポーネント
  • ビデオのペーシング
  • 開発者向け説明

このスキルは、以下に取り組む際に使用します:

  • Remotion コンポジション
  • シーンコンポーネント
  • アニメーション説明セグメント
  • ビデオ構造またはシーケンス
  • デモで使用されるモーションプリミティブ

プロジェクトコンテキスト

このリポジトリは Nx モノレポ です。

Remotion ビデオは以下にあります:

demos/wallrun-video

このプロジェクトは、WallRun の 開発者向け説明動画 をレンダリングします。

対象視聴者は フロントエンド開発者 であり、マーケターではありません。

視聴者は以下を理解していると想定します:

  • React
  • TypeScript
  • コンポーネントアーキテクチャ
  • レイアウトシステム
  • 開発者ツール

基本的な JavaScript の概念は説明しないでください。


デザイン意図

ビデオは、製品広告 ではなく 開発者メディア のように感じられるべきです。

良いトーン:

  • 編集的
  • ミニマル
  • モダン
  • 自信に満ちている
  • 控えめなモーション

悪いトーン:

  • 一般的な SaaS プロモ
  • 映画のようなトレーラー効果
  • 重いパーティクルアニメーション
  • 密度の高いマーケティングコピー

優先事項:

  • 可読性
  • 階層
  • ペーシング
  • 明瞭さ

プロジェクト構造

すべてのコードは以下に配置します:

demos/wallrun-video/src

構造:

  • components/ — 再利用可能なプレゼンテーションプリミティブ
  • scenes/ — ビデオの時間指定されたセクション
  • data/ — スクリプト、コピー、タイミング定数
  • Root.tsx — コンポジションを登録
  • index.ts — Remotion CLI のエントリファイル

シーンデザインのルール

各シーンは 1つのアイデアのみ を伝える必要があります。

標準的な長さ: 4~8 秒

シーンは以下のようにします:

  • すぐに読めること
  • 大きなタイポグラフィを使用すること
  • ごちゃごちゃしないこと
  • モーションを控えめにすること

推奨されるシーンタイプ:

  • タイトルカード
  • ステージングされたリポジトリのスクリーンショット
  • コンポーネントのクローズアップ
  • コールアウトオーバーレイ
  • アーキテクチャ図
  • 統計パネル

避けるべきもの:

  • 小さな UI
  • 長い段落
  • 複雑すぎるトランジション

アニメーションガイドライン

シンプルで決定論的なアニメーションを推奨します。

例:

  • フェードイン
  • スライドアップ
  • 段階的な表示
  • 微妙なスケール

避けるべきもの:

  • バウンス効果
  • 複雑な物理モーション
  • 重いイージングカーブ

目標は 明瞭さ であり、見せかけではありません。


コーディング規約

以下を使用:

  • React 関数コンポーネント
  • TypeScript
  • 名前付きエクスポート
  • 明示的な型
  • 再利用可能なモーションラッパー

避けるべきもの:

  • 重複したアニメーションコード
  • マジックナンバー
  • ハードコードされたシーンタイミング

タイミング定数は実用的な場合に抽出します。

例:

const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;

新しいシーン作成のデフォルトワークフロー

  1. シーンのメッセージを定義する
  2. フレーム単位で長さを定義する
  3. レイアウトをブロックする
  4. プライマリモーションを追加する
  5. 明瞭さが向上する場合のみセカンダリモーションを追加する
  6. 可読性を確認する
  7. コードが再利用可能であることを確認する

Nx ターゲット

  • preview — nx preview wallrun-video で Remotion Studio を開く
  • render — nx render wallrun-video でフルビデオを dist/demos/wallrun-video/ にレンダリング
  • type-check — nx type-check wallrun-video で TypeScript コンパイラを実行

完了の定義

シーンは以下の場合に完了とします:

  • メッセージが即座に明確である
  • タイポグラフィがビデオスケールで読める
  • アニメーションが控えめである
  • タイミングが編集しやすい
  • コードがきれいに構造化されている

関連スキル