system-health-checker

System Health Checker

Evaluates service health endpoints and produces formatted status reports.

When to Use

This skill is triggered when the user asks to "check system status" or "verify service health".

When NOT to Use

• Don't use this for detailed monitoring or alerting — use a dedicated monitoring skill instead
• Not for deploying or restarting services; this is read-only status checking
• Avoid using this for historical trend analysis

Dependencies

• curl: HTTP client for API requests (curl --version to verify)
• jq: JSON parser (which jq to verify installation)
• Environment variable: API_KEY (obtain from the service dashboard)

Installation

# Install curl (if not present)
sudo apt-get install curl  # Ubuntu/Debian
brew install curl          # macOS

# Install jq
sudo apt-get install jq    # Ubuntu/Debian
brew install jq            # macOS

# Set API key
export API_KEY="your_api_key_here"

Workflow

1. Validate dependencies are available
2. Check API key is configured
3. Make API call to health endpoint
4. Parse response and format for user
5. Handle any errors gracefully

• Verify curl and jq are installed
• Confirm API_KEY is set
• Check endpoint responds

Example commands:

# Check if dependencies are available
command -v curl >/dev/null 2>&1 || echo "curl not found"
command -v jq >/dev/null 2>&1 || echo "jq not found"

# Make the API call
if ! response=$(curl -s -H "Authorization: Bearer $API_KEY" \
     -H "Accept: application/json" \
     "https://api.example.com/health"); then
  echo "Error: API call failed"
  exit 1
fi

echo "$response" | jq '.status'

Input/Output

Input: User request like "check system status" Output: Formatted status report with:

• Service status (online/offline)
• Response time
• Any alerts or issues

Error Handling

You must always check for errors. Consider retrying on transient failures.

Common issues and solutions:

• No API key: Prompt user to configure API_KEY environment variable
• Service unavailable: Return cached status if available, otherwise inform user
• Network timeout: Retry once, then report network issue
• Invalid response: Log raw response and return "Unable to parse status"