Communitygithub.com

CleanExpo/Pi-Dev-Ops

単一のトピックから、手描き風/シンプルイラストのYouTube動画を完全自動で生成するパイプライン。FACT/STORYモードの分岐、ElevenLabs音声合成、Artlist画像生成、FFmpeg編集を統合。

Pi-Dev-Ops とは?

このスキルは、手描き風やシンプルなイラストを用いたフェイスレスYouTube動画(ZenやNick Investのようなチャンネル向け)を、トピック1つから完全自動で生成するエンドツーエンドパイプラインです。特に重要なのは、動画の特性に応じて「FACT(ノンフィクション/教育的)」か「STORY(フィクション/ストーリーテリング)」かを最初にユーザーに問いかけ、モードによってスクリプト作成、リサーチ、権威付け、YouTube開示設定まですべてを分岐させる点です。パイプラインは4段階で構成されます:モード決定とスタイルトークンの固定(Stage 0)、テンプレート解析とスクリプト作成(Stage 1)、ElevenLabsによるタイムスタンプ付き音声生成(Stage 2)、Artlist AI Toolkit(モデルNano Banana 2)による画像生成とFFmpegによる動画結合(Stage 3)。Higgsfieldは使用せず、人間の録音も一切不要。各動画はチャンネルごとに再利用可能なスタイルトークンで統一され、視覚的一貫性を保ちます。FACTモードでは正確性ゲート(出典確認済みの研究・統計・日付)が、STORYモードでは年齢・ブランド適合性ゲートがかかり、事実とフィクションの混同を防ぎます。このスキルは、『video-director』(アニメーションや編集が必要な場合)や『video-distribution-strategist』(公開戦略)と連携して動作します。

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

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

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

ドキュメント

Faceless Video Pipeline

決定論的な4段階パイプラインとして、フェイスレスチャンネルの動画を構築します。ソースの分解: ~/2nd Brain/2nd Brain/Wiki/research-faceless-youtube-claude-code-pipeline-2026-06-26.md。

ハードルール (プラットフォームリスク + 品質)

  1. 音声 = ElevenLabs Voice Artist (Phillの有料プラン) であり、人間の録音ではありません。ソース動画の「AI音声はBANされる」という懸念は誤りです — Sources/youtube-synthetic-content-disclosure-policy-2026-06-26.md にあるYouTubeの開示ポリシーを参照してください。実際のルール: YouTubeの改変/合成コンテンツの開示が必要なのは、AI 音楽、クリエイター自身のクローンではない合成音声、または実在の人物/場所/イベントをリアルに描写するAIである場合であり、アニメーション/落書きには不要です。開示によるペナルティはありません (視聴率/収益化に影響なし)。そのため、動画にAI音楽または自分自身ではない合成音声が含まれる場合 (このパイプラインでは常に該当)、デフォルトで「はい」に設定します。YouTube Studio → 属性 → 「AIの使用」→ はい で設定します。「子ども向け」= はい は、子ども向けコンテンツ (STORY/childcare) の場合のみ設定します。
  2. 1つのスタイルトークン、すべての画像に適用。 事前に1つのスタイル記述を固定し、生成されるすべての画像にそれをそのまま含めることで、チャンネルの視覚的一貫性を保ちます。
  3. モードに応じた権威性 (ステージ0のスイッチを参照)。FACT (ノンフィクション): 実際の研究/日付/統計を引用し、執筆前に調査し、主張の正確性を検証します。STORY (フィクション): 創作された物語。権威性は感情的共感であり、事実ではありません。代わりに年齢とブランドへの適合性を検証します (例: 保育 = 優しく、安全で、年齢に適した内容)。決してフィクションを事実として提示したり、FACTモードで「事実」を捏造してはいけません。
  4. 静止画 + ナレーション (モーショングラフィックスは不可)。 これは落書きチャンネルの形式です。ユーザーがアニメーションや編集の洗練を希望する場合は、代わりに video-director に引き継ぎます。

基盤 — 重要な区別

ソース動画は Higgsfield (Claude Code MCP) を使用しています。当パイプラインは Higgsfield を使用しません。 Phillの画像プラットフォームは Artlist (artlist.io、AI Toolkit) であり、browser-harness を介してブラウザ内で操作します。注: 「artist.io」は artlist.io のタイプミスです。

  • 画像生成 (主要): Artlist AI Toolkit(toolkit.artlist.io/image-video-generator?mode=image、モデル Nano Banana 2、16:9 / 2K)。ステージ3で実証済みのメカニズム。
  • 画像生成 (フォールバック): mcp__margot__image_generate (同じく Nano Banana 2) — 無人テスト実行のみ。Higgsfield は使用しません。
  • ナレーション: ElevenLabs TTS (REST API経由)。キーとデフォルト音声は ~/.hermes/.env (ELEVENLABS_API_KEY、ELEVENLABS_VOICE_ID) — プログラムで解決し、決して貼り付けないでください。人間の録音は禁止。
  • トランスクリプト取得: yt-dlp。タイムスタンプ: ElevenLabsアライメント (主要) または whisper-cli (フォールバック)。結合: ffmpeg。

