# gjalla-cleanup-audit

Audits repositories for abandoned code, duplicated routines, and inaccurate docs. It verifies all callers first to keep removals from breaking production.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 352 installs · ★ 3
- Author: gjalla
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gjalla/engineering/tree/HEAD/skills/gjalla-cleanup-audit/SKILL.md
- Updated: 2026-09-20
- HTML: https://affpapa.org/en/nevibecode/skills/gjalla-cleanup-audit

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gjalla-cleanup-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gjalla-cleanup-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gjalla-cleanup-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gjalla-cleanup-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gjalla/engineering gjalla-cleanup-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/gjalla-cleanup-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-cleanup-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gjalla-cleanup-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gjalla/engineering --skill gjalla-cleanup-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gjalla/engineering/tree/HEAD/skills/gjalla-cleanup-audit/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs

From the same set: [gjalla/engineering](https://affpapa.org/en/nevibecode/by/gjalla/engineering.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md