Communitygithub.com

CleanExpo/Pi-Dev-Ops

トピックを入力するだけで、一貫したブランドイメージの顔出しなしマーケティング動画を1本または複数本生成します。スクリプト作成、ElevenLabs音声生成、スタイル指定されたイラスト作成、ffmpegによる1080p動画への合成、オプションでYouTube限定公開アップロードまでを自動パイプラインで実行します。

Pi-Dev-Ops とは?

このスキルは、与えられたトピックから一貫性のあるブランド顔出しなし動画を生成するための自動パイプラインを提供します。`/brand-video` コマンドで呼び出し、`styles.md` で定義されたスタイル(flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print)を選択することで、ブランドごとに再現可能なビジュアル出力を得られます。パイプラインは、スクリプト生成(問題→解決策→CTA)、ElevenLabsを使用した音声合成(タイムスタンプ付きトランスクリプト出力)、スタイルに基づいた画像生成(Gemini API使用)、ffmpegによる動画合成の4ステップで構成され、各ステップはスラッグディレクトリ内で独立して管理されます。バッチ処理により複数のトピックを並行処理可能で、音声のみの差し替えや新しいスタイルの追加も容易です。YouTube Data API v3を使用した限定公開アップロード機能もオプションで提供し、チャンネルタイトルによるガードとアップロード済み管理により冪等性を確保しています。このスキルはClaude CodeやCursorなどの開発者向けAIエージェントツールで動作し、`SKILL.md` に記述された指示に従ってエージェントが自律的に動画制作を実行します。

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

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

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

ドキュメント

brand-video — 一貫したスタイルの顔出しなし動画、オンデマンド

/brand-video として呼び出します。1つのコマンドで、複数のルックを生成。検証済みのRestoreAssist実行(9本の動画出力)に基づいて構築されています。styles.md からスタイルを選択し、その他の要素はすべて一定に保つので、出力はバッチ間、ブランド間で一貫します。

入力(不足時のみ質問; 適切に推論)

  • brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite、またはクライアント名。クレーム、CTA、音声を設定します。
  • style — styles.md のキー(デフォルト flat-line)。これが「ルック」/ ドロップダウンの値です。
  • topic(s) — 1つのアングル、またはバッチ用のリスト(それぞれ1動画、並列処理)。
  • voice — ELEVENLABS_VOICE_ID(ブランドごと; ~/.hermes/.env から取得)。重要: 生成前に現在の値を確認してください — ユーザーが変更することがあります。
  • upload? — デフォルト: レンダリング + ステージのみ。明示的に依頼があった場合のみ、YouTube限定公開にアップロードします。

パイプライン(動画ごと — それぞれスラッグフォルダを作成し、決してディレクトリを共有しない)

  1. スクリプト → <slug>/script.md: 1つのクリーンなVOパラグラフ、約120~140語、約12~16の短い文(1文 = 1ビジュアルビート = 1画像)、問題→解決策→CTA。主張はブランドWikiに基づき、機能をでっち上げないこと。ブランドのCTA行で終了。
  2. 音声 → バンドルされた tts.py を実行(ELEVENLABS_API_KEY + ELEVENLABS_VOICE_ID + DIR を読み込み): cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py <slug>/voiceover.mp3 + <slug>/transcript.json(ビート)を書き出します。ビート数を記録します。
  3. 画像 → ビートごとに1枚、プロンプト = 選択したスタイルのPOSITIVEトークン + その文に該当する具体的なシーン + スタイルのNEGATIVEトークン、ランドスケープ16:9、ゼロ埋めで <slug>/images/01.png … として保存。
    • 本番 / ヘッドレス(デフォルト): python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png> — Gemini gemini-2.5-flash-image("Nano-Banana") via HTTPS、GEMINI_API_KEY は環境変数から。サーバーサイドで動作。エンドツーエンドで検証済み。アプリワーカーが呼び出す方式です(ローカルMCP不要)。
    • 対話型(オプション): Claudeセッション内で実行する場合は mcp__margot__image_generate を使用。並列衝突を避けるため、スラッグプレフィックス付きのファイル名を使用すること([[parallel-agents-shared-output-collision]] 参照)。
  4. 合成 → python3 <skill>/pipeline/stitch.py <slug> → <slug>/final-1080p.mp4(1920×1080@25、画像タイミングはビートに基づく)。最終的な再生時間が音声の再生時間とほぼ一致することを確認。

バッチ処理と新しいルック

  • バッチ: トピックごとに1つのサブエージェントを起動(並列)、それぞれが自身のスラッグディレクトリを所有。正確なエージェントプロンプトの形状はRestoreAssist実行を参照。
  • 音声差し替え(音声のみ変更、スクリプト/画像は同じ): VOを再生成、list.txt のdurationを new_total/old_total でリスケール、再合成。(差し替えパターン)
  • ルックの追加: styles.md にブロックを追加(positive/negative トークン)。そのキーが即座に選択可能なスタイルになります — このレジストリがドロップダウンのデータソースです。

アップロード(YouTube、オプション)

ブラウザのファイルアップロードは機能しません(ホストパスが拒否される)。[[youtube-api-upload-restoreassist]] に文書化されたYouTube Data APIパスを使用します: デスクトップOAuthクライアント → トークンを ~/.hermes/yt-restoreassist-token.json に保存 → videos().insert privacyStatus=unlisted、category 27、not-for-kids。チャンネルタイトルでガード。uploaded.json により冪等性を確保。OAuthクライアントのGCPプロジェクトでYouTube Data API v3が有効になっている必要があります。

ガードレール

  • クレームは現実のものにすること(ブランドWiki / 製品の事実)。フラットイラスト + 合成音声 → YouTubeのAI開示は通常「いいえ」(アップロード時に確認; AI音楽を追加した場合は「はい」に変更)。
  • 一貫性のために、バッチごとに1つのスタイルを維持。SKILL.md は200行以内に保つこと([[feedback-tight-code]] 参照)。
  • 参考実装 + アセット: /Users/phill-mac/restoreassist-videos/。

Individual skills in this repo

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

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

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

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.

関連スキル