Health Check Skill

Check the health and availability of HTTP/HTTPS endpoints with configurable timeouts and retries.

When to Use

✅ USE this skill when:

• "Check if this URL is up"

• "Test API endpoint health"

• "Monitor service availability"

• "Ping web services"

• "Verify HTTPS certificate"

• "Check response time"

When NOT to Use

❌ DON'T use this skill when:

• Complex API interactions ΓåÆ use http-request

• Browser testing ΓåÆ use browser-tools

• DNS lookups ΓåÆ use dig/nslookup

• Port scanning ΓåÆ use network tools

Commands

Basic Health Check

{baseDir}/health.sh <url> {baseDir}/health.sh https://api.example.com/health {baseDir}/health.sh http://localhost:3000

Check Multiple Endpoints

{baseDir}/health.sh https://api.example.com/health https://api.example.com/status {baseDir}/health.sh --file urls.txt

Timeout Configuration

{baseDir}/health.sh https://api.example.com --timeout 10 {baseDir}/health.sh https://api.example.com --connect-timeout 5 --read-timeout 10

Response Validation

{baseDir}/health.sh https://api.example.com/health --expect-status 200 {baseDir}/health.sh https://api.example.com/health --expect-status 200,201,301 {baseDir}/health.sh https://api.example.com/health --expect-body "ok" {baseDir}/health.sh https://api.example.com/health --expect-json '{"status":"ok"}'

SSL/TLS Options

{baseDir}/health.sh https://api.example.com --insecure {baseDir}/health.sh https://api.example.com --cert /path/to/cert --key /path/to/key

Output Formats

{baseDir}/health.sh https://api.example.com --format json {baseDir}/health.sh https://api.example.com --format short {baseDir}/health.sh https://api.example.com --format detailed {baseDir}/health.sh --file urls.txt --format table

Options

Option Description Default

--timeout SECS

Total request timeout 30

--connect-timeout SECS

Connection timeout 5

--read-timeout SECS

Read timeout 10

--retries N

Retry attempts 0

--expect-status CODES

Expected HTTP status codes 200

--expect-body REGEX

Expected response body pattern None

--expect-json PATH=VALUE

JSON path check None

--insecure

Skip SSL verification false

--cert FILE

Client certificate None

--key FILE

Client certificate key None

--format FORMAT

Output: short, detailed, json, table short

--file FILE

Read URLs from file None

--headers

Show response headers false

--follow-redirects N

Max redirects to follow 5

--parallel

Check URLs in parallel false

Output Formats

Short Format (default)

✅ https://api.example.com/health (200, 145ms)

Detailed Format

URL: https://api.example.com/health Status: 200 OK Response Time: 145ms DNS Time: 23ms Connect Time: 45ms TLS Time: 32ms Content-Type: application/json Content-Length: 234 Certificate: Valid (expires 2024-12-31)

JSON Format

{ "url": "https://api.example.com/health", "status": 200, "statusText": "OK", "responseTime": 145, "dnsTime": 23, "connectTime": 45, "tlsTime": 32, "headers": {...}, "certificate": { "valid": true, "expiresAt": "2024-12-31" }, "healthy": true }

Table Format

Examples

Quick health check:

{baseDir}/health.sh https://api.example.com/health

✅ https://api.example.com/health (200, 145ms)

Check with expected response:

{baseDir}/health.sh https://api.example.com/health --expect-body "healthy"

Check JSON response:

{baseDir}/health.sh https://api.example.com/health --expect-json ".status=ok"

Check multiple URLs from file:

urls.txt contains one URL per line

{baseDir}/health.sh --file urls.txt --format table

Monitor with retries:

{baseDir}/health.sh https://api.example.com --retries 3 --timeout 5

Check SSL certificate:

{baseDir}/health.sh https://api.example.com --format detailed | grep Certificate

Certificate: Valid (expires 2024-12-31)

Exit Codes

• 0: All checks passed

• 1: One or more checks failed

• 2: Invalid arguments

• 3: Network/DNS error

• 4: Timeout

Notes

• Uses curl for HTTP requests

• Supports HTTP/1.1 and HTTP/2

• Follows redirects by default (up to 5)

• Validates SSL certificates by default (--insecure to skip)

• Response time includes DNS, connect, TLS, and transfer

• Can check multiple URLs in parallel with --parallel