AI Agent Hub
Back to skills
File Organizer icon

File Organizer

Office Efficiency Updated 2026.08.30

Paste the following prompt into your AI chat to install this skill:

Please follow https://skillhub.cn/install/skillhub.md to install @user_d2ac1320/0811test.

About this skill

Problem

Desktop and download folders often fill with PDFs, screenshots, installers, snippets, and archives. Sorting them manually is slow and easy to get wrong, while moving files without a preview can make mistakes hard to recover from.

How It Works

file-organizer classifies files in a specified folder, defaulting to the Desktop, by file extension. It is best for relatively flat local file trees. Key behaviors include:
- Preview first: run --dry-run before moving files to confirm the target structure.
- Category-based sorting: move files into Documents, Images, Videos, Music, Archives, Code, Executables, Fonts, and Others.
- Script execution: typically uses Bash with find, mkdir, and mv, then outputs a report for inspection.

Boundaries and Caveats

The skill categorizes by extension, not content, so files with missing or misleading extensions may land in Others or the wrong category. The working directory must allow find, mkdir, and mv, and Windows use can go through Git Bash or WSL. Once moved, the script does not provide a full one-command undo; restore by opening category folders and moving files back, or re-running the flat-list organization.

Use Cases

  • Desktop files are scattered, with PDFs, images, and code mixed together; run a dry-run before moving files into category folders.
  • Downloads contain installers and archives; move them into Executables and Archives by extension.
  • A project folder has scattered source and config files; move .py, .json, and .yaml into Code.
  • Preview with --dry-run first, then confirm moving documents, images, and videos into their category folders.

Best For

  • Office workers with cluttered desktops who need batch archiving by file extension
  • Engineers who often download documents, images, and installers and need a preview before sorting
  • Developers using Git Bash or WSL to organize local file trees
  • Project maintainers who need to move scattered code and config files into a Code directory