Building with Agents

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

skills CLI (recommended)
Manual

npx skills add 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

When your agent loads a skill, it gains the procedural knowledge to execute the task end-to-end. The 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.

Getting Started

Core Concepts

FULL Mode

LITE Mode

Socials

FAQ

Overview

Available skills

Installation

How it works

​Overview

​Available skills

​Installation

​How it works

Overview

Available skills

Installation

How it works