Voice Agent Expert – Debugging Cheat Sheet (Skill)

Duplicate voice agent processes occur when startup scripts fail to clean stale instances. Run the diagnostic script to detect and automatically remove duplicate Letta processes, then execute the idempotent startup flow to prevent recurrence.

Stale Livekit rooms result from incomplete disconnections or token expiry. The diagnostic identifies disconnected rooms and token status, then provides automated remediation steps to reset rooms and refresh tokens for clean reconnection.

Safe restart workflows clean duplicate processes, validate token expiry, and verify Livekit connectivity before restarting. Run the included diagnostic and follow the recommended restart sequence to avoid timeouts and misrouted traffic.

Yes, the Skill applies to development, testing, and production scenarios. It provides actionable remediation steps and automated diagnostics through scripts, supporting both emergency fixes and preventative health checks across environments.

Start with health checks for Letta, Livekit, and token validity. The diagnostic script runs these checks automatically and surfaces connectivity issues, duplicate processes, and token problems to guide your troubleshooting.

Timeouts and misrouting typically stem from duplicate processes, stale rooms, or expired tokens. The diagnostic identifies these root causes and provides automated cleanup and restart procedures to restore normal traffic flow.