Automated File Organizer

Problem

When a folder accumulates downloads, screenshots, code snippets, and documents, sorting them by hand is slow and easy to get wrong. file-organizer targets this narrow task: take a target folder and split its files into clearer subfolders based on file extensions, reducing the need to scan the directory manually.

How It Works And Limits

The workflow is direct:
- reads the files in the target folder
- classifies them by extension, for example .pdf/.md into documents and .py/.ts into code
- creates the matching subfolders and moves the files
- outputs an organization report

It is useful for local directories, download folders, or project asset folders. The main limitation is that classification is extension-based only; the skill does not infer semantic content from filenames or file bodies. Files without extensions, files with nonstandard suffixes, or files that must remain in place should be reviewed before running it. Moving files can break relative paths, asset references, or script dependencies, so use it with caution in directories where the layout is load-bearing.