Voice Agent Expert – Debugging Cheat Sheet (Skill)

This skill is a practical, "use-it-while-debugging" reference for getting a LiveKit + Letta voice agent working reliably.

Core rules (fix 90% of issues)

1. Override the right LiveKit hook

   • The framework calls llm_node, not generate_reply.
   • If you override the wrong method, your changes won't run and your agent may "look alive" but never route text correctly.

2. Only ONE voice-agent process can run at a time

   • Duplicate processes commonly cause:
     • timeouts
     • audio cutting out
     • inconsistent behavior (you're looking at logs from one process while another is actually serving)