file-organizer
根据文件内容、类型和使用习惯自动分析并优化本地文件结构,智能识别重复文件与过期数据,在确保安全的前提下提出目录重组方案,实现无需手动干预的持续化数字空间管理,适用于从日常下载清理到项目归档的多种场景。
| name | file-organizer |
| category | business-productivity |
| description | 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
- 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
▼text复制代码cd ~
Then run Claude Code and ask for help:
▼text复制代码Help me organize my Downloads folder
▼text复制代码Find duplicate files in my Documents folder
▼text复制代码Review my project directories and suggest improvements
Specific Organization Tasks
▼text复制代码Organize these downloads into proper folders based on what they are
▼text复制代码Find duplicate files and help me decide which to keep
▼text复制代码Clean up old files I haven't touched in 6+ months
▼text复制代码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:
▼bash复制代码# 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 -rnSummarize 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:
▼bash复制代码# 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 -nFor 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:
▼markdown复制代码# 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/
▼text复制代码## Changes I'll Make 1. **Create new folders**: [list] 2. **Move files**: - X PDFs → Work/Documents/ - Y images → Personal/Photos/ - Z old files → Archive/ 3. **Rename files**: [any renaming patterns] 4. **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:
▼bash复制代码# 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:
▼markdown复制代码# 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?
▼text复制代码
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)
- Downloads/
- 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:
▼markdown复制代码# 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` (2.3 MB, modified: 2024-03-15) - `/Desktop/proposal.pdf` (2.3 MB, modified: 2024-03-10) **Recommendation**: Keep `/Documents/proposal.pdf` (most recent in correct location) Delete the other 2 copies? [Continue for all duplicates...]
Example 3: Restructuring Projects Folder
User: "Review my ~/Projects directory and suggest improvements."
Output:
▼markdown复制代码# Analysis of ~/Projects ## Current Structure Issues - Mix of active and archived projects (3+ years old) - No consistent naming convention - Some projects at root, others in random subfolders - Duplicate folders (project-name, project-name-old, project-name-v2) ## Proposed Structure
Projects/ ├── Active/ │ ├── client-work/ │ ├── side-projects/ │ └── learning/ ├── Archive/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Templates/
▼text复制代码## Specific Changes 1. Move 12 projects not touched since 2022 → Archive/ 2. Consolidate 4 duplicate project folders 3. Rename projects to consistent format: "client-name-project-name" 4. Create Archive for old work Want me to implement this?
Example 4: Organizing Photos by Date
User: "Organize my photo folders by year and month."
Output: Creates structure like:
▼text复制代码Photos/ ├── 2023/ │ ├── 01-January/ │ ├── 02-February/ │ └── ... ├── 2024/ │ ├── 01-January/ │ └── ... └── Unsorted/
Then moves photos based on EXIF data or file modification dates.
Common Organization Tasks
Downloads Cleanup
▼text复制代码Organize my Downloads folder - move documents to Documents, images to Pictures, keep installers separate, and archive files older than 3 months.
Project Organization
▼text复制代码Review my Projects folder structure and help me separate active projects from old ones I should archive.
Duplicate Removal
▼text复制代码Find all duplicate files in my Documents folder and help me decide which ones to keep.
Desktop Cleanup
▼text复制代码My Desktop is covered in files. Help me organize everything into my Documents folder properly.
Photo Organization
▼text复制代码Organize all photos in this folder by date (year/month) based on when they were taken.
Work/Personal Separation
▼text复制代码Help me separate my work files from personal files across my Documents folder.
Pro Tips
- Start Small: Begin with one messy folder (like Downloads) to build trust
- Regular Maintenance: Run weekly cleanup on Downloads
- Consistent Naming: Use "YYYY-MM-DD - Description" format for important files
- Archive Aggressively: Move old projects to Archive instead of deleting
- Keep Active Separate: Maintain clear boundaries between active and archived work
- 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









