cleanup

Analyze project state and execute phase-aware cleanup with MERGE, MOVE, DELETE, and RENAME actions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Brownbull/taskflow --skill cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup
Source: https://github.com/Brownbull/taskflow/tree/main/.claude/skills/utility/cleanup
Command: npx skills add https://github.com/Brownbull/taskflow --skill cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles project clutter by automatically identifying and resolving redundancy, consolidating scattered files, and removing obsolete content. It adapts its strictness based on the project's development phase, ensuring a clean and maintainable codebase without hindering rapid iteration in early stages.

Core Features & Use Cases

  • Phase-Aware Cleanup: Adjusts organization rules from minimal (Prototype) to strict (Scale), preventing over-engineering in early phases while enforcing standards in mature ones.
  • Redundancy Detection: Uses content similarity analysis to find and propose merging duplicate or near-duplicate files, reducing information sprawl.
  • Obsolete Content Removal: Identifies and suggests deletion of old, unreferenced, or temporary files, freeing up mental and disk space.
  • Use Case: After a major refactoring, run this skill to automatically consolidate redundant documentation, move misplaced test results to the ai-state/regressions/ folder, and delete old backup files, keeping the project tidy and easy to navigate.

Quick Start

Use the cleanup skill to analyze the project and propose a plan to organize files and remove obsolete content.

Frequently Asked Questions about cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically identify and remove duplicate files from my project?

Redundancy detection uses content similarity analysis to find duplicate or near-duplicate files across your repository. The Skill proposes merging candidates and generates a plan before executing deletions, reducing information sprawl while preserving your codebase.

Can I clean up my project without breaking active development?

Phase-aware cleanup adjusts its strictness based on your project state—Prototype phase applies minimal rules to preserve iteration speed, while Scale phase enforces strict standards. Safety checks prevent harmful changes and detailed reporting lets you review the plan first.

How do I consolidate scattered documentation and reorganize folders?

The Skill analyzes your project structure, detects misplaced files and obsolete content, then executes a workflow of MERGE, MOVE, DELETE, and RENAME operations. It consolidates redundant documentation and reorganizes folders according to phase-appropriate standards.

What happens to old backup files and temporary content during cleanup?

Obsolete content removal identifies unreferenced, temporary, or outdated files and proposes deletion. The plan-and-execute workflow flags these for removal with safety checks, freeing disk and mental space while maintaining a detailed audit trail.

Does cleanup work across different project development stages?

Yes. The Skill applies phase-aware rules across Prototype, MVP, Growth, and Scale contexts. Each phase has different organization strictness—early stages allow flexibility for rapid iteration, while mature stages enforce consistent standards and eliminate technical debt.

How do I know what changes the cleanup plan will make?

The Skill generates a detailed plan before execution, showing proposed MERGE, MOVE, DELETE, and RENAME operations with redundancy scoring and safety checks. You review the full report and approve changes before any modifications occur.