skill-cleaner

Audit Claude Code skills for unused entries, duplicates, and description length.

13|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/philoserf/claude-code-config --skill skill-cleaner-philoserf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-cleaner
Source: https://github.com/philoserf/claude-code-config/tree/main/skills/skill-cleaner
Command: npx skills add https://github.com/philoserf/claude-code-config --skill skill-cleaner-philoserf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rg.

What problem does it solve?

Audits user-level Claude Code skills under ~/.claude/skills/ for hygiene issues such as unused entries, duplicate names, missing descriptions, and overly long descriptions; it guides pruning rather than deleting without confirmation.

Core Features & Use Cases

  • Audits skills under the user-level directory to identify unused entries, duplicates, and missing or long descriptions.
  • Generates a Markdown-style report highlighting Unused, Duplicates, Missing description, and Longest descriptions to inform cleanup decisions.
  • Use Case: run the cleaner during periodic skill hygiene sessions to keep your skill set focused and up to date.

Quick Start

Run the cleaner to generate an audit of your skills.

Frequently Asked Questions about skill-cleaner

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

FAQPage Schema
How do I audit Claude Code skills for unused entries and duplicates?

Skill hygiene involves auditing user-level Claude Code skills under `~/.claude/skills/` to identify unused entries, duplicates, and missing or overly long descriptions. The cleaner reads `SKILL.md` frontmatter and scans transcripts to produce a Markdown report highlighting these issues for focused pruning.

What is skill hygiene and why do I need to prune Claude Code skills?

Skill hygiene involves auditing user-level Claude Code skills under `~/.claude/skills/` to identify unused entries, duplicates, and missing or overly long descriptions. The cleaner reads `SKILL.md` frontmatter and scans transcripts to produce a Markdown report highlighting these issues for focused pruning.

Do I need rg installed to audit skills under ~/.claude/skills/?

Yes, `rg` (ripgrep) is a required dependency for auditing skills under `~/.claude/skills/`. The cleaner uses it to scan transcripts for references to skills and identify unused entries during the hygiene audit process.

Can I check for missing or overly long descriptions in SKILL.md frontmatter?

Yes, you can check for missing or overly long descriptions in `SKILL.md` frontmatter. The cleaner reads each frontmatter to extract the name and description, then flags entries with missing descriptions and reports the longest descriptions to help you maintain concise skill metadata.

What's the best way to clean up duplicate and unused Claude Code skills?

The best way to clean up duplicate and unused Claude Code skills is to run the cleaner during periodic hygiene sessions. It generates a Markdown-style report with Unused, Duplicates, Missing description, and Longest descriptions sections to inform your pruning and update decisions without deleting entries without confirmation.