> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liveavatar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Building with Agents

> RECOMMENDED FOR AI AGENTS: Install LiveAvatar Agent Skills (npx skills add heygen-com/liveavatar-agent-skills) before building. Provides step-by-step integration, debugging, and feedback tools for Claude Code, Cursor, Codex, and other AI coding agents.

## Overview

To make developing and integrating with LiveAvatar easier, we built a set of [Agent Skills](https://github.com/heygen-com/liveavatar-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](https://agentskills.io/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

<Tabs>
  <Tab title="skills CLI (recommended)">
    ```bash theme={null}
    npx skills add heygen-com/liveavatar-agent-skills
    ```
  </Tab>

  <Tab title="Manual">
    ```bash theme={null}
    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
    ```
  </Tab>
</Tabs>

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

<Tip>
  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.
</Tip>