skills.rest
bonjohen
bonjohenCOMMUNITY
Explore all skills by this author →
GitHub

healthcheck-machine

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
One-click install
npx skills add https://github.com/bonjohen/claude-local --skill healthcheck-machine
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
89jobrien89jobrien
1

1password-tailscale

Coordinate 1Password credentials with Tailscale for SSH connections.

Community
Intermediate
AAbdulghanyAAbdulghany

monitoring-audit

Audit logs, metrics, traces, health endpoints, and alerting for observability gaps.

Community
Advanced
tdhoppertdhopper
22

home-network-admin

Manage and troubleshoot a home network via SSH, NAS, Tailscale, and Caddy.

Community
Intermediate
markwang2658markwang2658
31

parallel-cli

Automate web search, extraction, and research workflows via a vendor CLI.

Community
Advanced