file-organizer

The File Organizer skill acts as a dedicated personal assistant for maintaining a clean, logical file structure across your local machine. It is designed for developers, researchers, and power users who struggle with digital clutter, scattered downloads, and redundant files that impede workflow efficiency and create cognitive load. By leveraging intelligent analysis of file types, metadata, and creation dates, this skill transforms chaotic directories into organized systems without requiring tedious manual intervention.

• Automatic file categorization based on content (documents, images, videos, code, archives, etc.).

• Intelligent duplicate file detection and cleanup across specified directories using hash verification.

• Proactive folder structure recommendations to enhance project navigation and maintainability.

• Safe execution of file operations including moving, renaming, and archiving, with mandatory user approval before any permanent deletion.

• Context-aware cleanup processes that help identify and prune obsolete files or temporary scratch spaces.

• Comprehensive status reporting and summary logs after every cleanup task to track changes.

• To use this skill, navigate to the target directory in your terminal and request specific actions like organizing Downloads or cleaning up projects.

• The agent functions best when provided with clear scope, such as targeting specific folders or timeframes for organization.

• Users must review the proposed organization plan provided by the agent before any file mutations occur to ensure desired outcomes.

• The tool preserves original modification dates and handles potential filename conflicts gracefully to prevent data loss.

• Best practices include running this skill monthly or quarterly to maintain a tidy digital environment, particularly when archiving completed projects or preparing for new ones.