| name | clean-downloads |
| description | Sort a messy Downloads folder into per-type subfolders (use when the user says their Downloads is a mess / wants it organized) |
| version | 1.0.0 |
| author | 0pen-sourcer |
| tools | ["list_directory","create_directory","move_path"] |
Clean up Downloads
Sort loose files in the Downloads folder into tidy per-type subfolders. Non-destructive: only moves files, never deletes, never overwrites.
Steps
list_directory on the user's Downloads folder (~/Downloads, or ask if it's elsewhere).- Bucket each file (ignore folders) by extension:
- Documents — pdf, doc, docx, txt, md, ppt, pptx, xls, xlsx, csv, epub
- Images — png, jpg, jpeg, gif, webp, svg, heic, bmp
- Video — mp4, mkv, mov, avi, webm
- Audio — mp3, wav, flac, m4a, ogg
- Installers — exe, msi, dmg, appimage
- Archives — zip, rar, 7z, tar, gz
- Other — everything else
- For each bucket that has at least one file,
create_directory Downloads/<Bucket> if it doesn't exist.
move_path each file into its bucket. If a file with the same name already exists in the target, append (2), (3), … to the name — never overwrite.- Report a short summary: how many files moved into each bucket.
Don't
- Don't touch subfolders the user already created (only loose files at the top level).
- Don't move files currently in use / locked — skip and mention them.
- Don't delete anything. This skill only organizes.
