skills.rest
chadananda
chadanandaCOMMUNITY
Explore all skills by this author →
GitHub

project-cleanup

Classify and move project root files into docs/, scripts/, and tmp/ while preserving git history.

Updated Feb 6, 2026
Search Tags:#documentation#readme#organization#git mv#language-agnostic#file-tree#project-cleanup
One-click install
npx skills add https://github.com/chadananda/xswarm-tdd-claude --skill project-cleanup-chadananda
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-cleanup
Source: https://github.com/chadananda/xswarm-tdd-claude/tree/main/skills/project-cleanup
Command: npx skills add https://github.com/chadananda/xswarm-tdd-claude --skill project-cleanup-chadananda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, pathlib2, markdown, beautifulsoup4, lxml, gitpython, tqdm, click, python-dateutil, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill eliminates root clutter by automatically classifying and relocating documentation, scripts, and temporary files into standardized directories, while preserving git history for traceability.

Core Features & Use Cases

  • Classifies files at project root into docs/, scripts/, tmp/, tests/, and others, then moves them deterministically.
  • Generates folder README.md files describing contents and a comprehensive file tree in the main README.md for quick navigation.
  • Language-agnostic and safe for multi-language repos (Python, Node.js, Rust, Go), making it easy to onboard new contributors and maintain consistency across projects.

Quick Start

Run @project-cleanup --mode=interactive to scan, review, and apply changes. You can also run with --mode=auto for automated reorganization or --mode=dry-run to preview changes without applying.

Frequently Asked Questions about project-cleanup

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

FAQPage Schema
How do I reorganize a cluttered project root and move files into docs, scripts, and tmp directories?▼

You can automate project cleanup by running the skill in interactive mode to scan, review, and apply changes, or use auto mode for automated reorganization. A dry-run mode is also available to preview file movements before applying them.

Does this project cleanup tool work with multi-language repositories like Node.js, Rust, and Go?▼

Yes, this project cleanup tool is language-agnostic and works safely with multi-language repositories including Python, Node.js, Rust, and Go. It standardizes directory structures across diverse codebases without breaking language-specific conventions.

Can I preserve git history when moving files into organized folders?▼

Yes, you can preserve git history when moving files because the skill relies on git-based moves to ensure traceability. By using git mv operations, it minimizes disruption and maintains a clear historical record of relocated files.

How does generating folder READMEs and a file tree in the main README improve project navigation?▼

Generating folder READMEs and a comprehensive file tree in the main README improves project navigation by creating consistent structure and quick reference points. This automated documentation helps onboard new contributors and clarifies the contents of standardized directories.

What is the best way to preview project reorganization before applying changes to the repository?▼

The best way to preview project reorganization before applying changes is to run the skill with the dry-run mode. This allows you to scan the project root and review the proposed file classification and movements without modifying the actual repository.

Related Skills

Explore More Software Engineering Skills→
ThePyProgrammerThePyProgrammer

desloppify

Scan multi-language codebases for technical debt and execute prioritized refactors.

Community
Advanced
BaneeishaqueBaneeishaque

Project Structure and Documentation

Audit project roots and relocate misplaced files into standard directories.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate
BaneeishaqueBaneeishaque

project_structure

Audit and reorganize project directories into standard structures with Git.

Community
Advanced