system-health

system-health is a skill for Claude Code from randomittin/heimdall. It costs 102 tokens per session (1,884 once invoked), scanned A, original, MIT.

A read-only adviser that checks whether a computer is under disk or memory pressure and whether Heimdall has created many orphaned background Python processes. It suggests what to investigate or clean up but does not delete files or stop processes by itself.

In plain words
What is it for?
Use it at the start of a long session or when the machine is slow, memory is exhausted, or system storage is full.
Why use it?
It helps explain slow performance, swapping, or a full disk before any cleanup is attempted. It can also reveal when Heimdall itself is contributing to the problem.

Skill for Claude Code

Written for Claude Code: SessionStart hook event. Also seen: reads .claude/ paths.

Part of the hmd plugin — 6 skills, 19 commands, 16 agents, 7 hooks, 1 MCP server shipped together

Good fit Use it at the start of a long session or when the machine is slow, memory is exhausted, or system storage is full.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/randomittin/heimdall/system-health
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add randomittin/heimdall --skill system-health
Clone the repo
git clone --depth 1 https://github.com/randomittin/heimdall

Made for: Claude Code.

Or install hmd, the plugin that ships this one along with the rest of its 6 skills, 19 commands, 16 agents, 7 hooks, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for system-health

README.md
[![agentmods](https://agentmods.dev/badge/skills/randomittin/heimdall/system-health/github.svg)](https://agentmods.dev/skills/randomittin/heimdall/system-health)
Your own site
<a href="https://agentmods.dev/skills/randomittin/heimdall/system-health"><img src="https://agentmods.dev/badge/skills/randomittin/heimdall/system-health/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for system-health

Your own site · 80×15
<a href="https://agentmods.dev/skills/randomittin/heimdall/system-health"><img src="https://agentmods.dev/badge/skills/randomittin/heimdall/system-health.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,884 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00102 $0.01884
Opus 5 $0.00051 $0.00942
Sonnet 5 $0.00020 $0.00377
Haiku 4.5 $0.00010 $0.00188

Measured 8d ago against content hash de28090db066, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

system-health scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/system-health/SKILL.md · 124 lines

How it starts

The opening of the file, as written. The whole thing — 124 lines — stays where its author put it; the contents beside it link to each section on GitHub.

system-health

A read-only advisor: does this machine need a cleanup, and is Heimdall causing it? It grades disk + memory pressure, counts Heimdall's own leaked python, and SUGGESTS the fix. It never deletes or kills anything unless you explicitly ask for the scoped self-reap.

Pairs with mac-deep-clean (the executor that actually reclaims disk) — a separate, user-installed skill, NOT bundled with Heimdall. This skill is the trigger — the thing that notices you need it — and it checks whether mac-deep-clean is actually installed (~/.claude/skills/mac-deep-clean/SKILL.md or the project-level equivalent) before ever naming it, falling back to plain read-only investigation commands when it's absent.

Why this exists (the lesson it encodes)

A long Heimdall session leaks background python: the presence keeper's presence-doctor spawns mock_cp.py (a mock control-plane) children that get orphaned to launchd (ppid 1) and are never reaped. One session accumulated ~692 of them, pinning all 16G of RAM and thrashing swap 17G/17G. heimdall-gc reaps orphaned keeper pidfiles, but NOT these launchd-reparented children (nothing tracks them) — so they slip the collector. Most of a real cleanup session was just purging these do-nothing python procs. This advisor is the check that catches them early.

Run it — the unified core (both axes at once)

bin/heimdall-cleanup is the ONE entrypoint that covers BOTH axes — MEMORY (RAM/swap + hmd's orphan leak) and DISK (hmd's own reclaimable garbage). It ORCHESTRATES the two reapers below; it never re-implements them. Reach for it first:

heimdall-cleanup           # report (DEFAULT, read-only): unified health + reclaimable-now MB
heimdall-cleanup --json    # {severity, memory, disk, procs, reclaim} for programmatic use
heimdall-cleanup --apply   # reap hmd's OWN garbage only (orphaned hmd python + gc disk)
heimdall-cleanup --deep    # SUGGEST-only handoff to mac-deep-clean (confirm-gated, nothing auto)

Read the full file on GitHub · 124 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 124 lines · 102 tokens per session scan A de28090db066

Subscribe to this mod's changes

system-health is a skill published in the GitHub repository randomittin/heimdall (5 stars, last pushed 2d ago), licensed MIT. It adds 102 tokens to every session and 1,884 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

atomic-debug

Hypothesis-driven debugging skill. Use when a bug, test failure, crash, or unexpected behavior is reported. Auto-trigger on error pastes or "broken/doesn't work/failing" language. Explicit invocation: /atomic-debug. Output: symptom statement → hypothesis table → cheapest test first → root cause. No symptom-patching.…

damusix/atomic-claude · 114 tokens

memstack-development-performance-audit

Use this skill when the user says 'performance audit', 'why is it slow', 'optimize performance', 'page speed', 'Core Web Vitals', 'lighthouse', 'load time', or needs to diagnose and fix frontend or backend performance issues. Do NOT use for code reviews or security audits.

cwinvestments/memstack · 69 tokens

atomic-writing

One voice for every file the repo ships: README, docs/guides/, docs/reference/, docs/spec/, docs/design/, docs/research/, docs/wiki/, CLAUDE.md, and the prompt artifacts under commands/, agents/, skills/, rules/, and output-styles/. Clear, direct, technical, and visual wherever the content has a shape. No marketing…

damusix/atomic-claude · 268 tokens

atomic-documentation

Diff-driven documentation surface classifier. Given a diff (staged, branch, or range), reads the project's indexed ## Documentation surfaces table from CLAUDE instructions, matches the diff against it, and emits a structured list of proposed edits. Two modes: maintenance (commit flow — stale/incomplete only, never…

damusix/atomic-claude · 169 tokens

atomic-visual-options

Planning-phase visual comparison aid. Renders 2-4 side-by-side variants per decision dimension as a single throwaway, self-contained HTML file and captures the user's pick as typed terminal codes (e.g. "A2 B3"). Auto-fires on phrases like "show me a few options", "mock up some variants", "let me see this side by…

damusix/atomic-claude · 150 tokens

atomic-git-discipline

Compressed commit message and PR body generator. Cuts noise from both while preserving intent and reasoning. Conventional Commits format. Subject ≤50 chars, body only when "why" isn't obvious; PR bodies state only what the diff can't show, 120 words max. Use when user says "write a commit", "commit message", "generate…

damusix/atomic-claude · 106 tokens