File Organizer Automation Assistant

Problem

When screenshots, documents, media, and temporary files pile up in one folder, manually dragging them into categories is slow and error-prone. File Organizer Automation Assistant targets this low-value, high-frequency chore: it accepts a single folder path, sorts files by type, and returns a reviewable result.

How It Works

The skill runs around the local file-processing logic in file_organizer.py. Its core steps are:

• Path validation: checks whether the directory exists before proceeding.
• Extension-based classification: recognizes common suffixes such as .docx, .pdf, .png, .mp4, .mp3, .zip, .py, and .json, then groups them into documents, images, videos, music, archives, and code.
• Automatic folder creation: creates the required category folders without manual setup.
• Duplicate handling: renames colliding files, for example from photo.jpg to photo_1.jpg, reducing overwrite risk.
• Report output: returns classification and movement results after sorting, making it easier to verify what was moved and what was unmatched.

Boundaries

This skill is best suited for bulk sorting within one directory. The current version mainly handles top-level files; recursive subfolder processing requires code changes. Unrecognized extensions are placed in “Other files” rather than deleted, and invalid paths produce a clear error. It is not intended for preserving original hierarchy, project-based naming, or cloud-sync workflows.