hygiene

Audits disk, notes vault, Claude config, and packages monthly with tiered deletion review.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/joydai2026-del/skills --skill hygiene-joydai2026-del
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hygiene
Source: https://github.com/joydai2026-del/skills/tree/main/hygiene
Command: npx skills add https://github.com/joydai2026-del/skills --skill hygiene-joydai2026-del

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Over time a development machine accumulates stale projects, orphaned files, vault drift, and outdated packages, and aggressive cleanup scripts have caused real data loss. This Skill runs a structured monthly sweep that finds reclaimable space and configuration rot while guaranteeing nothing is deleted without explicit owner approval. ## Core Features & Use Cases - Four-scope audit: Scans Disk (large folders, Docker.raw, caches, Downloads), Vault (registry drift, sync-conflict duplicates, inbox backlog), Claude config (skills health, stale memory, plans, worktrees, MCP entries), and Packages (brew/npm outdated reports). - Tiered review-only output: Classifies every finding as Safe to delete, Needs verification, or Keep, requiring all four safety checks (PATH, symlinks, shell config, launchd) before anything reaches the Safe tier. - Reversible deletion: Approved items move to a dated ~/.Trash folder (never rm -rf), with post-delete canary checks and a persistent monthly vault log of findings and actions. - Use Case: On the first Monday of the month, ask for a hygiene sweep to discover that Docker.raw is using 40 GB, three retired projects lack git remotes, and two vault registry rows point to deleted paths, then approve only the Safe tier for cleanup. ## Quick Start Run the monthly hygiene sweep on my machine and present the tiered findings report before deleting anything.

Frequently Asked Questions about hygiene

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

FAQPage Schema
How do I safely clean up disk space on my Mac?▼

Run a tiered hygiene sweep that classifies candidates as Safe, Needs verification, or Keep before any deletion. Approved items move to a dated ~/.Trash folder for 30-day reversibility instead of using rm -rf, and canary checks confirm PATH and symlinks still work afterward.

How to find and remove duplicate sync-conflict files in a notes vault?▼

Search for files matching the ' 2.md' pattern, then compare each against its base file with sha256 and diff. Byte-identical or proper-subset duplicates are safe to delete, while divergent ones need manual verification; never hide them with a blanket gitignore rule.

Why does deleting Docker data not free disk space on macOS?▼

Docker.raw is a sparse file whose logical size is huge but whose real usage is shown only by du, and docker system prune does not shrink it. Reclaim space by quitting Docker Desktop and deleting the raw file, or using Docker Desktop's Clean/Purge option.

Can I delete a folder that looks like a stale project?▼

Not without verification: a stale-looking name can hide an active SDK on PATH, a symlink target, a launchd working directory, or a repo with no remote backup. Check which, readlink, shell configs, launchctl, and git remote -v before classifying anything as deletable.

What are the limitations of automated cleanup scripts?▼

du misreports cloned files sharing blocks, Trash moves free nothing until emptied, and root-owned items cannot be moved by an agent. Judge wins by df before and after, and hand elevated deletions to a human as a single reviewed command.