housekeeping

Detect misplaced files and reorganize loose scripts into categorized folders.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Repositories can quickly become cluttered with misplaced files, temporary assets, and inconsistent structures, hindering developer productivity and code discoverability. This Skill automates the cleanup and organization process, ensuring a professional and maintainable codebase without manual effort.

Core Features & Use Cases

  • Automated File Organization: Scans for misplaced files, organizes loose scripts into appropriate utility folders, and categorizes documentation.
  • Temporary File Cleanup: Automatically deletes system files (.DS_Store), backup files (.bak), and other temporary artifacts.
  • Enforces Structure: Ensures adherence to a professional folder structure and naming conventions, presenting a plan for major changes before execution.

Quick Start

Run housekeeping and analyze our repo for any cleanup needed.

Frequently Asked Questions about housekeeping

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

FAQPage Schema
How do I automatically organize files in my repository?

Repository organization scans for misplaced files and loose scripts, then relocates them into categorized folders while enforcing a professional root and subfolder structure. The Skill detects system files, backup artifacts, and temporary items for deletion, presenting a cleanup plan before execution so you approve major changes.

What temporary files and artifacts can be cleaned up automatically?

Automatic cleanup removes system files like `.DS_Store`, backup files (`.bak`), and other temporary artifacts that accumulate in repositories. The Skill identifies these during analysis and deletes them as part of the reorganization workflow.

Can I review changes before repository reorganization is applied?

Yes. The Skill generates a plan during analysis and categorization phases, flagging larger file moves for your approval before execution. You see the proposed structure and changes, then decide whether to proceed with the reorganization.

How does repository structure enforcement improve code discoverability?

Enforcing professional folder structure and naming conventions creates a consistent, predictable layout across root, context, and resource directories. Developers locate files faster, understand the codebase organization immediately, and maintain consistency without manual effort.

Does this work with diverse project repositories and frameworks?

Yes. The Skill applies across diverse project repositories, handling file organization and cleanup without framework-specific dependencies. It works with any repository using Git for version control and commit-ready change generation.