code-cleanup
FeaturedDetect stale TODOs, unused imports, and dead code.
AI & Automation 425 stars
46 forks Updated yesterday MIT
Install
Quality Score: 94/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# Code Cleanup Skill
Scan repositories for 9 categories of technical debt (TODOs, unused imports, dead code, missing type hints, deprecated functions, naming inconsistencies, high complexity, duplicate code, missing docstrings), prioritize findings by impact/effort ratio with time estimates, and generate structured markdown reports with exact file:line references. Can apply safe auto-fixes when the user grants explicit permission.
### Examples
**Focused cleanup** -- User says "Clean up the API handlers in src/api/". Read project config, scan src/api/ for all 9 categories, prioritize (5 unused imports auto-fixable, 2 stale TODOs >90d, 1 high-complexity function), present tiered report with auto-fix commands.
**Broad debt scan** -- User says "What's the state of technical debt in this repo?". Identify languages and source directories, run all applicable scans, group 47 findings into Quick Wins (12), Important (8), Polish (27), generate full report with effort estimates: 2h quick wins, 6h important, 4h polish.
**Auto-fix request** -- User says "Fix all the unused imports and sort them". Verify ruff/goimports available, scan for F401 and I001 violations only, report 23 unused imports across 8 files, user confirms, apply fixes, run tests, show diff.
---
## Reference Loading Table
| Signal | Load These Files | Why |
|---|---|---|
| writing the cleanup report | `report-template.md` | Loads detailed guidance from `report-template.md`. |
| running per-language scans: unused im...
Details
- Author
- notque
- Repository
- notque/vexjoy-agent
- Created
- 6 months ago
- Last Updated
- yesterday
- Language
- Python
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
codebase-tasks
Scan a codebase for TODOs, tech debt, and improvements — prioritize and optionally put up PRs for the quick wins
0 Updated 3 weeks ago
dylanpulver AI & Automation Listed
ami-tech-debt-scanner
Analyzes the repository for technical debt, including outdated dependencies, dead code, duplication, and architectural inconsistencies. Provides a classified report based on criticality, effort, and risk.
1 Updated 6 days ago
AnaCataVC AI & Automation Listed
awesome-code-cleanup
Behavior-preserving cleanup of AI-like code noise: narrating comments, dead code, vague names, over-abstraction; applies a slop-audit report. Use when asked to clean up code or comments, or to de-slop.
10 Updated yesterday
khasky