Communitygithub.com

Zuhair-01/claude-skills-and-systems

HeyGen v2 APIを使用して、アバター・音声・スクリプト・シーン・背景を正確に制御したAIアバタービデオを作成します。

claude-skills-and-systems とは?

このスキルは、HeyGenの`/v2/video/generate`APIを直接呼び出すことで、アバター、音声、スクリプト、シーン、背景を完全に制御しながらAIアバタービデオを生成するためのものです。Claude Code、Cursor、Codexなど、AIエージェントが利用可能な開発環境で動作します。ユーザーは特定のアバターと音声を選択し、正確なスクリプトを書き、シーンごとに異なる背景を設定でき、マルチシーンビデオや透明WebMビデオ、写真からのアバター生成、Remotionとの連携にも対応します。HeyGen MCPツールが利用可能な場合はそちらを優先し、ビデオ生成とアバター/音声一覧取得は直接API呼び出しで行います。生成には5〜15分程度かかるため、ポーリングによるステータス確認が必要です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/avatar-video

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

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

ドキュメント

アバタービデオ

アバター、音声、スクリプト、シーン、背景を完全に制御してAIアバタービデオを作成します。HeyGenの/v2/video/generateAPIを使用して、シングルシーンまたはマルチシーンビデオを正確な設定で構築します。

認証

すべてのリクエストにX-Api-Keyヘッダーが必要です。HEYGEN_API_KEY環境変数を設定してください。

curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

ツール選択

HeyGen MCPツール(mcp__heygen__*)が利用可能な場合は、それらを優先してください。認証とリクエストのフォーマットを自動的に処理します。

タスクMCPツールフォールバック(直接API)
ビデオステータスの確認 / URL取得mcp__heygen__get_videoGET /v2/videos/{video_id}
アカウントのビデオ一覧mcp__heygen__list_videosGET /v2/videos
ビデオの削除mcp__heygen__delete_videoDELETE /v2/videos/{video_id}

ビデオ生成(POST /v2/video/generate)とアバター/音声一覧は、直接API呼び出しで行います。以下のリファレンスファイルを参照してください。

デフォルトワークフロー

  1. アバター一覧 — GET /v2/avatars → アバターを選択、プレビューし、avatar_idとdefault_voice_idを確認。詳細はavatars.mdを参照
  2. 音声一覧(必要な場合) — GET /v2/voices → アバターの性別/言語に一致する音声を選択。詳細はvoices.mdを参照
  3. スクリプト作成 — 各シーンを1つのコンセプトで構造化。詳細はscripts.mdを参照
  4. ビデオ生成 — POST /v2/video/generateにアバター、音声、スクリプト、シーンごとの背景を指定。詳細はvideo-generation.mdを参照
  5. 完了までポーリング — GET /v2/videos/{video_id}でステータスがcompletedになるまで確認。詳細はvideo-status.mdを参照

クイックリファレンス

タスク参照先
アバターの一覧とプレビューavatars.md
音声の一覧と選択voices.md
スクリプトの作成と構造化scripts.md
ビデオ生成(シングル/マルチシーン)video-generation.md
カスタム背景の追加backgrounds.md
キャプション/字幕の追加captions.md
テキストオーバーレイの追加text-overlays.md
透明WebMビデオの作成video-generation.md(WebMセクション)
テンプレートの使用templates.md
写真からのアバター作成photo-avatars.md
ビデオステータスの確認 / ダウンロードvideo-status.md
アセットのアップロード(画像、音声)assets.md
Remotionとの連携remotion-integration.md
Webhookの設定webhooks.md

このスキルを使用するタイミングと「Create Video」スキルの違い

このスキルは精密な制御が必要な場合に使用します。アバターを選択し、正確なスクリプトを書き、各シーンを設定します。

ユーザーが単にビデオのアイデアを説明し、残り(スクリプト、アバター、ビジュアル)をAIに任せたい場合は、代わりにcreate-videoスキルを使用してください。

ユーザーが言ったことCreate Videoスキルこのスキル
「Xについてのビデオを作って」✓
「製品デモを作成して」✓
「アバターYにZと正確に言わせたい」✓
「異なる背景のマルチシーンビデオ」✓
「合成用の透明WebM」✓
「スクリプトにこの特定の音声を使用する」✓
「正確な仕様でビデオをバッチ生成する」✓

リファレンスファイル

コアビデオ作成

ビデオカスタマイズ

高度な機能

統合

基礎

ベストプラクティス

  1. 生成前にアバターをプレビュー — preview_image_urlをダウンロードして、ユーザーがアバターを確認してから決定できるようにする
  2. アバターのデフォルト音声を使用 — ほとんどのアバターには自然な結果を得るために事前にマッチングされたdefault_voice_idがあります
  3. フォールバック:手動で性別を合わせる — デフォルト音声がない場合、アバターと音声の性別が一致することを確認
  4. 開発時はテストモードを使用 — test: trueを設定してクレジット消費を回避(出力には透かしが入ります)
  5. 余裕のあるタイムアウトを設定 — ビデオ生成には5〜15分かかる場合が多く、それ以上かかることもあります
  6. 入力を検証 — 生成前にアバターIDと音声IDが存在することを確認

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

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.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

関連スキル