System Health Check
This skill automatically checks your system’s health metrics, proactively identifying potential issues and ensuring optimal performance.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add system-health-check npx -- -y @trustedskills/system-health-check
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"system-health-check": {
"command": "npx",
"args": [
"-y",
"@trustedskills/system-health-check"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill performs a comprehensive health check across ten subsystems related to the TTS engine, Telegram bot, and supporting infrastructure. It generates a pass/fail report table with actionable recommendations for fixing any identified issues. The system health check runs on macOS (Apple Silicon) environments and is designed to proactively identify potential problems and ensure optimal performance of these components.
When to use it
- Diagnose why the TTS engine or Telegram bot isn't working correctly.
- Verify system readiness after making changes to configuration or bootstrapping the environment.
- Perform a routine health check before demos or presentations.
- Investigate intermittent failures within the TTS pipeline.
- Check for stale locks, zombie processes, or orphaned temporary files.
Key capabilities
- Runs 10 subsystem health checks (Bot Process, Telegram API, Kokoro venv, MLX-Audio Import, Apple Silicon architecture verification, Lock State, Audio Processes, Secrets File, Stale WAV Files).
- Generates a pass/fail report table with diagnostic messages.
- Provides actionable recommendations for fixing identified issues.
- Checks for the existence and validity of required files (e.g., Telegram bot token file, Kokoro venv directory).
- Identifies stale locks and orphaned processes.
Example prompts
- "Run a system health check."
- "Check the status of the TTS engine and Telegram bot."
- "Perform a full diagnostic on the automation infrastructure."
Tips & gotchas
- Requires specific dependencies: Bun runtime, Python 3.13 with Kokoro venv, and a Telegram bot token stored in
~/.claude/.secrets/ccterrybot-telegram. - The skill is designed for macOS (Apple Silicon) environments only.
mise.tomlmust be configured within the~/.claude/automation/claude-telegram-sync/directory.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.