# Clean Codebase

> Clean up dead code, obsolete paths, and contradictions in the codebase to keep it small, correct, and aligned with reality.

- Skill: `kimtth/clean-codebase` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kimtth/clean-codebase`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kimtth/clean-codebase/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kimtth (https://skillmd.com/u/kimtth)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kimtth/clean-codebase

---


Goal: keep repo small, correct, aligned with reality

Tasks:
1. Delete dead code (no refs, no tests, stale)
2. Remove obsolete paths, flags, duplicates
3. Sync docs with actual APIs/configs
4. Detect contradictions:
   - code vs docs
   - code vs tests
   - schema/type drift
   - unreachable logic

Output:
- list of removals (with confidence)
- suggested diffs
- contradictions:
  type | where | issue | severity | fix

Mode: assist (auto-fix safe only)
Rules:
- don’t remove public APIs without deprecation
- avoid dynamic/reflection false positives
- keep changes reversible