File Organizer Assistant

Problem

Desktops, Downloads folders, and shared directories often accumulate files in the order they were saved, making later lookup slow. For engineers, the annoyance grows before handoff: documents, assets, code snippets, and archives need to be separated and filed, and manual moving can miss files or mix unrelated items. This skill targets a common case—organizing one known folder by file extension—by moving files into fixed category subfolders and reporting the result.

How it works

The skill takes a target folder path as input and classifies files by extension:
- Documents: .doc, .docx, .pdf, .txt, .md
- Images: .jpg, .png, .gif, .svg, .webp
- Code: .js, .py, .html, .css, .ts
- Archives: .zip, .rar, .7z, .tar.gz
- Video: .mp4, .avi, .mov, .mkv

It reads the files in the target folder, creates a subfolder for each category, moves the matching files into place, and outputs an organization report. Because classification is primarily extension-based, it is best suited for batch cleanup of download or temporary folders. If a file’s extension does not match its actual content, such as extensionless scripts or executables mislabeled as documents, manual review may be needed. The move operation changes directory structure, so verify the path and write permissions before running it.