Communitygithub.com

EvovexAI/EvoFlow

Plan コラボレーション(タスク連携モード)で、構造化されたワークフローに従ってショート動画を制作します。まずユーザーの要件をヒアリングし、確認後、plan ツールですべての職種(脚本、ビジュアル企画、美術、監督、ポストプロダクション)をステップとして計画に組み込み、直列実行します。

EvoFlow とは?

EvovexAI/EvoFlow は、Plan コラボレーションモードを利用してショート動画制作を構造化する AI エージェントスキルです。このスキルは、ユーザーとの対話を通じて要件(テーマ、時間、スタイル、アスペクト比など)をヒアリングし、確認後に `plan` ツールを使用して、脚本家、ビジュアルプランナー、アーティスト、監督、ポストプロダクションといったすべての職種を明確なステップとして計画に組み込みます。各ステップは依存関係に基づいて直列実行され、各工程の完了後に検証が行われます。これにより、従来のサブエージェントの個別委任を排除し、一貫性のある制御と効率的な実行を実現します。対応プラットフォームは主に火山エンジン(Seedream と Seedance)で、画像生成、動画生成、ネイティブ音声、字幕追加などの機能を提供します。他のプロバイダー(Agnes、Wan、Kling)も環境変数で設定可能です。このスキルは、Plan モードが有効な環境で、動画制作パイプラインを自動化・最適化したい開発者や AI エージェントユーザーに最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EvovexAI/EvoFlow/tree/HEAD/skills/public/plan-video-production

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

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

ドキュメント

Plan 動画制作スキル

適用範囲

前提: 現在 Plan コラボレーションが有効(scenario(activate, plan) がアクティブ)であり、ビジュアル/動画出力(画像生成、ショート動画、ナレーション、字幕)を含むタスクを実行する場合。

ベンダー選択: 画像生成は byted-ark-seedream-skill を参照。動画生成は media-production スクリプト(火山 Seedance)を参照。その他のベンダーは agnes-media-generation / wan-media-generation / kling-media-generation を参照。

認証情報(環境変数)

設定 → 環境変数 でスキルに必要な KEY=VALUE(例: VOLCENGINE_API_KEY / ARK_API_KEY)を追加します。設定 → モデル → クリエイティブメディア で他のベンダーのキーを入力することもできます。

機能よく使う KEYスキル
画像生成VOLCENGINE_API_KEY / ARK_API_KEYbyted-ark-seedream-skill
動画生成同上media-production
AgnesAGNES_API_KEYagnes-media-generation

核心的な変更点: すべてのメディア職種(脚本家、ビジュアルプランナー、アーティスト、監督、ポストプロダクション)は、すべて plan(goal, steps[]) の steps 内で assigned_agent によって指定されます。plan が保存され、ユーザーが確認すると実行フェーズに入り直列で実行されます。plan 外でサブエージェントを個別に委任することはありません。

ワークフロー

ユーザーが要件を伝える
     ↓
ユーザーの要件をヒアリングし確認する(テーマ、時間、スタイル、アスペクト比など)
     ↓
直接 plan(goal, steps[]) で計画
  step 1: media-screenwriter  — 脚本/絵コンテ/ナレーション原稿
  step 2: media-visual-planner — 画像生成用プロンプト
  step 3: media-artist        — キーフレーム画像生成
  step 4: media-video-director — 動画出力 + ネイティブ音声
  step 5: media-post          — ハード字幕
     ↓
ユーザー確認 → 実行(直列、各ステップで検証)

操作手順

ステップ 1: ユーザー要件のヒアリング

ユーザーから以下の情報を積極的に収集します。

質問例
動画のテーマ/商品/内容は?新型スマートウォッチのプロモーション
目標時間?15秒 / 30秒
ビジュアルスタイル?テクノロジー感 / 温かみ / 中華風
アスペクト比?16:9 / 9:16 縦長
ナレーション原稿の方向性?機能のハイライト + ブランドスローガン
参考素材はある?参考画像 / 競合動画

ステップ 2: 確認後に直接 plan

ユーザーが要件を確認したら、plan ツールを使用してすべてのステップを構造化された計画として書き込みます。

