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.