Communitygithub.com

EvoFlow - Plan 기반 영상 제작 스킬

Plan 협업(태스크 협업 모드)에서 구조화된 워크플로우를 따라 단편 영상 제작: 먼저 사용자 요구사항을 질문하고, 확인 후 plan 도구로 모든 직군(각본가, 시각 기획자, 아티스트, 감독, 후반 작업)을 단계별로 계획한 후 직렬 실행합니다.

EvoFlow - Plan 기반 영상 제작 스킬란 무엇인가요?

EvoFlow는 AI 어시스턴트가 Plan 협업 모드에서 단편 영상 제작을 체계적으로 수행할 수 있게 해주는 스킬입니다. 사용자가 영상 아이디어를 제공하면, 스킬은 먼저 주제, 길이, 스타일, 화면 비율 등의 세부 사항을 질문하여 요구사항을 정확히 파악합니다. 이후 `plan(goal, steps[])` 도구를 사용하여 각본가(media-screenwriter), 시각 기획자(media-visual-planner), 아티스트(media-artist), 영상 감독(media-video-director), 후반 작업(media-post) 등 모든 직군을 단계별로 할당합니다. 할당된 단계는 사용자 확인 후 순차적으로 실행되며, 각 단계의 완료 여부를 주 에이전트가 검증합니다. 이 스킬은 Cursor, Codex, Claude Code 등 plan 기반 협업을 지원하는 모든 플랫폼에서 사용 가능하며, Volcano Engine(Seedream/Seedance)의 이미지 및 비디오 생성 API와 통합되어 있습니다. 주요 특징은 모든 미디어 직군을 plan 단계 내에서 관리하여 워크플로우의 일관성과 투명성을 높인다는 점입니다.

지원 대상~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 스크립트(Volcano 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이 저장되고 사용자가 확인하면 즉시 executing 상태로 진입하여 직렬 실행됩니다. 더 이상 plan 외부에서 별도로 subagent를 위임하지 않습니다.

워크플로우

사용자 요구사항 표현
     ↓
사용자 요구사항 질문 및 확인 (주제, 길이, 스타일, 화면 비율 등)
     ↓
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="15초 제품 홍보 영상 제작, 주제: xxx, 스타일: xxx",
  steps=[
    {
      "step_id": 1,
      "description": "각본가가 production brief 작성, 로그라인, 스토리보드, 내레이션 대본 포함",
      "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이 저장되고 사용자가 "실행 시작"을 확인하면 executing 단계로 진입하며, 각 단계는 의존성 순서에 따라 직렬로 실행됩니다. 각 단계 완료 후 주 에이전트가 산출물을 검증한 후 다음 단계로 넘어갑니다.

미디어 서브 에이전트 목록

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 이미지 to 영상 + 네이티브 더빙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 스킬을 먼저 읽어야 함)

기능스크립트provider
이미지 생성image_generate.pyjimeng (Volcano Ark Seedream)
영상 생성video_generate.py + task_wait.pyjimeng (Volcano Ark Seedance, 기본 오디오 포함)
자막subtitle_build.py + subtitle_burn.py로컬 ffmpeg

실패 처리: jimeng 실패 시 자동으로 wan/kling으로 전환하지 말고 사용자에게 Ark 모델 액세스 포인트를 개설하도록 안내합니다. 동일한 매개변수로 최대 1회 재시도합니다.

일반적인 오류

  • plan 모드에서 메인 세션이 직접 image_generate.py 실행 → plan 단계 내 media-artist 등의 직군이 실행해야 함
  • plan 단계 외부에서 별도로 subagent 위임 → 모든 직군은 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(离线,无需云端)。当需要离线语音合成时使用。

관련 스킬