File Organizer

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.

---

Download this Skill

---

SKILL.md

---

Seven-Step Process

1. Scope Understanding

Gathers requirements through clarifying questions:

• Target directories to organize
• Specific problems to solve
• Files to protect from changes
• Organization intensity level

2. Current State Analysis

Uses bash commands to examine:

• Directory structure and hierarchy
• File types and distributions
• File sizes and storage usage
• Date ranges and temporal patterns

3. Pattern Identification

Groups files by:

• Type - Documents, images, videos, archives, code
• Purpose - Work vs. personal, active vs. archive
• Temporal markers - Year, month, project timeline

4. Duplicate Detection

Employs multiple techniques:

• MD5 hashing for exact duplicates
• Filename matching for similar files
• File size comparison
• Always requires confirmation before deletion

5. Organization Planning

Presents detailed markdown proposal with:

• Current state summary
• Proposed folder structure
• Planned changes and moves
• Files requiring user decisions

6. Execution Phase

Systematically performs:

• Folder creation with logical hierarchy
• File moves with complete logging
• Systematic renaming for consistency
• Strict rules: No deletion without confirmation

7. Summary & Maintenance

Provides completion deliverables:

• Detailed completion report
• New folder tree visualization
• Maintenance tips for staying organized
• Custom commands for ongoing use

---

When to Use

Perfect for addressing:

• Chaotic Downloads folders
• Scattered files across multiple locations
• Duplicate files wasting storage
• Illogical folder structures
• Establishing organization habits
• New project setup
• Archival preparation

---

Key Safety Principles

• Explicit approval required before any file manipulation
• Operation logs maintained for potential reversal
• Timestamp preservation on all file modifications
• Graceful conflict handling with user input
• Pause on unexpected situations

---

Best Practices

• Start with a specific folder (like Downloads) before tackling entire systems
• Review the organization plan thoroughly before approval
• Keep backups of important directories
• Let the skill handle the tedious work while you make decisions
• Use custom maintenance commands for ongoing tidiness