Clean Downloads

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

1. list_directory on the user's Downloads folder (~/Downloads, or ask if it's elsewhere).
2. 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
3. For each bucket that has at least one file, create_directory Downloads/<Bucket> if it doesn't exist.
4. 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.
5. 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.