cleaning-project

Scan codebases for unused files and dead code with dry-run reports.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/TheeCoderAhmed/Skills-Master --skill cleaning-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleaning-project
Source: https://github.com/TheeCoderAhmed/Skills-Master/tree/main/.agent/skills/cleaning-project
Command: npx skills add https://github.com/TheeCoderAhmed/Skills-Master --skill cleaning-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scans the codebase for unused files, dead code, and common junk patterns, always performing a "Dry Run" first to list candidates for deletion and requiring explicit user confirmation.

Core Features & Use Cases

  • Dry Run: list candidates for deletion before any action.
  • Junk pattern detection: finds .DS_Store, Thumbs.db, .log, .tmp files, and empty directories.
  • Orphan file detection: identifies files not imported by any other file, excluding essential entry points.
  • Dead code detection: spots exported functions/constants never imported, with optional language-server support for accuracy.
  • Confirmation workflow: presents a report and asks for explicit user approval prior to deletion.

Quick Start

Run a first dry run to list deletable candidates and then request explicit user confirmation to proceed.

Frequently Asked Questions about cleaning-project

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

FAQPage Schema
How do I find and remove dead code and unused files in my codebase?

To remove dead code and unused files, you can run a dry scan to identify orphan files, exported functions never imported, and junk patterns like .DS_Store or .log files, then explicitly confirm which candidates to delete.

What is the safest way to clean up orphan files after a major refactor?

The safest way to clean up orphan files after a refactor is to perform a dry run first, which generates a report of unimported files and empty directories, requiring explicit user confirmation before any actual deletion occurs.

How do I detect empty directories and junk files before merging a repository?

You can detect empty directories and junk files before merging by scanning the codebase for common patterns like Thumbs.db, .tmp files, and .log files, which are listed in a report for you to review and approve for removal.

Does dead code detection require a language server to find unused exports?

Dead code detection does not require a language server, but it offers optional language-server support to improve accuracy when spotting exported functions and constants that are never imported by other files.

What is a dry run for codebase cleanup and how does it prevent accidental deletions?

A dry run for codebase cleanup is a preliminary scan that lists all deletion candidates, including dead code and orphan files, preventing accidental deletions by requiring explicit user confirmation before modifying any files.

Can I clean up bloated repositories without losing essential entry point files?

Yes, you can clean up bloated repositories safely because orphan file detection specifically excludes essential entry points, ensuring that only truly unimported files and empty folders are listed for your confirmation.