skills.rest
CodeAlive-AI
CodeAlive-AIOFFICIAL
Explore all skills by this author →
WebsiteGitHub

maintaining-macos-health

Triage macOS disk and memory incidents and apply user-approved cleanup commands.

119|10|Updated Jan 16, 2026
Search Tags:#macos#incident response#interactive ui#disk cleanup#memory pressure#launchagent#safety validation
One-click install
npx skills add https://github.com/CodeAlive-AI/ai-driven-development --skill maintaining-macos-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintaining-macos-health
Source: https://github.com/CodeAlive-AI/ai-driven-development/tree/main/skills/maintaining-macos-health
Command: npx skills add https://github.com/CodeAlive-AI/ai-driven-development --skill maintaining-macos-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps when an Apple Silicon macOS dev machine gets into a failure pattern where low disk space and memory pressure escalate into freezes, reboots, and watchdog-timeout panics. It prevents “clean-up” work from becoming guesswork by combining signal triage, safety-guarded cleanup planning, and an explicit user approval step.

Core Features & Use Cases

  • Signal triage playbook: classifies incidents (disk pressure, memory pressure, kernel panic, JetsamEvent vm-compressor-space-shortage) and selects an appropriate cleanup tier.
  • Interactive cleanup UI (local-only): renders scan results as a categorized HTML checklist with tooltips and a single selection JSON as the source of truth.
  • Sanctioned apply step with validation: applies only the user-selected commands and blocks unsafe/protected paths using Mole-style safety checks.
  • Proactive LaunchAgent alerter: sends CRITICAL-only notifications with hysteresis, cooldown, and a 7-day calibration window to avoid alert fatigue.

Quick Start

Tell your AI agent: “I’m getting ‘Mac is full’ and my disk is under 20%—run the maintaining-macos-health triage, open the cleanup plan UI, and apply only what I select after I confirm go.”

Frequently Asked Questions about maintaining-macos-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely free up disk space on macOS when memory pressure causes freezes?▼

MacOS disk cleanup during memory pressure involves triaging root signals like kernel panics, rendering an interactive local HTML cleanup checklist, and applying only user-validated deletion commands with protected-item enforcement to prevent unsafe removals.

What causes JetsamEvent vm-compressor-space-shortage on Apple Silicon and how do I fix it?▼

A JetsamEvent vm-compressor-space-shortage on Apple Silicon indicates escalating memory pressure causing watchdog-timeout panics. This Skill classifies the incident, selects a cleanup tier, and guides you through a safety-guarded deletion plan to recover machine stability.

Can I set up proactive alerts for low disk space on macOS using LaunchAgent?▼

You can set up proactive LaunchAgent alerts for low disk space on macOS that trigger CRITICAL-only notifications with hysteresis, cooldown intervals, and a 7-day calibration window to prevent alert fatigue under heavy workloads.

Is manual command line cleanup safer than using an interactive macOS cleanup plan?▼

An interactive macOS cleanup plan is safer than manual command line deletion because it enforces Mole-style path validation, blocks protected items, and requires explicit user confirmation through a structured selection JSON before applying any deletion commands.

What should I do when my macOS dev machine triggers a kernel panic from disk pressure?▼

When disk pressure triggers a kernel panic on your macOS dev machine, run a signal triage playbook to classify the incident. This Skill then generates a local-only HTML planning interface for you to select safe cleanup actions before applying validated commands.

Related Skills

Explore More Software Engineering Skills→
Lifecycle-Innovations-LimitedLifecycle-Innovations-Limited
22

ops-speedup

Automate OS-level health diagnostics and cleanup across macOS, Linux, WSL, and Windows.

Official
Intermediate
nonlinearnonlinear

notify

Detect macOS user idle state and route task notifications to chat or Telegram.

Community
Basic
GDKennellGDKennell

disk-cleanup

Identify large and stale files on macOS and reclaim disk space safely.

Community
Advanced
791994545791994545
4

macos-cleaner

Analyze macOS disk usage and provide cleanup recommendations using the Mole CLI.

Community
Advanced