Communitygithub.com

CleanExpo/Pi-Dev-Ops

/remotion-video ワンショットRemotionコマンドスキル。Remotionスキルパッケージのエントリポイント。動画、解説、広告、プロモ、リール、イントロ、ソーシャルカット、マーケティング、トレーニング、ローンチ動画に使用。ブリーフを読み取り、意図を分類し、単一のSynthex ElevenLabs音声を強制し、プロダクション/ウェーブ計画を生成し、トポロジカル順序で適切なサブスキルをディスパッチします。常に最初に呼び出されます。

Pi-Dev-Ops とは?

このスキルは、Remotionスキルパッケージのエントリポイントとなる「remotion-orchestrator」です。1つのコマンド `/remotion-video` で、簡易的なブリーフから構造化されたプロダクションパケット、レンダリングパス、最終的なエビデンスレポートを生成します。主な機能は、ブリーフの必須フィールド(ブランド、コンポジションタイプ、チャンネル、アスペクト比、尺、トピック、オーディエンス)を検証する「ディスカバリーブリーフゲート」、トポロジカル順序でサブスキル(ブランドリサーチ、デザイナー、カラーファミリー、モーション言語、スクリーンストーリーテラー、マーケティングストラテジスト、コンポジションビルダー、レンダーパイプラインなど)をディスパッチするウェーブ計画の生成、そしてLinearチケットの作成とサムネイル生成(Canvaファースト)のオーケストレーションを担います。このスキルは、単一音声の強制、新規ベンダー不使用、既存のSynthex ElevenLabs認証情報のみの利用など、厳格なルールに従って動作します。Claude Code、Cursor、CodexなどのAIエージェントと連携し、Pi-Dev-Opsプロジェクト外でもグローバルに利用可能です。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills/remotion-orchestrator

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

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

ドキュメント

remotion-orchestrator — Remotion スキルパッケージ エントリポイント

/remotion-video ワンショットコマンド

/remotion-video は、Remotion マーケティング動画用のワンショットコマンドレーンです。大まかなブリーフを、1つの管理されたプロダクションパケット、1つのレンダリングパス、そして1つの最終エビデンスレポートに変換します。

このコマンドパスのハードルール:

  • 単一音声のみ。複数音声キャストやシーンごとの音声切り替えは禁止。
  • 既存の Synthex ElevenLabs 認証情報と音声設定のみを使用。
  • 新しいベンダー、新しいアカウント、コネクタプラットフォームは使用不可。
  • オペレーターが明示的にプロダクションレンダリングを要求しない限り、ドライランで開始。
  • .harness/remotion/<jobId>/production-packet.json、script.md、preflight-report.md、render-command.sh を書き込む。
  • 生成されたMP4は絶対にコミットしない。

このコマンドは、remotion-script、remotion-production、remotion-direction、remotion-editing、remotion-integrations、remotion-professionalism を通じてルーティングされ、以下の既存のRemotionスキルパッケージワークフローを維持します。

Remotion スキルパッケージの単一エントリポイント — 10個の兄弟スキル(remotion-orchestrator、remotion-brand-research、remotion-brand-codify、remotion-designer、remotion-colour-family、remotion-motion-language、remotion-screen-storyteller、remotion-marketing-strategist、remotion-composition-builder、remotion-render-pipeline)から構成され、~/.claude/skills/remotion-* にグローバルインストールされています(~/Pi-Dev-Ops/skills/remotion-* へのシンボリックリンク)。Pi-Dev-Ops だけでなく、すべてのプロジェクトで利用可能です。

ディスカバリーブリーフゲート(ターン1、必須)

nexu-io/open-design(Apache-2.0)から採用。ウェーブ計画を出力する前に、ブリーフを確定します。必須フィールドがすべて埋められるまで処理を進めることを拒否します — 曖昧なブリーフは過度に長いウェーブ計画とブランドから外れたレンダリングを生み出します。

必須フィールド

フィールドタイプ備考
brandBrandSlugsrc/brands/ で解決できる必要があります。未知の場合は、最初に remotion-brand-research をディスパッチします。
compositionExplainer | Intro | SocialAd | NIRReport | ProductDemov1 は Explainer をサポート。その他は注意書き付きでフォールバック。
channellinkedin | youtube | instagram | tiktok | trainingアスペクト比と尺の制限を決定。
aspectRatio1920x1080 | 1080x1920 | 1080x1080channel から省略された場合はデフォルト値が使用される。
durationSec15 | 30 | 60 | 90 | 120ウェーブ数の上限を決定。
topicstring動画の内容を一文で。「ブランド認知動画」だけでは拒否 — 具体的なポイントを指定する必要あり。
audiencestring省略された場合は BrandConfig.audience.primary から継承されるが、創業者の確認が必要。

オプション: school(カラー生成器のビジュアルスクールオーバーライド)、voiceoverScript(事前作成済みの場合ストーリーテラーをスキップ)、referenceComposition(リミックス元の既存ジョブ)。

