Overview
To make developing and integrating with LiveAvatar easier, we built a set of Agent Skills — pre-built procedural knowledge that enables AI coding agents to build LiveAvatar integrations correctly on the first attempt.
Install them in Claude Code, Cursor, Codex, or any agent that supports the Agent Skills specification, and your agent will know how to integrate and debug LiveAvatar without trial and error.
Available Skills
| Skill | Description |
|---|
liveavatar-integrate | End-to-end integration builder. Assesses your stack, recommends the optimal mode (Embed / FULL / LITE), and walks the agent through implementation step by step. |
liveavatar-debug | Symptom-based troubleshooting for common issues — silent avatars, garbled audio, auth errors, and more. |
liveavatar-feedback | Collects feedback on your LiveAvatar integration experience and sends it to the LiveAvatar team. Triggers after implementation, on frustration, or on explicit request. |
Installation
npx add-skill heygen-com/liveavatar-agent-skills
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
How It Works
Each skill follows a consistent structure:
| File | Purpose |
|---|
SKILL.md | Agent instructions and behavioral guidance |
references/ | Supporting docs — API details, code examples, troubleshooting trees |
liveavatar-integrate skill, for example, will assess your existing stack, recommend FULL vs LITE vs Embed mode, and generate working code — backend and frontend — with correct auth patterns.
Skills are designed around a “pit of success” philosophy: the correct
implementation is the easiest path. They identify failure points upfront and
clearly separate backend (API key) from frontend (session token) code.
