AI Agent Hub
Back to skills
Smart File Organizer icon

Smart 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_8d07c23e/file-organizerone.

About this skill

Problem

Desktop, download, and project root folders often become hard to navigate when files arrive from different sources. Manually creating folders, moving files, and clearing old items interrupts current work, especially when processing many documents, images, or installers at once.

How It Works

This skill handles a specific task: group files under a selected path into agreed subfolders by extension. The call shape is /file-organizer <path>, where the path can be the current directory, Desktop, or Downloads.

The workflow has a few key points:
- Confirm the target path
- Ask whether to preview or organize directly
- Preview mode runs python scripts/organize.py --dry-run and lists the moves without changing files
- Organize mode runs python scripts/organize.py and performs the actual sorting

Categories include documents, images, code, archives, videos, music, executable files, seed files, and fonts. For example, .pdf and .md map to documents, .jpg and .svg map to images, and .py, .go, and .sql map to code.

Boundaries

The rule is extension-based and does not inspect file contents, so it fits bulk sorting of flat directories. If a directory has complex nesting, symbolic links, name conflicts, or permission issues, review the dry-run summary first. If files must be archived by date, project, author, or business meaning, a fixed extension table may not be enough.

Use Cases

  • Downloads contains many PDFs, ZIPs, and PNGs that need to be grouped into subfolders.
  • A project root mixes py, json, and md files, so moves should be previewed first.
  • The desktop has scattered docx, jpg, and exe files that need to be sorted once.
  • A working folder mixes docs, code, and archives that must be separated by extension.

Best For

  • Project managers who receive many deliverables: need to group PDFs, spreadsheets, and ZIPs quickly.
  • Designers maintaining local assets: need to separate PNGs, JPGs, and font files from downloads.
  • Frontend engineers handling mixed files: need to sort JS, CSS, HTML, and Markdown by type.
  • Students cleaning personal machines: need to preview desktop file moves before organizing.