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.
npx skills add CodeAlive-AI/ai-driven-development --skill maintaining-macos-healthgit clone --depth 1 https://github.com/CodeAlive-AI/ai-driven-developmentWrote 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.
[](https://agentmods.dev/skills/codealive-ai/ai-driven-development/maintaining-macos-health)<a href="https://agentmods.dev/skills/codealive-ai/ai-driven-development/maintaining-macos-health"><img src="https://agentmods.dev/badge/skills/codealive-ai/ai-driven-development/maintaining-macos-health.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00157 | $0.04850 |
| Opus 5 | $0.00078 | $0.02425 |
| Sonnet 5 | $0.00031 | $0.00970 |
| Haiku 4.5 | $0.00016 | $0.00485 |
Grade A, and why
maintaining-macos-health scanned grade A with 1 finding 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 2d 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.
Asks for rootlowPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
| `references/never-touch.md` | Categories that **must not** be deleted even under sudo (Mole-derived blacklist + incident-derived additions) | Downgraded: this mod is about security review, or the phrase is quoted, so it is likely naming the pattern rather than instructing it.
How it starts
The opening of the file, as written. The whole thing — 176 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Maintaining macOS Health
Recovery and prevention playbook for macOS disk and memory crises. Validated against a real watchdog-timeout kernel panic on Apple Silicon caused by vm_compressor segments saturated to 100 % with the disk over 90 % full. The same playbook works for routine cleanup or first-time setup on a new machine.
Table of contents
- When to use
- Skill layout
- Core mental model
- Standard workflows
- Safety rules (non-negotiable)
- Domain quirks captured
- Outcomes scale
When to use
Trigger on any of:
- Disk free < 20 % or user complains about being out of space
- Watchdog-timeout / kernel panic / "no checkins from watchdogd"
- New
JetsamEvent-*.ipswithvm-compressor-space-shortage - "Mac is slow", swap > 6 GB, sustained Critical memory pressure
- A process persistently consumes a core, or the whole machine stays CPU-saturated
- User wants to set up monitoring/alerting from scratch
- Migration to a new Mac → restore the same alerter
- General "clean my Mac" / "audit storage" / "free space" requests
Skill layout
| File | Use for |
|---|---|
references/triage.md |
First 5 minutes — which signal fired, which tier of cleanup to start with |
references/cleanup-tiers.md |
Tiered cleanup playbook (10 tiers, zero-risk → discuss-first), copy-paste-safe shell blocks |
references/never-touch.md |
Categories that must not be deleted even under sudo (Mole-derived blacklist + incident-derived additions) |
references/mole-techniques.md |
What Mole does that we borrow: marker→target map for mo purge, safe-path validators, age thresholds |
references/alerting.md |
Full alerter design: disk/memory/Jetsam critical triggers plus sustained CPU anomaly detection, incident lifecycle, hysteresis, notifier choices, install/restore commands |
references/optional-disk-responses.md |
First-use offer, installation and operation of two independent opt-ins: emergency Mole cache cleanup below 2%, and a Codex cleanup plan/page at or below 5% with exact-session continuation. |
assets/mac-health-disk, assets/disk_*.py |
Consent-gated disk controller, deterministic inventory, restricted Codex runner and authenticated local selection/confirmation page. Both modes default off. |
assets/mole-exact-file.sh, assets/mole-core-1.39.0.json |
Compatibility-pinned exact-file adapter to Mole; no general mo clean, sudo, or shell commands from the agent. |
assets/mac-health-check |
Production-ready bash script (~250 lines, bash 3.2 compatible) |
assets/mac-health-action |
Background action dispatcher for read-only Codex/Claude investigations and explicitly confirmed graceful process stopping |
assets/com.local.mac-health-check.plist |
LaunchAgent plist with StartCalendarInterval (StartInterval is broken on laptops) |
assets/config.sh |
Default config with safe thresholds |
assets/render-cleanup-plan.py |
Interactive HTML cleanup-plan UI. Renders categorised checkboxes from a JSON of scan findings, serves on 127.0.0.1:18347, opens browser, waits for the user's selection, writes it to /tmp/cleanup-selection-<ts>.json. Used by Workflow A. |
assets/apply-cleanup-selection.py |
The only sanctioned way to apply a cleanup selection. Reads selected_items from a selection JSON and executes each item's command field. Enforces protected-override check + path validation + Mole-compatible operations log. Prevents drift between what the user picked and what gets deleted. Supports --dry-run. |
What ships with it
26 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- .gitignore 44 B
- assets/apply-cleanup-selection.py 10 KB runs code
- assets/com.local.mac-health-check.plist 2.2 KB
- assets/config.sh 2.7 KB runs code
- assets/disk_agent.py 7.5 KB runs code
- assets/disk_responses.py 19 KB runs code
- assets/disk_review.py 13 KB runs code
- assets/disk_safety.py 15 KB runs code
- assets/mac-health-action 15 KB
- assets/mac-health-check 27 KB
- assets/mac-health-disk 199 B
- assets/mole-core-1.39.0.json 344 B
- assets/mole-exact-file.sh 2.0 KB runs code
- assets/render-cleanup-plan.py 44 KB runs code
- docs/screenshot-tooltip.png 129 KB
- docs/screenshot.png 131 KB
- README.md 19 KB
- references/alerting.md 18 KB
- references/cleanup-tiers.md 15 KB
- references/mole-techniques.md 10 KB
- references/never-touch.md 27 KB
- references/optional-disk-responses.md 14 KB
- references/triage.md 6.7 KB
- tests/test_disk_responses.py 19 KB runs code
- tests/test-cpu-actions.sh 4.3 KB runs code
- tests/test-cpu-monitor.sh 6.4 KB runs code
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.
- 2d ago Changed · +19 lines 0dbde11adc75
- 7d ago First seen · 157 lines · 157 tokens per session scan A 405f8e7331b8
maintaining-macos-health is a skill published in the GitHub repository CodeAlive-AI/ai-driven-development (132 stars, last pushed today), licensed MIT. It adds 157 tokens to every session and 4,850 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
agenttrace-session-audit
Audit local AI coding-agent sessions with agenttrace for cost, tool failures, latency, anomalies, health, diffs, and CI gates.
intuitive-preflight
Turn a vague task, plan, issue, or "LGTM/go ahead" request into an approval-ready preflight contract before implementation starts. Use when the user wants prompt preflight, clearer scope, non-goals, context package, acceptance criteria, definition of done, verification, stop gates, the exact execution command, or…
intuitive-squash
Squash local GSD or agent-generated commit history into a clean, reviewable story while preserving important fixes. Use when the user asks to squash commits, clean git history, compress phase commits, prepare a branch before PR, compare aggressive vs moderate squash options, or preserve hotfix/security commits during…
intuitive-refactor
Refactor and cleanup router for known code/module/API seams, stale surfaces, compatibility shims, architecture cleanup targets, changed-code quality review, oversized modules, repeated cleanup campaigns, and recurring whole-repo architecture maintenance goals. Use this when the user names a concrete seam, wants…
antigravity-workflows-v2
Antigravity Workflows workflow skill. Use this skill when the user needs Orchestrate multiple Antigravity skills through guided workflows for SaaS MVP delivery, security audits, AI agent builds, and browser QA and the operator should preserve the upstream workflow, copied support files, and provenance before merging…
reviewer
Philosophical guardrails enforcer — independently audits code, tests, and spec for layered-integrity, Why>What, error-as-data, and the related Ironclad philosophical invariants. Activate only when the connected project contains spec.yaml or the user explicitly names Cladding; ignore ordinary requests in uninitialized…