Skip to content
cccskills
FreePublished on GitHub

health-check

Run comprehensive health checks on the Claude Code Agent Monitor system. Validates dashboard API, database, WebSocket, hooks, and disk usage. Use to verify the monitoring setup is working correctly.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (2)

  • SKILL.md3.1 KB
  • agents/openai.yaml261 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Health Check

Run a comprehensive health check on the Agent Monitor system.

Input

The user provides: $ARGUMENTS

This may be:

  • "full" or empty (default: run all checks)
  • "quick" for a fast connectivity check
  • "deep" for extended checks including database integrity

Procedure

Run health checks in this order:

1. API Health

curl -sf http://localhost:4820/api/health
  • Verify HTTP 200 response
  • Check response time (<500ms expected, <1000ms acceptable)
  • Confirm JSON response body

2. Database Health

curl -sf http://localhost:4820/api/stats
  • Verify stats endpoint returns valid data
  • Check that counts are non-negative integers
  • Verify database file exists and has reasonable size

3. WebSocket Health

  • Check that the WebSocket server is listening
  • Verify WebSocket upgrade is supported on the dashboard port

4. API Endpoint Validation

Test each major endpoint:

curl -sf http://localhost:4820/api/sessions?limit=1
curl -sf http://localhost:4820/api/events?limit=1
curl -sf http://localhost:4820/api/analytics
curl -sf http://localhost:4820/api/pricing
curl -sf http://localhost:4820/api/settings/info

5. Hook Integration

  • Verify hook handler script exists
  • Check hooks are configured in ~/.claude/settings.json
  • Verify the handler script targets the correct dashboard URL

6. Disk & Resource Usage (deep mode only)

  • Database file size
  • Log file sizes (if any)
  • Available disk space
  • Node.js process memory usage (if accessible)

7. Data Freshness

  • Time since last event ingested
  • Time since last session created
  • Check for stale active sessions (active but no events in >1 hour)

Output Format

Present as a system health dashboard:

╔══════════════════════════════════════════════╗
║   AGENT MONITOR HEALTH CHECK                ║
║   Timestamp: 2025-04-11 12:00:00 UTC        ║
╠══════════════════════════════════════════════╣
║                                              ║
║   API Server ............ ✅ OK (45ms)       ║
║   Database .............. ✅ OK (2.4 MB)     ║
║   WebSocket ............. ✅ OK              ║
║   API Endpoints ......... ✅ 6/6 passing     ║
║   Hook Integration ...... ⚠️ 5/7 hooks      ║
║   Data Freshness ........ ✅ 3m ago          ║
║                                              ║
║   Overall: HEALTHY (5/6 checks passed)       ║
║                                              ║
╚══════════════════════════════════════════════╝

For any non-passing check, include detailed explanation and remediation steps below the dashboard.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Inspect fired CCAM alerts and manage alert rules for token thresholds, event patterns, inactivity, and status duration. Use when acknowledging alerts, creating or editing a rule, checking cooldowns, or connecting alert rules to webhook targets.

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

Identify anomalous sessions using Agent Monitor data — cost outliers from the pricing engine, token anomalies (cache miss spikes, compaction baseline surges), unusual event type ratios (PreToolUse/PostToolUse gaps, APIError clusters), behavioral deviations from workflow intelligence (complexity score outliers, error propagation anomalies), and sessions with abnormal metadata (extreme turn_count, high thinking_blocks, zero turn_duration).

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

Produce a detailed report on APIError events from Agent Monitor data — counts over time, which sessions and models are affected, and the likely root cause (rate limits, overload/529, or context-window pressure) inferred from each event's summary and data payload. Use when API errors spike or when you need to explain why requests are failing.

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

Benchmark one session (or a small recent set) against the rolling average using Agent Monitor data — cost, total tokens, tool count, and workflow complexity score — and report where each metric lands as a percentile of the population. Tells you whether a session was normal, cheap, or an outlier. Use when judging whether a session was typical or out of band.

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard. Reads current spend from /api/pricing/cost to size the budget sensibly and explains every rule field before writing. Use when setting a spend limit or wiring up a budget guardrail.

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

Analyze prompt-cache effectiveness for Claude Code usage from the Agent Monitor dashboard — cache hit rate (total_cache_read / (total_cache_read + total_input)), cache_write vs cache_read reuse, cache-read vs cache-write spend, and the sessions with the poorest reuse. Pulls token totals from /api/analytics, per-session detail from /api/sessions, and dollar splits from /api/pricing/cost. Use when diagnosing cache spend or deciding whether prompt caching is paying off.

The English summary is being prepared. Showing the original description.

hoangsonww/Claude-Code-Agent-Monitor1.1KUpdated Oct 23, 2026

See all skills by hoangsonww

Report a problem with this skill