ワーキングフォルダ

~/faceless-video/<topic-slug>/ を作成し、すべてのアーティファクトをそこに保存します: reference-format.md、script.md、voiceover.mp3、transcript.json、images/NN.png、final.mp4。

ステージ0 — モードスイッチ (最初に、他の何よりも先に質問)

このエンジンはクライアント/アプリケーションによって異なる役割を果たすため、実行時の最初の質問は次のとおりです:

「これは FACT (ノンフィクション) ですか、それとも STORY (フィクション) のスクリプトですか?」 mode を作業フォルダに記録します (mode.txt)。これにより、実行全体が分岐します:

FACT (ノンフィクション)STORY (フィクション)
使用例教育製品、解説、「知ってた?」保育の話、寓話、就寝前/ブランドストーリー
参照枠組みフック + 3本柱の本文 + ペイオフキャラクター → 欠点 → 旅 → 教訓 → 解決
権威性研究された実際の研究/統計/日付に基づく; 正確性ゲート感情的共鳴; 年齢/ブランド適合性ゲート
ハードルール事実を決して捏造しないフィクションを事実として決して提示しない
YouTube開示AI使用 = はい (AI音楽/音声が存在)AI使用 = はい + 子ども向け = はい (子ども向け)

もし呼び出し元がすでにモードを暗示している場合 (例: 「妻のための保育ストーリー」→ STORY、「私の製品について説明して」→ FACT)、再質問する代わりに1行で確認します。デフォルトの参照処理、スクリプトテンプレート、ゲーティングはすべてこのスイッチに従います。

ステージ0b — スタイルトークン (チャンネルごとに1回、その後再利用)

ユーザーに、ターゲットとなる視覚スタイルの参考スクリーンショットを3〜5枚依頼します。次の分析を促します:

「AI画像生成のための、この画像の視覚スタイルを分析してください。(1) プロンプトとして貼り付けられる短い肯定的なスタイル記述、(2) 洗練された/リアルな出力へのドリフトを防ぐためのネガティブプロンプトのリストを提供してください。被写体ではなく、スタイルのみに焦点を当ててください。」 結果をチャンネルルートの style-token.md として保存します (そのチャンネルのすべての動画で再利用されます)。

ステージ1 — スクリプト (ステージ0のモードに応じて分岐)

  1. トピックと、選択したモードのレーンにある実績のある参考動画URLを依頼します (FACTチャンネルにはFACT動画、STORYチャンネルにはSTORY動画 — レーンを混在させないでください)。
  2. 参考トランスクリプトを取得: yt-dlp --write-auto-sub --sub-lang en --skip-download --sub-format vtt -o 'ref-%(id)s.%(ext)s' '<URL>'。.vtt をクリーンアップします (タイムスタンプ/タグを削除、重複する自動字幕行を削除)。
  3. モードごとに、再利用可能なテンプレートに分解します:
    • FACT: フック (マイクロビート)、導入/約束、3本柱の本文、遷移文、全長。
    • STORY: 主人公 + 1つの共有された欠点、渇望、誘発出来事、旅、示された (語られない) 実演、引用可能な知恵の言葉、内面の気づき、前向きな結び。 reference-format.md として保存します。
  4. そのテンプレートを使用して、トピックに関する新しいスクリプトを書きます。FACT: 最初に source-ingest スキルを実行して信頼できるTier1〜2のデータをVaultの Sources/ ライブラリに取り込み、その後、保存されたソースのみを引用してスクリプトを書き、それらに対してすべての主張の正確性を検証します。STORY: 自由に創作し、年齢/ブランドゲートを適用します。クリーンなスクリプト (シーン指示なし) を script.md に出力します。
  5. ナレーションを生成する前に、ユーザーとスクリプトを確認します。

