Housekeeper
Personal collection of agent skills for Claude
npx -y skills add leek/agent-skills --skill housekeeperAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Run a conservative code-project housekeeping pass. Use this when the user asks for repository housekeeping, dead code cleanup, unused dependency review, stale file cleanup, duplicate code cleanup, broken link cleanup, naming cleanup, or a safe low-risk project hygiene sweep.
SKILL.md
3.3 KB, as published. Nobody here has run it
Housekeeper
Goal
Find and apply one proven, low-risk cleanup at a time while preserving existing behavior and protecting unrelated work.
Loop Prompt
Review [repository or code project] for dead code, meaning unreachable or unused code; stale files or comments; unused dependencies; duplication; broken links; inconsistent names; and confusing structure. Protect unrelated, active, uncommitted, generated, and uncertain work. Prove one low-risk cleanup, make the smallest coherent change, then rerun the build, tests, runtime checks, and diff review. Keep only verified improvements. Stop when none remain, progress stalls, verification is unavailable, or approval is required. Return changes, evidence, and deferred candidates.
Stop when no confirmed low-risk cleanup remains and existing behavior still passes.
When To Use
Use this when a code project has accumulated small maintenance problems, such as unused code, stale files, duplicated logic, broken links, old comments, inconsistent names, or confusing organization, but broad deletion would be risky.
This loop cleans source and project structure. It is not a Git branch, pull request, commit, or worktree cleanup workflow.
Workflow
- Inspect the current project state before changing anything.
- Identify active branches, uncommitted edits, generated files, configuration, build artifacts, and other work that must not be disturbed.
- Collect possible cleanup candidates.
- Pick one candidate that can be proven low risk from code references, configuration, documentation, tests, or runtime behavior.
- Make the smallest coherent change that removes or improves that candidate.
- Run the relevant existing checks: build, tests, lint/type checks, runtime smoke checks, link checks, or project-specific verification.
- Review the diff and keep the change only if behavior stays intact and unrelated work is untouched.
- Repeat until no proven low-risk cleanup remains, progress stalls, verification is unavailable, or the next candidate needs approval.
Candidate Types
Look for:
- Unreachable or unused code.
- Stale files or stale comments.
- Unused dependencies.
- Duplicated logic.
- Broken links.
- Inconsistent names.
- Confusing project structure.
Treat generated files, unclear files, active work, and user changes as protected until there is direct evidence and approval.
Report
End with:
- Cleanup candidates reviewed.
- Changes made.
- Evidence supporting each retained cleanup.
- Verification commands run and their results.
- Deferred candidates and why they were not changed.
- Any approval needed before continuing.
Guardrails
- Do not delete code merely because its purpose is not immediately obvious.
- Do not touch unrelated, active, uncommitted, generated, or uncertain work.
- Do not combine unrelated cleanups into one large change.
- Do not keep a cleanup if checks fail or behavior cannot be verified.
- Ask for approval before removing dependencies, deleting broad file sets, or changing public interfaces when risk is unclear.