skills-governance — Claude Code skill: audit and clean up skills
skills-governance scans local skill folders, groups duplicates by name, and sorts skills into keep, disable, or archive.
no license ★ 475 updated 2026-10-13
npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a claude-codeWhat skills-governance does
The skill runs a bundled scan.js scanner that builds a skill inventory straight from the filesystem and SKILL.md frontmatter, skipping outdated catalogs or guesswork. It supports a --mode codex pass focused on Codex, a --mode all pass across several skill roots at once, and a --duplicates-only flag to isolate repeated names.
Each run reports the scanned roots, total skill count, enabled and disabled totals, duplicate-name groups, and flags such as plugin-import, system, or backup-like for likely copies or mirrored packs. Recommendations split into three buckets: keep, disable for now, or move to archive or an external mirror.
The default path is suggesting Codex [[skills.config]] disables rather than editing SKILL.md files directly, and it holds off on touching anything until the exact target paths are confirmed.
What it helps with
- spot duplicate-named skills across several skill roots
- build a Codex-first plan for what to disable
- tell imported plugin packs apart from original skills
- pull a JSON inventory of skills for scripting
- sort through a large skill collection before changing settings
Example prompts for the agent
- Scan my skills in codex mode and list the duplicates
- Compare all skill roots and show only duplicate groups
- Give me a JSON inventory of skills across agents
How to install skills-governance
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a claude-code2Manually: put the files in place
~/.claude/skills/skills-governance/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skills-governance/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a codex2Manually: put the files in place
.agents/skills/skills-governance/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a cursor2Manually: put the files in place
.cursor/skills/skills-governance/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cnfjlhj/ai-collab-playbook skills/full/skills-governance2Manually: put the files in place
.github/skills/skills-governance/SKILL.md1Skills CLI (Vercel)
npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a gemini-cli2Platform CLI
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/skills-governanceManually: put the files in place
.devin/skills/skills-governance/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skills-governance
How do I install skills-governance in Claude Code?
Run npx skills add cnfjlhj/ai-collab-playbook --skill skills-governance -a claude-code; the skill lands at ~/.claude/skills/skills-governance/SKILL.md.
What does skills-governance do?
It scans local skill directories, builds an inventory from actual files and SKILL.md frontmatter, groups duplicate names, and sorts skills into keep, disable, or archive.
How does the codex mode differ from the all mode?
--mode codex limits the inventory to Codex, while --mode all checks several agent skill roots together, including adjacent directories and mirrored packs.