repo-cleanup
Use when a repository needs cleanup of dead code, build artifacts, unused dependencies, outdated docs, or stale tests - provides safe cleanup workflows, validation steps, and reporting templates for code, deps, docs, tests, and sprint archives.
Security Assessment
About repo-cleanup
The 'repo-cleanup' skill helps maintain the health and efficiency of software repositories by providing a systematic approach to cleaning up dead code, build artifacts, unused dependencies, outdated documentation, and stale tests. This skill addresses common repository bloat caused by unmaintained or unnecessary files that accumulate over time. By following structured workflows, it enables users to safely identify and remove problematic elements without the risk of impacting critical code or functionality. The skill is designed to be a repeatable, reliable process that minimizes the risks associated with repository maintenance, ensuring a clean and well-maintained codebase.
FAQ
When should I use the 'repo-cleanup' skill?
You should use it when dealing with repository bloat, dead code, unused dependencies, outdated documentation, or when cleaning up stale tests. It is also useful when closing sprints and needing to archive old artifacts.
What are the main features of the 'repo-cleanup' skill?
The skill provides safe cleanup workflows, validation steps, and reporting templates for code, dependencies, documentation, tests, and sprint archives. It includes usage checks before removal, and validation steps after cleanup.
Are there any limitations to using this skill?
Avoid using the skill during active incident responses or when there is no clear owner for the target area or rollback coverage in place.
Can the 'repo-cleanup' skill be used on any repository?
Yes, it can be used on any repository, but it is recommended that the repository is under active maintenance and has proper test coverage and version control in place.
What happens after I run the cleanup workflows?
You will receive a report summarizing the actions taken, files that were modified or deleted, validation results, and any remaining risks or follow-up recommendations.
Install repo-cleanup
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
NickCrew/claude-cortex