Communitygithub.com

Army161/OpenMontage

根据文本提示使用HeyGen的Video Agent创建视频。适用于:根据描述或创意创建视频、生成解说/演示/营销视频、快速视频原型或草稿、一次性从提示生成视频。

OpenMontage 是什么?

该技能允许开发者或AI代理用户通过纯文本提示直接生成完整视频。它利用HeyGen的Video Agent API,自动处理脚本撰写、虚拟形象选择、视觉元素、配音、节奏和字幕。技能提供两种使用路径:优先通过HeyGen MCP工具(如 `mcp__heygen__generate_video_agent`)实现自动化的身份验证和请求格式化;若MCP工具不可用,则回退到直接的HTTP API调用(例如 `POST /v1/video_agent/generate`)。用户还可以通过轮询或webhook获取视频状态与下载链接。技能特别强调提示优化——参考 `prompt-optimizer.md` 和 `visual-styles.md` 来构建包含场景、时长和视觉风格的提示——从而在解说、演示和营销视频等场景中实现高质量输出。与精确控制虚拟形象和剧本的“Avatar Video”技能不同,本技能专注于快速、一体的“提示即视频”工作流,非常适合原型设计和快速迭代。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/create-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

创建视频

从文本提示生成完整视频。描述您想要的内容,AI会自动处理脚本编写、虚拟形象选择、视觉效果、配音、节奏和字幕。

身份验证

所有请求都需要 X-Api-Key 标头。请设置 HEYGEN_API_KEY 环境变量。

curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "制作一个60秒的产品演示视频。"}'

工具选择

如果 HeyGen MCP 工具可用(mcp__heygen__*),优先使用它们,而不是直接调用 HTTP API——它们会自动处理身份验证和请求格式化。

任务MCP 工具回退方案(直接 API)
根据提示生成视频mcp__heygen__generate_video_agentPOST /v1/video_agent/generate
检查视频状态 / 获取URLmcp__heygen__get_videoGET /v2/videos/{video_id}
列出账户视频mcp__heygen__list_videosGET /v2/videos
删除视频mcp__heygen__delete_videoDELETE /v2/videos/{video_id}

如果 HeyGen MCP 工具不可用,则按照参考文件中记载的方式使用直接的 HTTP API 调用。

默认工作流程

始终使用 prompt-optimizer.md 指南来构建包含场景、时长和视觉风格的提示。

使用 MCP 工具:

  1. 使用 prompt-optimizer.md → visual-styles.md 编写优化后的提示
  2. 使用提示和配置(duration_sec, orientation, avatar_id)调用 mcp__heygen__generate_video_agent
  3. 使用返回的 video_id 调用 mcp__heygen__get_video 轮询状态并获取下载 URL

不使用 MCP 工具(直接 API):

  1. 使用 prompt-optimizer.md → visual-styles.md 编写优化后的提示
  2. POST /v1/video_agent/generate — 参见 video-agent.md
  3. GET /v2/videos/<id> — 参见 video-status.md

快速参考

任务MCP 工具参考文档
根据提示生成视频mcp__heygen__generate_video_agentprompt-optimizer.md → visual-styles.md → video-agent.md
检查视频状态 / 获取下载 URLmcp__heygen__get_videovideo-status.md
上传参考文件以增强提示—assets.md

何时使用此技能 vs Avatar Video

此技能适用于基于提示的视频创建——描述您想要的内容,AI 负责其余工作。

如果用户需要精确控制特定的虚拟形象、精确的脚本、每个场景的语音/背景配置或多场景组合,请改用 avatar-video 技能。

用户表述此技能Avatar Video 技能
"帮我制作一个关于 X 的视频"✓
"创建一个产品演示"✓
"我要虚拟形象 Y 精确地说 Z"✓
"多场景视频,背景不同"✓
"用于合成的透明 WebM"✓

参考文件

核心工作流

基础

最佳实践

  1. 优化您的提示——平庸与专业结果之间的差距完全取决于提示质量。始终使用提示优化器。
  2. 指定时长——使用 config.duration_sec 来获得可预测的长度。
  3. 必要时锁定虚拟形象——使用 config.avatar_id 以保证不同视频间的一致性。
  4. 上传参考文件——帮助代理理解您的品牌/产品。
  5. 迭代提示——根据结果进行优化;Video Agent 非常适合快速迭代。

Individual skills in this repo

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

Army161/OpenMontage

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Army161/OpenMontage

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Army161/OpenMontage

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Army161/OpenMontage

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Army161/OpenMontage

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Army161/OpenMontage

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Army161/OpenMontage

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.

Army161/OpenMontage

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`).

Army161/OpenMontage

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.

Army161/OpenMontage

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`.

Army161/OpenMontage

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.

Army161/OpenMontage

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).

Army161/OpenMontage

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 (website-to-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.

Army161/OpenMontage

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.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Army161/OpenMontage

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.

Army161/OpenMontage

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

Army161/OpenMontage

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

相关技能