system-health

Identify and report health status of the Switchyard orchestration stack.

Updated Sep 22, 2025
One-click install
npx skills add https://github.com/tinkermonkey/switchyard --skill system-health-tinkermonkey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-health
Source: https://github.com/tinkermonkey/switchyard/tree/main/.claude/skills/system-health
Command: npx skills add https://github.com/tinkermonkey/switchyard --skill system-health-tinkermonkey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Switchyard health skill provides automated, end-to-end visibility into the health of the orchestrator and its components. It consolidates status checks across critical subsystems (Redis, Docker, API endpoints, task queues, and active pipeline runs) to surface uptime, errors, and performance bottlenecks before they impact delivery.

Core Features & Use Cases

  • Comprehensive health checks: verifies core endpoints, agent activity, task queues, circuit breakers, and active pipeline runs.
  • Observability glue: aggregates data from Redis, Docker, Elasticsearch, and the observability API to present a unified health view.
  • Remediation guidance: provides actionable findings and recommended mitigations to stabilize systems during incidents.

Quick Start

Run the system-health skill to generate a live health report of the orchestrator.

Frequently Asked Questions about system-health

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

FAQPage Schema
How do I check the health status of my orchestrator stack across Redis, Docker, and API endpoints?

To check the health of your orchestrator stack, run a system health check that verifies core endpoints, agent activity, task queues, and circuit breakers. It aggregates status data from Redis, Docker, and Elasticsearch to surface uptime, errors, and performance bottlenecks.

What is the best way to monitor pipeline runner uptime and task queue errors in a Switchyard environment?

The best way to monitor pipeline runner uptime and task queue errors is to run an automated health check that consolidates status checks across active pipeline runs and task queues, providing a structured report with actionable findings and recommended mitigations.

How do I generate a live health report for my orchestration components?

You generate a live health report for your orchestration components by running the system-health skill, which immediately scans critical subsystems like Redis, Docker, API endpoints, and pipeline runners to provide a unified health view with remediation guidance.

Does the health check provide remediation guidance for performance bottlenecks and circuit breaker failures?

Yes, the health check provides remediation guidance for performance bottlenecks and circuit breaker failures by aggregating observability data across critical subsystems and delivering actionable findings with recommended mitigations to stabilize systems during incidents.

Why do I need to aggregate observability data from Redis and Elasticsearch for orchestration health checks?

You need to aggregate observability data from Redis and Elasticsearch for orchestration health checks because these systems store the task queue states and logs required to surface hidden errors, track uptime, and identify performance bottlenecks across the stack.