ハードストップ条件

  • topic がカテゴリ(「私たちの製品」「ローンチ」)であり、具体的な主張でない場合 → ブロック。
  • v1 で composition が Explainer 以外で、明示的なフォールバック承認がない場合 → ブロック。
  • 1つのブリーフに複数のブランドが記載されている場合 → N個の並列ジョブ(ブランドごとに1つ)に分割。決して混合しない。

ゲートは ウェーブ計画が計算される前 に実行されます。ブロックされたブリーフはディスパッチャーに到達しません。

呼び出し方

ユーザーは以下の方法でパッケージを呼び出すことができます:

  • 「Remotionスキルパッケージを使って」、「remotionパッケージ」、「remotionを使って」のいずれかを言う。
  • 個々のスキル名を指定する(例:「remotion-designerを使ってこのレイアウトをQAして」)。
  • app/server/brief.py を介して intent: "video" に分類されるブリーフを送信する。

フリーテキストのブリーフを、構造化されたレンダリングジョブと、Pi-Dev-Ops オーケストレーター(app/server/orchestrator.py)が P3-B ファンアウトでディスパッチするウェーブ計画に変換します。

Remotion プロジェクト

すべてのコンポジション、ブランド設定、モーション/カラーヘルパー、およびレンダリングエントリは、以下にあります:

../../remotion-studio/

他のプロジェクトから作業する場合、サブスキルはブランド/コンポジションファイルを読み取りまたは編集する前に、そのパスに cd します。レンダリングエントリは、remotion-studio 内から npx tsx render/render.ts ... です。

トリガー

ブリーフに以下のいずれかが含まれている場合:video、explainer、promo、ad、reel、intro、outro、cta、social cut、60s/30s/15s、render、marketing video、training video、release video、feature video。かつ、ブランド識別子 dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse のいずれかとペアになっている場合。

入力

Pi-Dev-Ops プランナー(Opus 4.7)は、このスキルを以下のパラメータで呼び出します:

  • brief — 元のフリーテキストリクエスト
  • repo_url — 通常は local:Pi-Dev-Ops/remotion-studio
  • linear_team_id、linear_project_id — config/harness/projects.json から事前解決

出力

remotion-studio/.research/wave-plans/{job_id}.json に書き込まれるウェーブ計画JSON。形状は以下の通り:

