infra-health

Check container status, Uptime Kuma monitors, Prometheus alerts, and endpoints.

1|1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill infra-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: infra-health
Source: https://github.com/trevorbyrum/claude-skills-suite/tree/main/skills/infra-health
Command: npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill infra-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a rapid, deterministic check of critical infrastructure and service health, ensuring all components are operational after deployments or restarts.

Core Features & Use Cases

  • Comprehensive Status Sweep: Checks container statuses, Uptime Kuma monitors, Prometheus alerts, and key service endpoints.
  • Targeted Checks: Can optionally filter checks to a specific service if a name is provided.
  • Use Case: After deploying a new version of the gateway service, run infra-health gateway to confirm it's running, accessible, and not triggering any alerts.

Quick Start

Run a full infrastructure health check across all services.

Frequently Asked Questions about infra-health

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

FAQPage Schema
How do I verify homelab infrastructure health after a deployment?

Verify homelab infrastructure health by running a deterministic sweep of container statuses, Uptime Kuma monitors, Prometheus alerts, and key endpoints to ensure all services are operational post-deployment.

What does a comprehensive service status check include for homelab containers?

A comprehensive service status check includes verifying container statuses, monitoring Uptime Kuma endpoints, evaluating Prometheus alerts, and testing key service endpoints like gateways and databases.

Can I run a targeted health check on a specific service like a gateway or database?

Yes, you can run a targeted health check by providing a specific service name, filtering the status verification to confirm that individual gateways, databases, or APIs are running and accessible.

Do I need Docker and Prometheus integrations to check service status?

Yes, checking service status requires integration with Docker, Uptime Kuma, Prometheus, Homelab Tools MCP, and SSH to perform remote checks and verify operational components.

What is the best way to confirm operational status and no active alerts after a restart?

The best way to confirm operational status after a restart is executing a deterministic health check that verifies container states and ensures no Prometheus alerts are triggering.