SkillAgentSearch skills...

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.

Install / Use

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill health-check

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Category

Operations

Supported Platforms

Claude Code

Our assessment of health-check

health-check scores 88/100 on our quality scale, 410th of 753 Operations skills we index.

Its SKILL.md is 2.8 KB long, well organised into 11 sections with 4 code examples: a solid amount of guidance for an agent.

With 1,015 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so health-check is actively maintained.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

health-check compared with similar skills

All 4 of these similar skills score higher than health-check; compare them before choosing.

SkillScoreStarsUpdatedFormat
health-check (this skill)by hoangsonww881.0k55d agoSKILL.md
Agent-Reachby Panniantong100112.7k10d agoCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
Scraplingby D4Vinci100103.9ktodayMCP Server
crawl4aiby unclecode10087.5ktodayMCP Server

Frequently asked questions

How do I install health-check?
Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill health-check. The install tabs above show the steps for each supported agent.
Which AI agents does health-check work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is health-check safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is health-check still maintained?
The repository was last updated about 2 months ago, so health-check is actively maintained.

name: health-check description: > 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.

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.

Related Skills

View on GitHub
GitHub Stars1.0k
CategoryOperations
Updated1mo ago
Forks238

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions