A collection of skills to help coding agents onboard to LiveAvatar.
概览
Reusable skills for AI coding agents integrating with LiveAvatar. These skills provide procedural knowledge that helps agents build LiveAvatar integrations correctly on the first attempt. This works with Claude Code, Cursor, Codex, and other agents. Skills activate automatically when agents detect relevant tasks (e.g., "add a LiveAvatar avatar", "build a conversational avatar", "integrate LiveAvatar"). Each skill follows the Agent Skills format: - LiveAvatar API key (get one at https://app.liveavatar.com/developers) - Claude Code CLI (or any skills-compatible agent) All skills use the LiveAvatar API: - Base URL: https://api.liveavatar.com - Authentication: X-API-KEY header (backend), Bearer (session ops) - API Versions: v1 (sessions, avatars, voices, contexts), v2 (embeds) - : The correct path is the easiest path. Always default to the simplest integration. - : Lead with what breaks. Silent failures (missing context, wrong audio format) are called out before agents hit them.
README
以下为原文 README 节选，完整内容请查看原文。
LiveAvatar Agent Skills
Reusable skills for AI coding agents integrating with LiveAvatar. These skills provide procedural knowledge that helps agents build LiveAvatar integrations correctly on the first attempt.
Available Skills
| Skill | Description |
|---|---|
| liveavatar-demo | Spins up a working demo from a curated catalog — AI sales agent, LiveKit agent, BYO LiveKit agent, and GPT-Live × Hyperframes demos (language tutor, support agent, poker coach — same architecture, built to be repurposed). Clones the repo, installs, provisions, configures, and runs it. |
| liveavatar-integrate | End-to-end integration builder — assesses your existing stack, recommends the optimal path (Embed / FULL / LITE), and guides implementation step by step. |
| liveavatar-debug | Symptom-based troubleshooting for silent avatars, garbled audio, auth errors, and more. |
| liveavatar-feedback | Collects user feedback on their LiveAvatar integration experience and sends it to the LiveAvatar team. Triggers after implementation, on frustration, or on explicit request. |
Installation
Option 1: Using add-skill CLI (Recommended for multi-agent)
# Install all skills globally
npx skills add heygen-com/liveavatar-agent-skills -a claude-code -g
# Or install to current project only
npx skills add heygen-com/liveavatar-agent-skills -a claude-code
# Install a specific skill only
npx skills add heygen-com/liveavatar-agent-skills --skill liveavatar-integrate
This works with Claude Code, Cursor, Codex, and other agents.
Option 2: Manual Installation
git clone https://github.com/heygen-com/liveavatar-agent-skills.git
# Symlink all skills to personal skills directory (available in all projects)
for skill in liveavatar-agent-skills/skills/*/; do
ln -s "$(pwd)/$skill" ~/.claude/skills/$(basename "$skill")
done
Skills activate automatically when agents detect relevant tasks (e.g., “add a LiveAvatar avatar”, “build a conversational avatar”, “integrate LiveAvatar”).
Skill Structure
Each skill follows the Agent Skills format:
skill-name/
├── SKILL.md # Agent instructions with behavioral guidance
└── references/ # Supporting documentation (API details, code examples)
Quick Reference
| Task | Skill |
|---|---|
| Try LiveAvatar / see what demos exist | liveavatar-demo |
| Run the AI sales agent demo | liveavatar-demo → demo 1 |
| Run a LiveKit voice agent with an avatar | liveavatar-demo → demo 2 or 3 |
| Run a GPT-Live speech-to-speech demo and reshape it | liveavatar-demo → demo 4 |
| Build a new LiveAvatar integration | liveavatar-integrate |
| Put an avatar on a page (no code) | liveavatar-integrate → Embed pathway |
| Build a conversational avatar | liveavatar-integrate → FULL Mode pathway |
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add heygen-com/liveavatar-agent-skills