Organize Your Digital Files Automatically

File Organizer is a skill for turning a chaotic Downloads folder, scattered documents, or an outdated folder structure into a coherent, maintained system. It analyzes the current structure, finds duplicate files, proposes a logical organization plan, and executes cleanup only after approval - making context-aware decisions based on file type, date, and content rather than blind rules.

It starts by clarifying scope (which directory, what the core problem is, what to leave alone, how aggressive to be), then analyzes the target directory - file-type breakdown, size distribution, largest files, date ranges - to summarize the current state and its obvious issues. Organization patterns are proposed by type (documents, images, videos, archives, code, spreadsheets, presentations), by purpose (work vs. personal, active vs. archive, project-specific, reference, scratch), or by date (current, previous years, archive candidates). Duplicate detection compares file hashes for exact matches, similar filenames, and similar sizes, always showing paths/sizes/dates and asking for confirmation before deleting anything. The organization plan is presented as a document before any change is made - current state, proposed folder tree, the specific moves/renames/deletions planned, and any files needing a human decision - and only proceeds on explicit yes/no/modify approval. Execution creates the new folder structure, moves and renames files with logged, undo-able operations, preserves original modification dates, and stops to ask if anything unexpected comes up. A closing summary reports what changed (folders created, files organized, space freed, files archived) and gives maintenance commands for ongoing upkeep (weekly download sorting, monthly project review, quarterly duplicate checks, yearly archiving).

Use it when a folder has become unmanageable - scattered files, duplicates, no coherent structure - or when starting a new project or archiving an old one and want a sensible structure from the start. It never deletes or reorganizes without first presenting a plan and getting explicit approval - it is not an autonomous cleanup tool, and it explicitly avoids current projects or sensitive data the user flags as off-limits.

Input is a target directory and the user's organization goals and constraints. Output is an analysis summary, a proposed organization plan (folder tree and specific file moves), and - after approval - the reorganized directory plus a maintenance-tips summary. A representative duplicate-detection step looks like this:

# Find exact duplicates by hash
find [directory] -type f -exec md5 {} \; | sort | uniq -d

# Find files with similar names
find [directory] -type f -printf '%f\n' | sort | uniq -d

It operates directly on the local filesystem using standard shell tools (find, du, mkdir, mv), with no external service dependency.

Anyone with a chaotic Downloads folder, duplicate files, or an outdated project structure who wants a proposed, approved reorganization plan plus ongoing maintenance habits rather than a fully automatic, unreviewed cleanup.