skill-organizer

Organize & declutter your AI agent skills — scan, classify and index every installed skill, detect duplicates and dead skills, and generate a SKILLS_INDEX.md you can commit and share.

Works with any agent that stores skills as folders with a SKILL.md frontmatter: Claude Code / Codex / Cursor / WorkBuddy / and more.

What it does

• Scan all skill sources — user-installed, connectors, built-in plugins
• Classify each skill into 常用 (frequently used) / 备用 (occasional) / 建议删除 (recommend delete)
• Detect duplicates, dead shells, broken frontmatter, leftover .zip / .json files
• Generate a SKILLS_INDEX.md index — one line per skill, with a health check report

Install

Copy the skill-organizer/ folder into your agent's skills directory:

# WorkBuddy / Claude Code style
cp -r skill-organizer ~/.workbuddy/skills/
# or wherever your agent loads skills from

Use

Just say "整理技能 / 盘点技能 / organize my skills", or scan manually:

python skill-organizer/scan_skills.py          # scan all sources
python skill-organizer/scan_skills.py user     # scan user skills only

What's inside

• skill-organizer/SKILL.md — skill definition (triggers, workflow, classification rules, health checks)
• skill-organizer/scan_skills.py — scans skills, extracts name + description (handles YAML block scalars)
• SKILLS_INDEX.md — example personal skills index

Safety

• "Suggest delete" only marks entries — it never deletes files.
• Actual deletions are backed up first and fully reversible.