Which operating systems are compatible with this skill?

This skill is specifically designed and optimized for macOS, particularly systems running Apple Silicon (M1/M2/M3) due to its integration with MLX acceleration.

How does it verify if a fix worked?

The skill includes a verification phase that runs a quick TTS test and a full health check script to confirm the system is fully operational.

What common issues can this skill resolve?

It effectively handles stale lock files, crashed Bun processes, Kokoro model load timeouts, and audio playback race conditions.

Does it require specific log access?

Yes, it utilizes access to launchd logs, NDJSON audit logs, and the Kokoro engine directory to perform comprehensive diagnostics.

TTS & Telegram Bot Troubleshooter

Name: TTS & Telegram Bot Troubleshooter
Author: terrylica

byterrylica

•

分析と監視

Diagnoses and resolves common Text-to-Speech and Telegram bot issues using systematic health checks and automated recovery patterns.

The Diagnostic Issue Resolver is a specialized skill designed to maintain the health of the tts-telegram-sync ecosystem on macOS. It provides a systematic framework for troubleshooting Kokoro engine errors, stale lock files, and Telegram bot crashes. By mapping real-time symptoms—such as silent audio or unresponsive bots—to a comprehensive table of known issues, it allows Claude to perform automated diagnostics, analyze audit logs, and apply targeted fixes to ensure seamless notification delivery and MLX-accelerated audio performance.

主な機能

01Kokoro engine and MLX-Audio environment health verification

02Automated detection and removal of stale TTS lock files

0319 GitHub stars

04Apple Silicon optimized diagnostic workflows for macOS systems

05NDJSON audit log analysis for rapid root cause identification

06Telegram bot process monitoring and automated restart capability

ユースケース

01Clearing stuck audio queues and eliminating double-playback race conditions

02Resolving Kokoro engine timeouts or MLX acceleration failures

03Fixing a Telegram bot that has stopped responding to messages

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills diagnostic-issue-resolver

For use in Claude.ai and ChatGPT

Download Skill