ステージ2 — ナレーション + タイムスタンプ (ElevenLabs、自動化)

  1. ElevenLabsの with-timestamps エンドポイント (1回の呼び出しで音声 + 文字アライメントを返す) を使用して script.md からナレーションを生成: curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/$ELEVENLABS_VOICE_ID/with-timestamps" -H "xi-api-key: $ELEVENLABS_API_KEY" -H "content-type: application/json" -d '{"text":"<script>","model_id":"eleven_multilingual_v2"}' → base64音声を voiceover.mp3 に、アライメントを transcript.json に保存します。
  2. アライメントからフレーズ/文ごとのタイムスタンプセグメントを導出します — 各セグメントが1つの画像ビートになります。(フォールバック: アライメントが使用できない場合、ffmpeg -i voiceover.mp3 voiceover.wav の後、whisper-cli -f voiceover.wav -ml 1 --output-json -of transcript を使用します。)
  3. 音声はチャンネル/クライアントごとに固定されていません — モード/ブランドに合ったElevenLabsの音声を選択します (例: 保育フィクションには暖かく優しい語り手、教育FACT製品には明瞭で権威のある声)。その voice_id を ELEVENLABS_VOICE_ID のデフォルトの代わりに渡します。選択する際はユーザーのElevenLabs音声ライブラリを閲覧します。
  4. 人間による一時停止は不要 — ステージ2は無人で実行されます。

ステージ3 — タイムスタンプごとに1枚の画像 (Artlist AI Toolkit、ブラウザ実証済み)

ビートごとに: シーンプロンプト + ロックされたスタイルトークンをそのまま含める。browser-harness を介してArtlistを操作します (PhillのChromeにログインしている必要があります; Way-1リモートデバッグが有効であること)。苦労して得たメカニズム:

  1. toolkit.artlist.io/image-video-generator?mode=image を開きます。プロンプトは [contenteditable=true] のdivです; Generate ボタンは innerText Generate と一致します。デフォルト設定はすでに 16:9 / 2K / 1画像です (良好)。
  2. 画像ごとに: 既存の生成UUIDのスナップショットを取得 → ボックスをクリック、document.execCommand('selectAll')、type_text(prompt) → Generateをクリック → ローダーテキスト (on its way|Almost ready|Generating) が消え、かつ新しいUUIDが表示されるまでポーリングします。
  3. 結果は ai-toolkit-generations.imgix.net/...png?...&s=<sig> にあります。汎用正規表現 [0-9a-f]{8}-[0-9a-f]{4}-...{12}\.png でUUIDを抽出します (ファイル名のプレフィックスは image-<uuid> または -t-e-x-t_-t-o_-i-m-a-g-e-<uuid> と様々です)。正確なsrcをダウンロードします — imgixパラメータ (例: w=) を書き換えると署名が壊れて403になります。
  4. 1枚ずつ処理します。 急速なバーストはキューイング/スロットルを引き起こし、グリッドビューはDOMを仮想化するため、新しいUUIDの検出が壊れます。ポーリングウィンドウ後に生成が完了した場合は、グリッドから救出します (マッピングされていない個別のUUIDをダウンロードし、モンタージュし、視覚的にマッピングします)。 フォールバック (無人テストのみ): mcp__margot__image_generate — <save_as>.jpg として保存し、拡張子を考慮します。

ステージ4 — 結合

各画像を (次の開始時間 - 現在の開始時間) 秒間保持し、ナレーションをマルチプレックスするFFmpegのconcatを構築します:

  1. タイムスタンプから画像ごとの持続時間を含むconcatリストを生成します。
  2. ffmpeg -f concat -safe 0 -i list.txt -i voiceover.wav -c:v libx264 -pix_fmt yuv420p -c:a aac -shortest final.mp4
  3. 実際のアップロードには2Kソース画像を推奨します (テスト実行時のみ低解像度)。

ステージ5 — 最終化 (テスト実行ではなく、実際のアップロードの場合)

生の結合を完成した成果物に変換します:

  • 1080p — concatを 1920:1080 にスケーリング/パディング (白いパディングがスケッチブック背景に溶け込みます)、crf 19。
  • フェード — fade=t=in:st=0:d=0.6:color=white および最後の約0.8秒にわたる fade=t=out。画像間のビートはハードカットのままにします (スタイルに則して — クロスフェードはしないでください)。
  • BGM — Artlist AI Music (toolkit.artlist.io/music-generator?mode=music、Lyria 3; 画像と同じブラウザフロー、結果は cms-toolkit-artifacts.artlist.io/...music-<uuid> にある署名付き .wav ファイル — 正確なsrcをダウンロード)。ナレーションの下にミックス: volume≈0.13 (約−18 dB)、1.5秒フェードイン / 約1.8秒フェードアウト、amix=inputs=2:normalize=0。volumedetect で確認: 全体のピーク < 0 dB (クリッピングなし)、音楽の平均はナレーションより約15+ dB低いこと。

出力

final-1080p-music.mp4 (成果物) + 再利用可能な style-token.md。パスとステージごとのアーティファクトを報告します。公開/チャンネル戦略については video-distribution-strategist に引き継ぎます。アップロード時の合成コンテンツ開示を忘れないでください。

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

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.

関連スキル