Communitygithub.com

9018/mychat

根据文本提示使用HeyGen视频智能体创建视频。适用于:(1) 根据描述或创意生成视频,(2) 从提示生成解说、演示或营销视频,(3) 无需指定具体虚拟角色、声音或场景即可制作视频,(4) 快速视频原型或草稿,(5) 一键从提示生成视频,(6) 用户说“给我做个视频”或“创建一个关于X的视频”。

mychat 是什么?

该技能使AI助手能够通过HeyGen的视频智能体,仅凭文本提示自动生成完整的视频。它简化了视频制作流程:AI负责脚本撰写、虚拟角色选择、视觉元素、配音、节奏和字幕,用户只需描述想要的内容。该技能支持通过HeyGen MCP工具(mcp__heygen__*)进行无缝操作,若MCP工具不可用,也可回退到直接HTTP API调用。典型工作流程包括使用prompt-optimizer优化提示、调用生成端点,以及轮询状态获取下载链接。该技能专为“提示驱动”的视频创建优化,用户需要精细控制(如指定特定虚拟角色或逐场景配置)时应使用avatar-video技能。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/9018/mychat/tree/HEAD/OpenMontage/.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. 调用 mcp__heygen__generate_video_agent,传入提示和配置(duration_sec、orientation、avatar_id)
  3. 调用 mcp__heygen__get_video,传入返回的 video_id,以轮询状态并获取下载 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. 迭代提示 —— 根据结果进行优化;视频智能体非常适合快速迭代

Individual skills in this repo

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

9018/mychat

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, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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.

9018/mychat

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

9018/mychat

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

9018/mychat

Download video and audio from YouTube and 1000+ sites using yt-dlp. No API keys needed. Use when: (1) Downloading a video from YouTube or other sites, (2) Extracting audio from a video URL, (3) Downloading subtitles/captions from a video, (4) Getting video metadata without downloading.

相关技能