From polishkit
Codebase hygiene sweep — find and clean up stale files, outdated documentation, build artifacts, and accumulated cruft. Use when the user asks to tidy, clean up, sweep, or find cruft in a codebase.
How this skill is triggered — by the user, by Claude, or both
Slash command
/polishkit:tidy-codebaseThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Codebase hygiene sweep: find and clean up stale files, outdated documentation, build artifacts, and accumulated cruft.
Codebase hygiene sweep: find and clean up stale files, outdated documentation, build artifacts, and accumulated cruft.
Focus area (if provided): $ARGUMENTS If no focus area is provided, perform a full sweep across all categories below.
Run these checks in parallel and compile findings:
Stale documentation
Build artifacts & dead directories
Documentation gaps
Duplicate content
Git hygiene
git branch --merged main and cross-reference with remote)git worktree list — flag any where the branch no longer exists or has been merged)git remote prune origin --dry-run)Organize findings into a clear summary grouped by category:
After presenting the summary, use AskUserQuestion to confirm each proposed action individually. Group into at most 4 questions per call (the tool limit); batch closely related items (e.g. two merged remote branches) into a single question. Each question should:
(Recommended))Wait for all answers before proceeding to step 3.
After approval:
polishkit:tidy-codebase cleanup, then proceedchore: tidy codebase and open a PR targeting developnpx claudepluginhub smallorbit/smallorbit-plugins --plugin polishkitProvides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.