File Organizer

This skill acts as your personal organization assistant, helping you maintain a clean, logical file structure across your computer without the mental overhead of constant manual organization.

When to Use This Skill

Your Downloads folder is a chaotic mess

You can't find files because they're scattered everywhere

You have duplicate files taking up space

Your folder structure doesn't make sense anymore

You want to establish better organization habits

You're starting a new project and need a good structure

You're cleaning up before archiving old projects

What This Skill Does

Analyzes Current Structure

Reviews your folders and files to understand what you have

Finds Duplicates

Identifies duplicate files across your system

Suggests Organization

Proposes logical folder structures based on your content

Automates Cleanup

Moves, renames, and organizes files with your approval

Maintains Context

Makes smart decisions based on file types, dates, and content
Reduces Clutter: Identifies old files you probably don't need anymore How to Use From Your Home Directory cd ~ Then run Claude Code and ask for help: Help me organize my Downloads folder Find duplicate files in my Documents folder Review my project directories and suggest improvements Specific Organization Tasks Organize these downloads into proper folders based on what they are Find duplicate files and help me decide which to keep Clean up old files I haven't touched in 6+ months Create a better folder structure for my [work/projects/photos/etc] Instructions When a user requests file organization help: Understand the Scope Ask clarifying questions: Which directory needs organization? (Downloads, Documents, entire home folder?) What's the main problem? (Can't find things, duplicates, too messy, no structure?) Any files or folders to avoid? (Current projects, sensitive data?) How aggressively to organize? (Conservative vs. comprehensive cleanup) Analyze Current State Review the target directory:

Get overview of current structure

ls -la [ target_directory ]

Check file types and sizes

find [ target_directory ] -type f -exec file { } \ ; | head -20

Identify largest files

du -sh [ target_directory ] /* | sort -rh | head -20

Count file types

find [ target_directory ] -type f | sed 's/.*.//' | sort | uniq -c | sort -rn Summarize findings: Total files and folders File type breakdown Size distribution Date ranges Obvious organization issues Identify Organization Patterns Based on the files, determine logical groupings: By Type : Documents (PDFs, DOCX, TXT) Images (JPG, PNG, SVG) Videos (MP4, MOV) Archives (ZIP, TAR, DMG) Code/Projects (directories with code) Spreadsheets (XLSX, CSV) Presentations (PPTX, KEY) By Purpose : Work vs. Personal Active vs. Archive Project-specific Reference materials Temporary/scratch files By Date : Current year/month Previous years Very old (archive candidates) Find Duplicates When requested, search for duplicates:

Find exact duplicates by hash

find [ directory ] -type f -exec md5 { } \ ; | sort | uniq -d

Find files with same name

find [ directory ] -type f -printf '%f\n' | sort | uniq -d

Find similar-sized files

find
[
directory
]
-type
f
-printf
'%s %p\n'
|
sort
-n
For each set of duplicates:
Show all file paths
Display sizes and modification dates
Recommend which to keep (usually newest or best-named)
Important: Always ask for confirmation before deleting Propose Organization Plan Present a clear plan before making changes:

Organization Plan for [Directory]

Current State

X files across Y folders

[Size] total

File types: [breakdown]

Issues: [list problems]

Proposed Structure [Directory]/ ├── Work/ │ ├── Projects/ │ ├── Documents/ │ └── Archive/ ├── Personal/ │ ├── Photos/ │ ├── Documents/ │ └── Media/ └── Downloads/ ├── To-Sort/ └── Archive/

Changes I'll Make

Create new folders: [list]
Move files:
X PDFs → Work/Documents/
Y images → Personal/Photos/
Z old files → Archive/
Rename files: [any renaming patterns]
Delete: [duplicates or trash files]

Files Needing Your Decision

[List any files you're unsure about] Ready to proceed? (yes/no/modify) Execute Organization After approval, organize systematically:

Create folder structure

mkdir -p "path/to/new/folders"

Move files with clear logging

mv "old/path/file.pdf" "new/path/file.pdf"

Rename files with consistent patterns

Example: "YYYY-MM-DD - Description.ext"

Important Rules : Always confirm before deleting anything Log all moves for potential undo Preserve original modification dates Handle filename conflicts gracefully Stop and ask if you encounter unexpected situations Provide Summary and Maintenance Tips After organizing:

Organization Complete! ✨

What Changed

Created [X] new folders

Organized [Y] files

Freed [Z] GB by removing duplicates

Archived [W] old files

New Structure [Show the new folder tree]

Maintenance Tips

To keep this organized:

1.

Weekly

Sort new downloads

2.

Monthly

Review and archive completed projects

3.

Quarterly

Check for new duplicates
4.
**
Yearly
**: Archive old files

Quick Commands for You ```bash

Find files modified this week find . -type f -mtime -7

Sort downloads by type [custom command for their setup]

Find duplicates

[custom command]

Want to organize another folder?

Examples

Example 1: Organizing Downloads (From Justin Dielmann)

User

"My Downloads folder is a mess with 500+ files. Help me organize it."
Process
:
Analyzes Downloads folder
Finds patterns: work docs, personal photos, installers, random PDFs
Proposes structure:
Downloads/
Work/
Personal/
Installers/ (DMG, PKG files)
Archive/
ToSort/ (things needing decisions)
Asks for confirmation
Moves files intelligently based on content and names
Results: 500 files → 5 organized folders
Example 2: Finding and Removing Duplicates
User: "Find duplicate files in my Documents and help me decide which to keep." Output :

Found 23 Sets of Duplicates (156 MB total)

Duplicate Set 1: "proposal.pdf"

/Documents/proposal.pdf

(2.3 MB, modified: 2024-03-15)

-

/Documents/old/proposal.pdf