← ClaudeAtlas

os-health-checklisted

Trigger with "run health check", "check os metrics", "system monitor", or when the user wants to review the Agentic OS liveness metrics across the Event Bus, locks, and memory arrays. Scans context/events.jsonl, os-state.json, and context/memory.md deterministically via kernel.py — no conversational judgment required. Migrated from the former os-health-check agent (2026-09-05): deterministic Bash+Read diagnostic, no interview, no adversarial judgment — fits the skill archetype, not the agent archetype.
richfrem/agent-plugins-skills · ★ 6 · AI & Automation · score 74
Install: claude install-skill richfrem/agent-plugins-skills
<example> <commentary>User explicitly requested a system diagnostic.</commentary> user: "Run a system monitor check on the OS." assistant: Scans the event bus and state file, compiles liveness metrics, and reports them. </example> ## Dependencies This skill requires **Python 3.8+** and standard library only. No external packages needed. # OS Health Check Scan across the `context/events.jsonl` Event Bus stream, review `os-state.json` liveness, and compile system metrics without mutating user files. ## Execution Flow ### Phase 0: Intent Emission (Event Bus) ```bash python3 scripts/kernel.py emit_event --agent os-health-check --type intent --action scan_metrics ``` ### Phase 1: Context Gathering & OS State Lock ```bash python3 scripts/kernel.py state_update active_agent os-health-check python3 scripts/kernel.py acquire_lock monitor ``` If the lock acquisition fails, abort — the kernel handles stale lock cleanup automatically (see `os-clean-locks` if a stale lock persists). ### Phase 2: Analyze Event Bus Inspect the recent Event Bus (`tail -n 100 context/events.jsonl`) and calculate metrics: total intent vs. result events, hook error count (also check `context/memory/hook-errors.log`), and any agent that emitted `intent` without a matching `result` (crash signal). ### Phase 3: Inspect Memory & File Health Check `context/memory.md` length (`wc -l`), scan `context/.locks/` for leaked stale locks, and determine whether `memory_gc_due` should be flagged. ### Phase 3.5: