file-organizer

The File Organizer skill acts as your personal digital assistant, designed to eliminate the mental overhead and chaotic clutter that accumulates in personal and professional file systems. It is primarily intended for users whose folders, such as Downloads, Documents, or project directories, have become disorganized or unmanageable over time. By leveraging intelligent analysis of file types, modification dates, content patterns, and directory structures, the skill transforms manual filing chores into an automated, guided process.

• Performs comprehensive structural analysis to understand current file layout and identifying bottlenecks.

• Identifies exact duplicate files across your entire system using hashing algorithms to reclaim storage space.

• Recommends and implements logical, hierarchical folder structures (e.g., separating Work, Personal, Archives, and Media).

• Automates the movement and renaming of files into categorized folders based on metadata like file extension, date, and project association.

• Provides a safe-first workflow requiring user approval before any deletions, ensuring no critical data is accidentally removed.

• Identifies old, unused files or temporary "scratch" data that can be safely archived or discarded to reduce visual and system clutter.

• To use this skill, ensure you are in the directory you wish to organize, then request specific tasks like identifying duplicates in Documents or cleaning up a chaotic Downloads folder.

• The agent will first provide a summary of the directory, including file type distribution, largest files, and size usage before proposing a reorganization plan.

• Use descriptive commands for best results, such as asking to group files by date or by specific file purpose.

• Always review the proposed list of moves and deletions provided by the agent before confirming the execution of the plan.

• Keep in mind that while the skill is powerful, it is designed for manual-approval workflows to prevent data loss, so be prepared to confirm actions for sensitive directories.

• The organization process handles file type categorization including documents (PDF, DOCX), images (JPG, PNG), archives (ZIP, TAR), and code projects, ensuring every file type is routed to an appropriate destination.