gjalla-cleanup-audit — Claude Code skill: what it does, how to install
Audits repositories for abandoned code, duplicated routines, and inaccurate docs. It verifies all callers first to keep removals from breaking production.
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a claude-codeWhat gjalla-cleanup-audit does
This skill runs a structured five-step cleanup. It maps project boundaries, spots unreferenced logic, and traces external entry points that basic text searches miss. Candidate code is sorted by risk. Confirmed inactive code gets deleted alongside its tests, while questionable call sites stay put in a dedicated report.
Deletions happen in isolated passes. The agent takes out test suites first, moves to callers, and finishes with core definitions. It runs test suites after every stage. The workflow deliberately preserves database rows and schema columns: data retention remains a manual choice.
What it helps with
- track down and confirm dormant functions before wiping them out
- merge divergent copies of duplicate logic into the best-covered version
- rewrite obsolete code comments and misleading specifications
- prune remnants left behind after retiring an old feature
Example prompts for the agent
- Run gjalla-cleanup-audit on the billing module and show proof for every uncalled function.
- Purge deprecated API routes in stages, starting with test suites and callers.
- Scan the repository for drifted logic duplications and draft a summary of unverified cases.
How to install gjalla-cleanup-audit
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a claude-code2Manually: put the files in place
~/.claude/skills/gjalla-cleanup-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gjalla-cleanup-audit/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a codex2Manually: put the files in place
.agents/skills/gjalla-cleanup-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a cursor2Manually: put the files in place
.cursor/skills/gjalla-cleanup-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gjalla/engineering gjalla-cleanup-audit2Manually: put the files in place
.github/skills/gjalla-cleanup-audit/SKILL.md1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-cleanup-auditManually: put the files in place
.devin/skills/gjalla-cleanup-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a opencodeClaude.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 gjalla-cleanup-audit
How do I install gjalla-cleanup-audit in Claude Code?
Run npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a claude-code. The file will be placed at ~/.claude/skills/gjalla-cleanup-audit/SKILL.md.
What does gjalla-cleanup-audit do?
It guides coding agents through auditing unused routines, drifted duplications, and outdated comments. It enforces verification before discarding files so running systems stay stable.
Will gjalla-cleanup-audit delete database records?
No, it strictly leaves persistent storage alone. While dead application code gets pruned, existing rows and schema artifacts require deliberate manual decisions.