{
  "jobId": "ra-nir-explainer-2026-04-28T15-30-00",
  "brand": "ra",
  "composition": "Explainer",
  "channel": "linkedin",
  "durationSec": 60,
  "topic": "RestoreAssist NIR Phase 1 standardisation",
  "linear": { "teamId": "...", "projectId": "..." },
  "outputPath": "output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
  "waves": [
    { "id": 1, "parallel": [ {"skill":"remotion-brand-research","if":"brands/ra.ts missing or stale"}, {"skill":"remotion-marketing-strategist"} ] },
    { "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplete"}, {"skill":"remotion-motion-language","if":"motion missing"} ] },
    { "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"any new brand artifacts"}, {"skill":"remotion-designer"} ] },
    { "id": 4, "serial":   [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
  ]
}

ウェーブ数規律

  • 出力 <30秒の場合 ≤3 ウェーブ
  • 出力 ≤120秒の場合 ≤5 ウェーブ
  • 出力 >120秒の場合 ≤8 ウェーブ

過剰な分解が、これで防ぐべき障害モードです。

コンポジションルーティング(ブリーフ → コンポジションID)

ブリーフのシグナルコンポジション
"explainer", "feature video", "how it works"Explainer
"intro", "title card", "channel opener"Intro (v1.1)
"ad", "promo", "reel", "social cut", "Instagram", "TikTok"SocialAd (v1.1)
"NIR report", "inspection report", RA + "report"NIRReport (v1.1)
"demo", "product walkthrough"ProductDemo (v1.1)

v1 は Explainer のみをサポートします。その他のコンポジションIDは、"{Composition} is v1.1 — falling back to Explainer with channel-specific framing" を返します。

ブランド解決

キーワードを BrandSlug にマッチング:

  • disaster recovery, dr → dr
  • nrpg → nrpg
  • restoreassist, ra, nir → ra
  • carsi → carsi
  • ccw, carpet cleaners warehouse → ccw

ブリーフに複数のブランドが記載されている場合、プランナーに N 個の並列ジョブ(ブランドごとに1つ)に分割し、N 個のウェーブ計画を出力するよう依頼します。ブランドを1つのコンポジションに混合することは決してありません。

Linear ルーティング

レンダリングスキルがMP4を書き込んだ後、このスキル(またはレンダリングスキル)は、config/harness/projects.json からマッピングされたプロジェクトに Linear チケットを開きます:

ブランドLinear チームプロジェクト
raa8a52f07-63cf-4ece-9ad2-3e3bd3c15673 (RA)3c78358a-b558-4029-b47d-367a65beea7b
dr / nrpg43811130-ac12-47d3-9433-330320a76205 (DR)d2c1d63b-1e85-424d-9278-efff15b0d46b
carsi91b3cd04-... (GP)実行時に解決
ccw実行時実行時

サムネイル&静止画生成(Canva ファースト — 認証情報を探し回らないこと)

動画のサムネイル、ポスター、またはその他のマーケティング静止画の場合、信頼できるパスは 接続された Canva MCP です。生の画像生成APIキーではありません:

  1. generate-design(9:16の場合は design_type: your_story、16:9の場合は youtube_thumbnail)を、詳細なブランドに沿ったクエリで実行 — パレット/見出しをクエリに渡します。Canva は見出しテキストを確実にレンダリングします。
  2. 候補のプレビューをダウンロードし、最適なものを選択します。create-design-from-candidate → export-design(対象のWxHでPNG、export_quality: pro)。

ハードルール(苦労して学んだ教訓、2026-07-01):

  • 画像生成キーのために認証情報を探し回らないこと。 .env ファイルをスキャンしたり、プロジェクト/環境をまたいで GEMINI_API_KEY / OPENAI_API_KEY / AI_GATEWAY_API_KEY を探すために vercel env pull を実行したりしないでください。自動モード分類子がそれを認証情報探索としてブロックし、セッション全体を無駄にします。
  • Vercel の「機密」環境変数は書き込み専用です — vercel env pull はそれらを空で返します。プルしようとしないでください。元のソースから値を取得するか、Canva を使用してください。
  • 画像ツールが接続されておらず、1回の直接チェックでキーに到達できない場合は、停止して創業者に一度だけ尋ねてください — Canva を最初に提案します。
  • レンダリングされたMP4からのフレームグラブ(バンドルされた ffmpeg、node_modules/@remotion/compositor-*/ffmpeg にあり)がオフラインのフォールバックです。注意:macOS では、兄弟の *.dylib ファイルを cwd にシンボリックリンクして、バンドルされた ffprobe/ffmpeg が解決されるようにしてください(SIP が DYLD_* を削除するため)。

このスキルが行わないこと

  • コンポジションを作成しない — それは remotion-composition-builder の役割。
  • npx remotion render を実行しない — それは remotion-render-pipeline の役割。
  • BrandConfig ファイルを編集しない — それは remotion-brand-codify の役割。

計画と委任のみを行います。

プロジェクトごとの使用モデル

パッケージは共有インフラストラクチャです。各呼び出し元プロジェクトが、独自のランタイム設定とAPIキーを提供します。

関心事場所
スキル定義~/.claude/skills/remotion-*(シンボリックリンク → Pi-Dev-Ops/skills/remotion-*)— グローバルに利用可能。
Remotion Node プロジェクト(コンポジション、ブランド設定、レンダリングエントリ)../../remotion-studio/ — 単一の共有基盤。
ブランド設定Synthex/packages/brand-config/src/brands/{slug}.ts — ブランドごとに1つの信頼できる情報源であり、そのブランドでレンダリングするすべてのプロジェクトで使用されます。(RA-1985 / Synthex SYN-897 に従い、Pi-Dev-Ops/remotion-studio/src/brands/ から移行済み。)
APIキー(ElevenLabs、Telegram、Supabase、Linear、Remotion ライセンス)呼び出し元プロジェクトの .env / .env.local。スキルはレンダリング時に process.env を読み取ります。
レンダリングされたMP4出力デフォルトでは 呼び出し元プロジェクトの .remotion-renders/ ディレクトリ。--out= で上書き可能。

プロジェクトに新しいブランドを追加する

あなたのプロジェクト(例:Synthex)が、まだ src/brands/ にないブランドでレンダリングする必要がある場合:

  1. ブランドの公開ソースに対して remotion-brand-research を実行します。
  2. remotion-brand-codify を実行して Synthex/packages/brand-config/src/brands/{slug}.ts を生成します。
  3. Synthex/packages/brand-config/src/types.ts で BrandSlug ユニオンを拡張します。
  4. Synthex/packages/brand-config/src/brands/index.ts に登録します。
  5. Synthex/packages/brand-config/ から npm run typecheck を実行します(その後 npm run build で dist/ を再生成します)。

現在登録されているブランド:dr、nrpg、ra、carsi、ccw、synthex、unite。

Individual skills in this repo

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

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

CleanExpo/Pi-Dev-Ops

The 15+ year brand director extension of `brand-guardian` specifically for video — frame-by-frame audit of brand-mark integrity, Gun Metal `#1a1a1a` + Candy Red `#dc143c` consistency, NO AI slop, NO Lucide icons, custom geometric marks ONLY, real logos correctly placed. PASS / FAIL gate before any client-facing video ships. Use after `video-colorist` completes the grade pass.

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

CleanExpo/Pi-Dev-Ops

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

関連スキル