What does this skill do?

The Claude Skill Cleanup scans your ~/.claude folder for redundant, obsolete, or orphaned skills, hooks, permissions, MCP servers, and caches. It presents each candidate in a numbered table along with supporting evidence and waits for your individual confirmation before performing a gentle, reversible deletion, recording each action in a maintenance log.

Complete audit of ~/.claude
Scan skills, memory, hooks, permissions, MCP servers, reminders, project history, and caches in a single pass.
Detection of Orphan Hooks
Identifies hook scripts present on disk but not referenced in settings.json or settings.local.json.
Redundant permissions
Find duplicate permissions or specific entries already covered by a wildcard in settings.local.json.
Gentle and reversible erasure
Rename it to .disabled, move it to _gc_trash, or edit the JSON file after making a backup. Nothing is permanently deleted without your command.

Usage examples

🧹 General Cleaning
Clear my Claude settings, scan all channels, and show me the obsolete candidates.
🪝 Hooks Only
Check my hooks in ~/.claude and detect any orphaned scripts that aren't referenced in settings.json.
🔐 Duplicate permissions
Search for redundant permissions in settings.local.json, including those covered by Bash wildcards (*).
📦 After installing skills
I just installed a large set of skills; please resolve any overlaps with what I already had.

Features

Multichannel scanning Check skills, memory, hooks, permissions, MCP servers, reminders, history, and caches at runtime.
Prioritization Based on Trust Mark broken or orphaned elements as high priority and simply outdated ones as low priority.
Element-by-element verification There's no such thing as "yes" to everything: each candidate presents evidence and a prompt [y/n/skip].
Soft erase with reversible logo Rename to .disabled, move to _gc_trash, or edit the JSON file with a backup. Log everything to gc_log.md with instructions on how to undo the changes.
Compatible with jq and BSD Use jq to edit permissions and du -k (macOS/BSD-compatible) to measure old caches.

Frequently asked questions

No. Por defecto hace borrado suave: renombra a .disabled, mueve a _gc_trash/<fecha>/ o edita JSON con respaldo previo. Solo borra definitivo si lo pides explícitamente.
Claude Code or Cowork and access to your ~/.claude folder. To edit JSON permissions, use jq, which must be installed on your system.
Yes. Every action is logged in ~/.claude/gc_log.md with a timestamp, the items affected, the reason, and exact instructions for reverting the changes.
We recommend performing a preventive check every 30 days, or after installing large skill and experiment packages that have left behind unused permissions or MCPs.
Claude Configuration Cleanup — Clean up your ~/.claude directory with Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.