Directory File Organizer

Problem

When a folder mixes screenshots, contracts, scripts, installers, and assets, locating the right files by hand gets noisy. This skill addresses a low-risk directory cleanup problem: it does not rewrite file contents, rename by date, or process subdirectories; it moves direct files in a specified directory into type-based folders by extension. It fits a quick pass over a downloads folder, a temporary workspace, or a delivery root before deeper organization.

How It Works

• Preview before moving: after a directory path is provided, it scans files and shows a classification preview; the move happens only after confirmation.
• Extension-based rules: common types such as jpg, docx, mp4, py, zip, and psd are mapped to folders, with unmatched files placed in Other.
• Conservative boundaries: it processes only direct files in the target directory, skips files already in matching category folders, and leaves dot-prefixed hidden files untouched.
• Traceable results: duplicate names receive numeric suffixes, such as file_1.txt, and each run is recorded in .organizer_log.json for review or undo.

Limits

It works best for flat directories with clear file types. If subdirectories need merging, filenames need bulk cleanup, or items need project-level archiving, the skill will not do that. For cloud-synced files, read-only files, or archives whose contents need inspection, check manually first.