healthcheck-machine

Name: healthcheck-machine
Availability: InStock
Author: bonjohen

Run contract-defined health scripts and report PASS/WARN/FAIL status.

Updated May 14, 2026

Search Tags:#monitoring #ssh #tailscale #healthcheck #machine status #remote diagnostics #pass fail parsing

Ready to run

npx skills add https://github.com/bonjohen/claude-local --skill healthcheck-machine

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: healthcheck-machine
Source: https://github.com/bonjohen/claude-local/tree/main/bundle/skills/healthcheck-machine
Command: npx skills add https://github.com/bonjohen/claude-local --skill healthcheck-machine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly determine whether a specific machine class in your lab is healthy or has problems, without manually hunting through logs and system state.

Core Features & Use Cases

Runs the class-specific health script: Locates and executes the expected health checker for a given machine class (Linux/macOS via health.sh, Windows via health.ps1).
Supports local or remote execution: Runs locally by default, or via SSH over Tailscale when you supply --remote <tailnet-host>.
Safely reports results: Passes through the script output verbatim and adds a clear PASS/WARN/FAIL summary; if the script is missing, it stops immediately and reports that condition without fabricating data.

Quick Start

Run a local health check for a machine class named sparkdgx by executing: healthcheck-machine sparkdgx.

Frequently Asked Questions about healthcheck-machine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I run a remote machine health check over SSH using Tailscale?▼

You can run remote machine health checks over Tailscale by supplying the --remote <tailnet-host> flag. This executes the expected health.sh or health.ps1 script via SSH and reports a verbatim PASS/WARN/FAIL status summary.

What is the expected directory layout for machine health scripts?▼

The expected directory layout for machine health scripts follows the machines/<class>/scripts/ path. This Skill locates and executes health.sh for Linux/macOS or health.ps1 for Windows classes within this exact structure.

Does the health verification process support both Windows and Linux operating systems?▼

Yes, health verification supports both Windows and Linux/macOS machine classes. It automatically resolves and executes the appropriate health.ps1 or health.sh script based on the specified machine class.

What happens if a machine health check script is missing or fails?▼

If a machine health check script is missing or fails, the process stops immediately and mandates a non-zero exit. It reports this condition clearly without fabricating data, ensuring accurate remote diagnostics.

How are pass, warn, and fail statuses parsed from the health check output?▼

Pass, warn, and fail statuses are parsed by passing through the script output verbatim and appending standardized summary lines. This ensures you see the raw diagnostic data alongside the final PASS/WARN/FAIL result.