file-organizer

File Organizer

This SKILL acts as your personal organization assistant, helping you maintain a clean and logical file structure across your computer without the burden of continuous manual organization.

When to Use

• When the Downloads folder is a mess
• When files are scattered everywhere and you can't find them
• When duplicate files are taking up space
• When the folder structure is no longer logical
• When you want to develop better organization habits
• When starting a new project and needing a good structure
• When you want to organize old projects before archiving them

Key Features

1. Analyze Current Structure: Review folders and files to understand what you have.
2. Find Duplicate Files: Identify duplicate files across the system.
3. Organization Suggestions: Suggest a logical folder structure based on content.
4. Cleanup Automation: Move, rename, and organize files with user approval.
5. Maintain Context: Make smart decisions based on file type, date, and content.
6. Reduce Complexity: Identify old files that are likely no longer needed.

How to Use

From the home directory

cd ~

Then run Claude Code to ask for help:

내 다운로드 폴더 정리를 도와줘

내 문서(Documents) 폴더에서 중복 파일을 찾아줘

내 프로젝트 디렉토리들을 검토하고 개선 사항을 제안해줘

Specific Organization Tasks

다운로드된 파일들을 내용에 따라 적절한 폴더로 정리해줘

중복 파일을 찾아서 어떤 것을 남길지 결정하는 걸 도와줘

6개월 이상 손대지 않은 오래된 파일들을 정리해줘

내 [업무/프로젝트/사진/기타]를 위한 더 나은 폴더 구조를 만들어줘

Instructions

When the user asks for help organizing files:

1. Understand the Scope

   Ask clear questions:

   • Which directory should be organized? (Downloads, Documents, entire home folder, etc.)
   • What is the main problem? (Hard to find files, duplicates, too messy, no structure, etc.)
   • Are there any files or folders to avoid? (Ongoing projects, sensitive data, etc.)
   • How aggressively should it be organized? (Conservative organization vs. comprehensive cleanup)

