Can I run this as part of a CI/CD workflow?

Yes, it is designed to be triggered after deployment or bootstrap phases to ensure all system symlinks and environments are correctly configured.

Does this skill expose my Telegram API tokens?

No. The skill verifies the existence and validity of the secrets file and API connectivity but ensures tokens are not exposed in the output report or logs.

Is this skill compatible with Windows or Linux?

This skill is specifically optimized for macOS on Apple Silicon (ARM64), as it validates MLX-Audio requirements which are hardware-specific.

How does it handle stale lock files?

It identifies if a lock file's PID is no longer running or if the lock age exceeds a 30-second threshold, reporting it as 'Stale' or 'Orphaned' for manual or automated cleanup.

What subsystems does this skill monitor?

It checks the Bun-based Telegram bot process, Kokoro TTS engine (Python/MLX), system lock states, secret file integrity, and environment compatibility.

System Health Check for TTS & Telegram

Name: System Health Check for TTS & Telegram
Author: terrylica

byterrylica

•

Analytics & Monitoring

Diagnoses and monitors the operational status of integrated Text-to-Speech engines and Telegram bot subsystems on Apple Silicon.

This skill provides a comprehensive 10-point diagnostic suite designed for developers managing AI-driven communication pipelines. It validates the entire environment—including Python virtual environments, MLX-Audio compatibility, and Telegram API connectivity—while identifying common bottlenecks like stale lock files, orphaned processes, or missing configuration secrets. By generating an actionable pass/fail report with remediation steps, it significantly reduces the mean time to recovery (MTTR) for TTS and bot infrastructure on macOS.

Key Features

01Environment validation for MLX-Audio and Apple Silicon (M1+)

0210-subsystem comprehensive health reporting

03Actionable fix recommendations for every failed check

04Stale lock and orphaned process detection for TTS

0519 GitHub stars

06Telegram API connectivity and secret file verification

Use Cases

01Debugging unresponsive Telegram bots or TTS generation failures

02Cleaning up stale temporary WAV files and orphaned locks before production use

03Verifying system readiness after a fresh bootstrap or configuration update

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills system-health-check

For use in Claude.ai and ChatGPT

Download Skill