mac-optimize SKILL.md skillA
mac-optimize from kylebrodeur/mac-optimize is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add kylebrodeur/mac-optimize/mac-optimize@v1.0Pins v1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- kylebrodeur/mac-optimize
- Path
skills/mac-optimize/SKILL.md- Versions recorded
- 7
- Latest version
- v1.0, committed Oct 4, 2026
- First version recorded
- Aug 13, 2026
- Size
- 10,049 bytes
- Repository stars
- 2
- License
- MIT
Diagnose and reclaim disk space, audit stray git worktrees, back up and prune Codex agent sessions, check SSD health, and stay ahead of memory pressure on a macOS dev machine that runs many AI coding agents. Use when the Mac is low on disk, filling up, low on memory, or feels slow; when the user says "clean up my mac", "free up space", "reclaim disk", "what's using my disk", "prune caches", "why is my mac slow", "find/clean git worktrees", "back up my codex sessions…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# mac-optimize Reclaim disk and keep a macOS coding-agent machine healthy — **without ever deleting work that isn't provably recoverable.** These machines fill up because every agent run appends to caches (npm, pnpm, uv, codex runtimes, editor workspace storage) that grow on write and never self-reclaim, plus stray git worktrees from parallel agent tasks. The tools do the work; this skill is the workflow and the guardrails. ## 1. Diagnose first (read-only) ``` diskreport ``` Shows the volume's free space, top consumers in `~/Library/Application Support` and `~/Library/Caches`, the dev/agent caches that regrow, and a REVIEW tier of large-but-real state (VS Code `workspaceStorage`, Claude `vm_bundles`). It also flags APFS local snapshots — the classic "invisible" disk sink. Never destructive. If the fixed buckets above don't explain the free-space gap (e.g. a big single file buried inside some app's `Application Support`), go wider: ``` diskreport --scan [PATH] # one-shot 'dust' walk of PATH (default $HOME); opt-in, walks the whole tree ncdu [PATH] # interactive instead — navigate, sort, delete in place ``` …
Read the whole file at its exact version.
How to install
mdr add kylebrodeur/mac-optimize/mac-optimize@sha256:7ab8c539d424eab6The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fthaq7sjtnzmabh2)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 7 versions of this file, between Aug 13, 2026 and Oct 4, 2026, about one every 9 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0 latest | 2026-10-04 | b34920c | 10,049 B | A | view · diff |
| v1.0 | 2026-09-04 | 93728c5 | 9,122 B | A | view · diff |
| v1.0 | 2026-08-24 | ca135a2 | 8,729 B | A | view · diff |
| v1.0 | 2026-08-23 | 24e3a39 | 8,080 B | A | view · diff |
| v1.0 | 2026-08-17 | 9e469f8 | 6,255 B | A | view · diff |
| v1.0 | 2026-08-17 | 3517901 | 5,897 B | A | view · diff |
| v1.0 | 2026-08-13 | 19a7d6d | 5,318 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10049 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
kylebrodeur/mac-optimize · 2 stars · license MIT · pushed 2026-10-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fthaq7sjtnzmabh2 GET https://markdownregistry.com/api/v1/resolve?ref=kylebrodeur/mac-optimize/mac-optimize GET https://markdownregistry.com/api/v1/blob/7ab8c539d424eab61bfefc3b8b6578a049102e131e896d620fd3ea048634a4b3
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.