Documents

file-organizer

Sort and organize files in a directory by type or by modification date, with dry-run preview, duplicate-name handling, and an auto-generated organization report. Use when the user wants to clean up, sort, categorize, or organize files in a folder, or asks for a file classification/overview report.

What it does

The skill document

File Organizer

Organizes loose files in a directory into categorized subfolders, either by file type or by modification date. Supports a dry-run mode that only previews changes, and generates a Markdown summary report of what was moved where.

When to use

Use this skill when the user asks to:

Clean up / sort / organize a messy downloads or documents folder
Group files by type (images, documents, videos, ...) or by date
Get an overview report of what a folder contains

Workflow

Confirm scope: Ask for the target directory (default: current directory) and the grouping mode (by-type or by-date).
Dry-run first: Always show a preview of the planned moves before touching any file.
Execute: After user confirmation, move the files into category subfolders.
Report: Write organize-report.md summarizing the result.

Category mapping (by type)

Extension(s)	Target folder
jpg, jpeg, png, gif, bmp, webp, svg, ico	Images
pdf, doc, docx, xls, xlsx, ppt, pptx, txt, md, csv, odt	Documents
mp4, avi, mkv, mov, wmv, flv, webm	Videos
mp3, wav, flac, aac, ogg, m4a	Audio
zip, rar, 7z, tar, gz, bz2	Archives
py, js, ts, java, c, cpp, h, go, rs, html, css, json, xml, sh, ps1, sql	Code
anything else	Others

Files without an extension (e.g. README) go to Others.

Rules

Never move the script itself, category folders, or dotfiles (files starting with .).
Name collisions: if a target file already exists, append a numeric suffix, e.g. photo (1).jpg. Never overwrite.
Dry-run is the default first step — show the plan as a table and wait for confirmation before moving anything.
Skip empty folders; leave the folder structure of subdirectories untouched (only top-level loose files are organized; ask the user if they want recursion).

Automated script (Windows)

powershell -ExecutionPolicy Bypass -File scripts/organize-files.ps1 -Dir . -DryRun
powershell -ExecutionPolicy Bypass -File scripts/organize-files.ps1 -Dir . -ByDate

Parameters:

Parameter	Default	Description
`-Dir`	`.`	Target directory to organize
`-ByType`	on	Group files by type (default mode)
`-ByDate`	off	Group files by year-month instead (e.g. `2026-08`)
`-DryRun`	off	Preview only; move nothing
`-Recurse`	off	Also organize files in subfolders

The script prints a summary table and writes organize-report.md (unless in dry-run mode).

Notes

Always present the dry-run table to the user and get explicit confirmation before moving files.
If the folder has more than 200 files, group statistics in the report and keep the file list truncated.
If the user asked to organize the workspace itself, never move the skill's own folder or the report file.

Additional resources

For sample inputs and expected outputs, see examples.md

Related skills

File Organizer Test

Organize messy folders by moving files into subfolders grouped by extension, date, or category. Use for downloads cleanups and batch file sorting.

1 installs

Firefly Folder Organize

AI File Organizer for Firefly AI Folder. Local AI file analysis, auto-categorization, smart renaming, auto-tagging, deduplication, semantic search, progress...

Ai Folder Organize

AI File Organizer for Firefly AI Folder. Local AI file analysis, auto-categorization, smart renaming, auto-tagging, deduplication, semantic search, progress monitoring, and virtual directory plans. / 萤核智能文件夹AI整理助手。支持本地AI文件分析、智能分类与命名、自动打标、查重去重、全文搜索、进度监控与独创多维虚拟目录整理方案。