AI Agent Hub
Back to skills
File Organizer icon

File Organizer

AI Agent Updated 2026.08.30

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

Please follow https://skillhub.cn/install/skillhub.md and install @user_a3355819/file-organizer-203.

About this skill

Problem It Solves

When a request asks to organize a desktop or Downloads folder, manually dragging files is slow and inconsistent. file-organizer turns that into a deterministic workflow: classify by file extension only, without editing file contents.

How It Works

  • Path input: extract the target folder from the user message; ask if missing.
  • Directory check: confirm the path exists and is a directory.
  • Script execution: run scripts/organize_files.py to list files and classify extensions such as .docx, .png, .py, .zip, .mp4, .mp3, and .csv.
  • Folder placement: create or reuse folders for Documents, Images, Code, Archives, Videos, Audio, and Data.
  • Report: summarize total moved files, counts per category, and unrecognized files placed in Others.

Scope and Limits

It is useful for quick local folder cleanup, but not for complex permission issues, rename-conflict policies, or semantic content classification. The skill moves files rather than deletes them; unrecognized extensions go to Others, and the script skips its own directory to avoid recursive organization.

Use Cases

  • Organize desktop files by moving loose documents, images, and code into extension-based subfolders.
  • Clean a Downloads folder by grouping archives, videos, audio, and data files into matching categories.
  • Tidy a temp project directory by moving `.csv`, `.json`, and `.sql` data files into a Data folder.
  • Archive legacy project assets by separating code, docs, and archives into subfolders and review the report.

Best For

  • Local developers who leave downloaded files on the desktop and need fast extension-based sorting.
  • Individual project maintainers who need to archive scripts and documentation into fixed directories.
  • Operations assistants who clean up shared deliverable folders and need documents, spreadsheets, and archives separated.
  • Engineering assistants who use AI agents to run file organization commands and need path validation plus move reports.