$npx -y skills add claude-office-skills/skills --skill file-organizerOrganize and rename files based on content analysis
| 1 | # File Organizer |
| 2 | |
| 3 | Intelligently organize and rename files based on their content and metadata. |
| 4 | |
| 5 | ## Overview |
| 6 | |
| 7 | This skill helps you: |
| 8 | - Analyze file contents to determine categorization |
| 9 | - Suggest folder structures |
| 10 | - Generate consistent naming conventions |
| 11 | - Identify and handle duplicates |
| 12 | - Create organization systems |
| 13 | |
| 14 | ## How to Use |
| 15 | |
| 16 | ### Analyze Files |
| 17 | ``` |
| 18 | "Analyze these files and suggest how to organize them" |
| 19 | "What category does this file belong to?" |
| 20 | "Suggest a better filename for this document" |
| 21 | ``` |
| 22 | |
| 23 | ### Organize |
| 24 | ``` |
| 25 | "Create a folder structure for my project files" |
| 26 | "Organize my downloads folder" |
| 27 | "Sort these invoices by vendor and date" |
| 28 | ``` |
| 29 | |
| 30 | ## Naming Conventions |
| 31 | |
| 32 | ### Recommended Formats |
| 33 | |
| 34 | **Documents** |
| 35 | ``` |
| 36 | YYYY-MM-DD_Category_Description_v1.ext |
| 37 | Example: 2026-01-29_Contract_ClientName_NDA_v1.pdf |
| 38 | ``` |
| 39 | |
| 40 | **Images** |
| 41 | ``` |
| 42 | YYYY-MM-DD_Event/Project_Description_NNN.ext |
| 43 | Example: 2026-01-29_ProductLaunch_HeroImage_001.png |
| 44 | ``` |
| 45 | |
| 46 | **Invoices/Receipts** |
| 47 | ``` |
| 48 | YYYY-MM-DD_Vendor_Amount_InvoiceNumber.ext |
| 49 | Example: 2026-01-29_Adobe_149.99_INV-12345.pdf |
| 50 | ``` |
| 51 | |
| 52 | **Meeting Notes** |
| 53 | ``` |
| 54 | YYYY-MM-DD_MeetingType_Topic.ext |
| 55 | Example: 2026-01-29_TeamSync_Q1Planning.md |
| 56 | ``` |
| 57 | |
| 58 | ### Naming Rules |
| 59 | - Use underscores or hyphens, not spaces |
| 60 | - Start with date for chronological sorting |
| 61 | - Include key identifiers (client, project, type) |
| 62 | - Add version numbers for iterations |
| 63 | - Keep names concise but descriptive |
| 64 | |
| 65 | ## Folder Structures |
| 66 | |
| 67 | ### Personal Documents |
| 68 | ``` |
| 69 | 📁 Documents |
| 70 | ├── 📁 Admin |
| 71 | │ ├── 📁 Finance |
| 72 | │ │ ├── 📁 Invoices |
| 73 | │ │ ├── 📁 Receipts |
| 74 | │ │ └── 📁 Tax |
| 75 | │ ├── 📁 Insurance |
| 76 | │ └── 📁 Legal |
| 77 | ├── 📁 Work |
| 78 | │ ├── 📁 Projects |
| 79 | │ ├── 📁 Reports |
| 80 | │ └── 📁 Meetings |
| 81 | ├── 📁 Personal |
| 82 | │ ├── 📁 Health |
| 83 | │ ├── 📁 Education |
| 84 | │ └── 📁 Travel |
| 85 | └── 📁 Archive |
| 86 | └── 📁 [Year] |
| 87 | ``` |
| 88 | |
| 89 | ### Project-Based |
| 90 | ``` |
| 91 | 📁 ProjectName |
| 92 | ├── 📁 01_Planning |
| 93 | │ ├── 📁 Requirements |
| 94 | │ ├── 📁 Proposals |
| 95 | │ └── 📁 Research |
| 96 | ├── 📁 02_Design |
| 97 | │ ├── 📁 Mockups |
| 98 | │ ├── 📁 Assets |
| 99 | │ └── 📁 Specs |
| 100 | ├── 📁 03_Development |
| 101 | │ ├── 📁 Source |
| 102 | │ ├── 📁 Tests |
| 103 | │ └── 📁 Documentation |
| 104 | ├── 📁 04_Deliverables |
| 105 | │ └── 📁 [Version] |
| 106 | ├── 📁 05_Admin |
| 107 | │ ├── 📁 Contracts |
| 108 | │ ├── 📁 Invoices |
| 109 | │ └── 📁 Communications |
| 110 | └── 📁 Archive |
| 111 | ``` |
| 112 | |
| 113 | ### Client/Vendor |
| 114 | ``` |
| 115 | 📁 Clients |
| 116 | └── 📁 [ClientName] |
| 117 | ├── 📁 Contracts |
| 118 | ├── 📁 Projects |
| 119 | │ └── 📁 [ProjectName] |
| 120 | ├── 📁 Invoices |
| 121 | ├── 📁 Communications |
| 122 | └── 📁 Assets |
| 123 | ``` |
| 124 | |
| 125 | ## Output Formats |
| 126 | |
| 127 | ### Organization Plan |
| 128 | ```markdown |
| 129 | ## File Organization Plan |
| 130 | |
| 131 | **Source**: [Folder/Location] |
| 132 | **Total Files**: [Count] |
| 133 | **Total Size**: [Size] |
| 134 | |
| 135 | ### Proposed Structure |
| 136 | [Folder tree] |
| 137 | |
| 138 | ### File Mapping |
| 139 | | Original Name | New Name | Destination | |
| 140 | |--------------|----------|-------------| |
| 141 | | IMG_1234.jpg | 2026-01-29_ProductPhoto_001.jpg | /Products/Photos/ | |
| 142 | | doc1.pdf | 2026-01-15_Contract_ClientA_NDA.pdf | /Clients/ClientA/Contracts/ | |
| 143 | |
| 144 | ### Actions Required |
| 145 | 1. Create folders: [list] |
| 146 | 2. Rename files: [count] |
| 147 | 3. Move files: [count] |
| 148 | 4. Review manually: [count with reasons] |
| 149 | ``` |
| 150 | |
| 151 | ### Duplicate Report |
| 152 | ```markdown |
| 153 | ## Duplicate Files Report |
| 154 | |
| 155 | **Total Duplicates Found**: [Count] |
| 156 | **Space Recoverable**: [Size] |
| 157 | |
| 158 | ### Exact Duplicates |
| 159 | | File | Locations | Size | Recommendation | |
| 160 | |------|-----------|------|----------------| |
| 161 | | report.pdf | /Downloads/, /Documents/ | 2.3MB | Keep in /Documents/ | |
| 162 | |
| 163 | ### Similar Files |
| 164 | | Files | Similarity | Difference | |
| 165 | |-------|------------|------------| |
| 166 | | report_v1.pdf, report_v2.pdf | 95% | v2 has extra page | |
| 167 | ``` |
| 168 | |
| 169 | ## Analysis Capabilities |
| 170 | |
| 171 | ### Content-Based Categorization |
| 172 | - **Documents**: Contracts, reports, letters, forms |
| 173 | - **Financial**: Invoices, receipts, statements, budgets |
| 174 | - **Media**: Photos, videos, audio, graphics |
| 175 | - **Code**: Source files, configs, documentation |
| 176 | - **Data**: Spreadsheets, databases, exports |
| 177 | |
| 178 | ### Metadata Extraction |
| 179 | - Creation/modification dates |
| 180 | - Author information |
| 181 | - File dimensions (images/video) |
| 182 | - Duration (audio/video) |
| 183 | - Page count (documents) |
| 184 | |
| 185 | ## Automation Rules |
| 186 | |
| 187 | ### Example Rules |
| 188 | ```markdown |
| 189 | ## Auto-Organization Rules |
| 190 | |
| 191 | ### Rule 1: Invoices |
| 192 | - Trigger: PDF with "Invoice" or "INV-" in content |
| 193 | - Action: Move to /Finance/Invoices/[Year]/[Month]/ |
| 194 | - Rename: YYYY |