Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.

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 1. Analyzes Current Structure : Reviews your folders and files to understand what you have 2. Finds Duplicates : Identifies duplicate files across your system 3. Suggests Organization : Proposes logical folder structures based on your content 4. Automates Cleanup : Moves, renames, and organizes files with your approval 5. Maintains Context : Makes smart decisions based on file types, dates, and content 6. Reduces Clutter : Identifies old files you probably don't need anymore How to Use From Your Home Directory Then run Claude Code and ask for help: Specific Organization Tasks Instructions When a user requests file organization help: 1. 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) 2. Analyze Current State Review the target directory: Summarize findings: Total files and folders File type breakdown Size distribution Date ranges Obvious organization issues 3. 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) 4. Find Duplicates When requested, search for duplicates: 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 5. Propose Organization Plan Present a clear plan before making changes: [Directory]/ ├── Work/ │ ├── Projects/ │ ├── Documents/ │ └── Archive/ ├── Personal/ │ ├── Photos/ │ ├── Documents/ │ └── Media/ └── Downloads/ ├── To Sort/ └── Archive/ 6. Execute Organization After approval, organize systematically: 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 7. Provide Summary and Maintenance Tips After organizing: bash Find files modified this week find . type f mtime 7 Sort downloads by type [custom command for their setup] Find duplicates [custom command] Examples Example 1: Organizing Downloads (From Justin Dielmann) User : "My Downloads folder is a mess with 500+ files. Help me organize it." Process : 1. Analyzes Downloads folder 2. Finds patterns: work docs, personal photos, installers, random PDFs 3. Proposes structure: Downloads/ Work/ Personal/ Installers/ (DMG, PKG files) Archive/ ToSort/ (things needing decisions) 4. Asks for confirmation 5. Moves files intelligently based on content and names 6. 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 : Example 3: Restructuring Projects Folder User : "Review my ~/Projects directory and suggest improvements." Output : Projects/ ├── Active/ │ ├── client work/ │ ├── side projects/ │ └── learning/ ├── Archive/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Templates/ Example 4: Organizing Photos by Date User : "Organize my photo folders by year and month." Output : Creates structure like: Then moves photos based on EXIF data or file modification dates. Common Organization Tasks Downloads Cleanup Project Organization Duplicate Removal Desktop Cleanup Photo Organization Work/Personal Separation Pro Tips 1. Start Small : Begin with one messy folder (like Downloads) to build trust 2. Regular Maintenance : Run weekly cleanup on Downloads 3. Consistent Naming : Use "YYYY MM DD Description" format for important files 4. Archive Aggressively : Move old projects to Archive instead of deleting 5. Keep Active Separate : Maintain clear boundaries between active and archived work 6. Trust the Process : Let Claude handle the cognitive load of where things go Best Practices Folder Naming Use clear, descriptive names Avoid spaces (use hyphens or underscores) Be specific: "client proposals" not "docs" Use prefixes for ordering: "01 current", "02 archive" File Naming Include dates: "2024 10 17 meeting notes.md" Be descriptive: "q3 financial report.xlsx" Avoid version numbers in names (use version control instead) Remove download artifacts: "document final v2 (1).pdf" → "document.pdf" When to Archive Projects not touched in 6+ months Completed work that might be referenced later Old versions after migration to new systems Files you're hesitant to delete (archive first) Related Use Cases Setting up organization for a new computer Preparing files for backup/archiving Cleaning up before storage cleanup Organizing shared team folders Structuring new project directories

file-organizer