Diagnostic Issue Resolver

Diagnose and fix common TTS + Telegram bot issues through systematic symptom collection, automated diagnostics, and targeted fixes.

Platform: macOS (Apple Silicon)

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

When to Use This Skill

• TTS audio is not playing or sounds wrong
• Telegram bot is not responding to messages
• Kokoro engine errors or timeouts
• Lock file appears stuck
• Audio plays twice (race condition)
• MLX Metal acceleration is not working
• Queue appears full or backed up