2. Analyze Current State

   Review the target directory:

   # 현재 구조 개요 파악
   ls -la [대상_디렉토리]
   
   # 파일 유형 및 크기 확인
   find [대상_디렉토리] -type f -exec file {} \; | head -20
   
   # 가장 큰 파일 식별
   du -sh [대상_디렉토리]/* | sort -rh | head -20
   
   # 파일 유형별 카운트
   find [대상_디렉토리] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn
   

   Summary of findings:

   • Total number of files and folders
   • Classification by file type
   • Size distribution
   • Date range
   • Obvious organization issues

3. Identify Organization Patterns

   Determine logical groups based on the files:

   By Type:

   • Documents (PDF, DOCX, TXT)
   • Images (JPG, PNG, SVG)
   • Videos (MP4, MOV)
   • Archives (ZIP, TAR, DMG)
   • Code/Projects (directories containing code)
   • Spreadsheets (XLSX, CSV)
   • Presentations (PPTX, KEY)

   By Purpose:

   • Work vs. Personal
   • Active vs. Archive
   • By Project
   • Reference Materials
   • Temporary/Working Files

   By Date:

   • Current Year/Month
   • Past Years
   • Very Old Files (archive candidates)

4. Find Duplicates

   Search for duplicate files upon request:

   # 해시(hash)를 이용한 정확한 중복 찾기
   find [디렉토리] -type f -exec md5 {} \; | sort | uniq -d
   
   # 이름이 같은 파일 찾기
   find [디렉토리] -type f -printf '%f\n' | sort | uniq -d
   
   # 크기가 유사한 파일 찾기
   find [디렉토리] -type f -printf '%s %p\n' | sort -n
   

   For each duplicate set:

   • Show all file paths
   • Show size and modification date
   • Recommend which file to keep (usually the newest or the best-named one)
   • Important: Always go through a confirmation process before deleting.

5. Propose Organization Plan

   Present a clear plan before applying changes:

   # [디렉토리] 정리 계획
   
   ## 현재 상태
   - Y개 폴더에 총 X개 파일 존재
   - 총 용량: [크기]
   - 파일 유형: [분류]
   - 이슈: [문제 목록]
   
   ## 제안하는 구조
   
   

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

   
   ## 실행할 변경 사항
   
   1. **새 폴더 생성**: [목록]
   2. **파일 이동**:
      - X개의 PDF → Work/Documents/
      - Y개의 이미지 → Personal/Photos/
      - Z개의 오래된 파일 → Archive/
   3. **이름 변경**: [이름 변경 패턴]
   4. **삭제**: [중복 또는 휴지통 파일]
   
   ## 확인이 필요한 파일
   
   - [확실하지 않은 파일 목록]
   
   진행할까요? (yes/no/modify)
   

6. Execute Organization

   After approval, proceed with organization systematically:

   # 폴더 구조 생성
   mkdir -p "path/to/new/folders"
   
   # 명확한 로깅과 함께 파일 이동
   mv "old/path/file.pdf" "new/path/file.pdf"
   
   # 일관된 패턴으로 파일 이름 변경
   # 예: "YYYY-MM-DD - 설명.ext"
   

   Important Rules:

   • Always confirm before deleting.
   • Keep a record of all moves so they can be undone later.
   • Preserve the original modification dates.
   • Handle file name conflicts appropriately.
   • If an unexpected situation occurs, stop and ask.

7. Provide Summary and Maintenance Tips

   After organization is complete:

   # 정리 완료! ✨
   
   ## 변경 내용
   
   - [X]개의 새 폴더 생성
   - [Y]개의 파일 정리 완료
   - 중복 제거로 [Z] GB 공간 확보
   - [W]개의 오래된 파일 아카이브 처리
   
   ## 새로운 구조
   
   [새로운 폴더 트리 표시]
   
   ## 유지 관리 팁
   
   이 상태를 유지하려면:
   
   1. **매주**: 새로운 다운로드 파일 분류
   2. **매월**: 완료된 프로젝트 검토 및 아카이브
   3. **매분기**: 새로운 중복 파일 체크
   4. **매년**: 오래된 파일 아카이브
   
   ## 활용 가능한 명령어
   
   ```bash
   # 이번 주에 수정된 파일 찾기
   find . -type f -mtime -7
   
   # 유형별 다운로드 정렬
   [사용자 환경에 맞춘 커스텀 명령]
   
   # 중복 찾기
   [커스텀 명령]
   

   Would you like to organize other folders too?

Examples

Example 1: Organizing the Downloads folder (Justin Dielmann case)

User: "My Downloads folder has over 500 files and is a mess. Help me organize it."

Process:

1. Analyze the Downloads folder
2. Patterns found: work documents, personal photos, installer files, random PDFs, etc.
3. Proposed structure:
   • Downloads/
     • Work/
     • Personal/
     • Installers/ (DMG, PKG files)
     • Archive/
     • ToSort/ (items that need a decision)
4. Request confirmation
5. Intelligently move files based on content and names
6. Result: 500 files → 5 organized folders

Example 2: Finding and removing duplicate files

User: "Find duplicate files in my Documents folder and help me decide which ones to keep."

Output:

# 23세트의 중복 파일 발견 (총 156 MB)

## 중복 세트 1: "proposal.pdf"
- `/Documents/proposal.pdf` (2.3 MB, 수정: 2024-03-15)
- `/Documents/old/proposal.pdf` (2.3 MB, 수정: 2024-03-15)
- `/Desktop/proposal.pdf` (2.3 MB, 수정: 2024-03-10)

**권장 사항**: `/Documents/proposal.pdf` 유지 (올바른 위치에 있는 최신 파일)
나머지 2개 복사본을 삭제할까요?

[모든 중복 항목에 대해 계속...]

Example 3: Restructuring a project folder

User: "Review the ~/Projects directory and suggest improvements."

Output:

# ~/Projects 분석 결과

## 현재 구조의 문제점
- 활성 프로젝트와 아카이브된 프로젝트(3년 이상 됨)가 섞여 있음
- 일관된 명명 규칙이 없음
- 어떤 프로젝트는 루트에 있고, 어떤 것은 임의의 하위 폴더에 있음
- 중복된 폴더 (project-name, project-name-old, project-name-v2)

## 제안하는 구조

Projects/ ├── Active/ │ ├── client-work/ │ ├── side-projects/ │ └── learning/ ├── Archive/ │ ├── 2022/ │ ├── 2023/ │ └── 2024/ └── Templates/

## 구체적인 변경 사항
1. 2022년 이후 손대지 않은 12개 프로젝트 이동 → Archive/
2. 4개의 중복된 프로젝트 폴더 통합
3. 프로젝트 이름을 일관된 형식으로 변경: "client-name-project-name"
4. 오래된 작업물을 위한 아카이브 생성

제가 이를 실행할까요?

Example 4: Organizing photos by date

User: "Organize my photo folder by year and month."

Output: Creates the following structure:

Photos/
├── 2023/
│   ├── 01-January/
│   ├── 02-February/
│   └── ...
├── 2024/
│   ├── 01-January/
│   └── ...
└── Unsorted/

Then move photos based on EXIF data or file modification date.

Common cleanup tasks

Downloads cleanup

다운로드 폴더를 정리해줘 - 문서는 Documents로, 
사진은 Pictures로 이동하고, 설치 파일은 따로 보관해. 
3개월 넘은 파일들은 아카이브해줘.

Project organization

내 Projects 폴더 구조를 검토하고 활성 프로젝트와 
아카이브해야 할 오래된 프로젝트를 분리하는 걸 도와줘.

Duplicate removal

내 Documents 폴더의 모든 중복 파일을 찾고 
어떤 걸 남길지 결정하는 걸 도와줘.

Desktop organization

내 바탕화면이 파일로 가득 찼어. 전부 Documents 폴더로 
제대로 정리하는 걸 도와줘.

Photo organization

이 폴더의 모든 사진을 찍은 날짜(연도/월)별로 정리해줘.

Work/personal separation

내 Documents 폴더 전체에서 업무용 파일과 
개인용 파일을 분리하는 걸 도와줘.

Pro Tips

1. Start small: Start with one messy folder like Downloads to build trust.
2. Regular maintenance: Run a weekly cleanup on your Downloads folder.
3. Consistent naming: Use the "YYYY-MM-DD - description" format for important files.
4. Proactive archiving: Don't delete old projects; move them to Archive.
5. Separate active status: Maintain a clear boundary between work in progress and archived work.
6. Trust the process: Let Claude handle the cognitive load of deciding what goes where.

Best Practices

Folder naming conventions

• Use clear and descriptive names.
• Avoid spaces (use hyphens or underscores).
• Be specific: "client-proposals" instead of "docs".
• Use prefixes for ordering: "01-current", "02-archive".

File naming conventions

• Include the date: "2024-10-17-meeting-notes.md"
• Be descriptive: "q3-financial-report.xlsx"
• Don't put version numbers in names (use a version control system instead).
• Remove download traces: "document-final-v2 (1).pdf" → "document.pdf"

When to archive

• Projects untouched for 6 months or more
• Completed work that may be referenced later
• Previous versions after migrating to a new system
• Files you hesitate to delete (archive them first)

Related use cases

• Initial cleanup setup for a new computer
• Preparing files for backup/archive
• Cleanup before organizing storage space
• Organizing a shared team folder
• Setting up a new project directory structure