This is a symptom-based troubleshooting guide for when your LiveAvatar integration breaks. It covers the most common failure modes: silent avatars (usually missing context_id in FULL mode), garbled audio (wrong PCM format in LITE), auth header mixups between endpoints, and dropped WebSocket events. The format is practical, each section starts with "most likely cause" and gives you a checklist or quick fix. Particularly useful is the side-by-side comparison of FULL vs LITE event systems, since mixing them is apparently a frequent mistake. If you're building against HeyGen's LiveAvatar API and hitting weird behavior with no clear error messages, this will save you hours of guessing.
npx skills add https://github.com/heygen-com/liveavatar-agent-skills --skill liveavatar-debug