plan(
  goal="テーマ:xxx、スタイル:xxx の 15 秒商品プロモーション動画を制作",
  steps=[
    {
      "step_id": 1,
      "description": "脚本家がプロダクションブリーフを作成。ログライン、絵コンテ、ナレーション原稿を含む",
      "assigned_agent": "media-screenwriter",
      "expected_output": "outputs/production-brief.md",
      "acceptance_criteria": "ユーザーの意図、ログライン、ビジュアルスタイル、ショットリスト、ナレーションスクリプトを含むこと"
    },
    {
      "step_id": 2,
      "description": "ビジュアルプランナーが絵コンテを画像生成用プロンプトに変換",
      "assigned_agent": "media-visual-planner",
      "expected_output": "outputs/shot-prompts.json",
      "depends_on": [1]
    },
    {
      "step_id": 3,
      "description": "アーティストが最初のキーフレーム画像を生成",
      "assigned_agent": "media-artist",
      "expected_output": "outputs 内の PNG キーフレーム",
      "depends_on": [2]
    },
    {
      "step_id": 4,
      "description": "動画監督がネイティブ音声付きの MP4 を生成",
      "assigned_agent": "media-video-director",
      "expected_output": "outputs/*.mp4",
      "depends_on": [3]
    },
    {
      "step_id": 5,
      "description": "ポストプロダクションがハード字幕を追加し、最終 MP4 を納品",
      "assigned_agent": "media-post",
      "expected_output": "outputs/*-subtitled.mp4",
      "depends_on": [4]
    }
  ],
  flowchart_mermaid="..."
)

ステップ 3: ユーザー確認と実行

plan が保存され、ユーザーが「実行開始」を確認すると、実行フェーズに入ります。各ステップは依存関係の順序に従って直列で実行され、各ステップの完了後にメインエージェントが成果物を検証してから次のステップに進みます。

メディアサブエージェント一覧

assigned_agent役割コアツール
media-screenwriter脚本、絵コンテ、ナレーション原稿の作成read_file, write_to_file
media-visual-planner画像生成用プロンプトの作成read_file, write_to_file
media-artistSeedream による画像生成(jimeng)read_file, terminal → scripts/image_generate.py
media-video-directorSeedance による画像→動画生成 + ネイティブ音声read_file, terminal → scripts/video_generate.py, task_wait.py
media-postSRT 字幕 + ffmpeg によるハード字幕read_file, terminal → scripts/subtitle_build.py, subtitle_burn.py

注意: media-voice-director をステップに含めないでください。Seedance はネイティブで音声をサポートしています(generate_audio=true がデフォルトでオン)。

技術スタック

スクリプトディレクトリ: skills/public/media-production/scripts/(事前に media-production スキルを読む必要があります)

機能スクリプトプロバイダー
画像生成image_generate.pyjimeng(火山エンジン Seedream)
動画生成video_generate.py + task_wait.pyjimeng(火山エンジン Seedance、デフォルトで音声付き)
字幕subtitle_build.py + subtitle_burn.pyローカル ffmpeg

失敗処理: jimeng で失敗した場合、自動的に wan/kling に切り替えないでください。ユーザーに Ark モデルアクセスポイントの有効化を促してください。同じパラメータでの再試行は最大 1 回までです。

よくあるエラー

  • plan モードのメインセッションで直接 image_generate.py を実行する → plan ステップ内の media-artist などの職種が実行すべき
  • plan ステップ外でサブエージェントを個別に委任する → すべての職種は plan steps の assigned_agent に記述すべき
  • task_wait.py をスキップする → 動画生成が完了する前に納品してしまう
  • デフォルトのパイプラインで media-voice-director を委任し続ける → Seedance はネイティブで音声をサポートしているため不要

Individual skills in this repo

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

EvovexAI/EvoFlow

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

EvovexAI/EvoFlow

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

EvovexAI/EvoFlow

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

EvovexAI/EvoFlow

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

EvovexAI/EvoFlow

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

EvovexAI/EvoFlow

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

EvovexAI/EvoFlow

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

EvovexAI/EvoFlow

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

EvovexAI/EvoFlow

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

EvovexAI/EvoFlow

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (general-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

EvovexAI/EvoFlow

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

EvovexAI/EvoFlow

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

EvovexAI/EvoFlow

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /general-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

EvovexAI/EvoFlow

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

EvovexAI/EvoFlow

本地文字转语音,使用sherpa-onnx(离线,无需云端)。当需要离线语音合成时使用。

関連スキル