[Skills] Smart File Organizer: 파일 내용 기반 Rename&Sorting Skill

Smart File Organizer: 파일 내용 보고 이름 바꿔주는 AI Skill

npx skills add surrealier/SmartFileOrganizer

bash에서 위 명령어로 설치 & 사용 가능

사용법: Claude Code나 Kiro-CLI같은 AI agent 환경에서 "skills로 **폴더 카테고리별로 정리해줘. rename도 해줘"

---

대학원 다니던 시절에 쓰던 외장 SSD가 있었는데, 어느 날 꽂았더니 파일명이 다 깨져있었다,, 한글 인코딩이 날아간건지 뭔지 모르겠는데 이런 식으로 수백 개가 되어있는거임;;

하나하나 열어보면서 자료 확인하고 이름 수정하려니 너무,,, 오래 걸릴 것 같았다. PDF만 해도 몇백 개인데 hwp, pptx, 이미지까지 있으니까 엄두도 안 났다. 그래서 이참에 Skill이라는 것도 한번 만들어보고싶어서 기능을 생각해봤는데,

파일 내용을 읽어서 알아서 이름 지어주고, 카테고리별로 폴더까지 정리해주는게 있으면 좋겠다 싶어서 만들었다.

https://github.com/surrealier/SmartFileOrganizer?tab=readme-ov-file

GitHub - surrealier/SmartFileOrganizer: File/Folder Organizer Skill. Easily Sort and Rename based on Entire Contents!

Claude Code나 Kiro-CLI 같은 skills.sh 호환 에이전트에서 쓸 수 있는 Skill이다. 설치하면 에이전트한테 "이 폴더 정리해줘"라고 말하는 것만으로 파일 정리가 된다.

핵심은 파일 내용을 직접 읽고 분석해서 이름을 짓는다는 것이다. 원래 파일명은 아예 안 본다. document(3).pdf든 ???_???.hwpx든 상관없이, 내용물을 보고 처음부터 이름을 새로 만든다.

---

주요 기능

- 디렉토리 재귀 스캔
- PDF, docx, pptx, hwp, hwpx, 이미지 등 내용 분석
- 인코딩 깨진 파일도 자동 감지 (UTF-8 → CP949 → Shift_JIS → GB2312 → EUC-KR → Latin-1 순서로 시도)
- 언어 설정 가능 — 일본어 파일인데 한국어 이름으로 바꿔줘, 이런 것도 됨
- 데이터셋 폴더 자동 감지 (train/, val/ 같은 폴더 1만개 파일 rename 하면 안 되니까,,)
- 드라이런 미리보기 → 승인 후 실행
- 롤백 지원 — 잘못되면 되돌리기 가능

모드는 두 가지다.

1. rename-only (기본): 파일 이름만 바꾸고, 폴더 구조는 안 건드림.
2. full-organize: 이름도 바꾸고, 폴더도 새로 만들고/합치고/이름 바꾸고 정리까지

LLM이니까 그냥 싹 다 바꿔줘!!! 라고 해도 알아먹는다.

---

사용법

설치하고 나면 에이전트한테 말만 하면 된다.

- ~/Downloads 폴더 정리해줘, 파일 내용 보고 이름 바꿔줘
- 이 폴더 full-organize 모드로 정리해줘, 한국어로
- 아까 정리한거 롤백해줘

그러면 에이전트가 알아서 이런 흐름으로 진행한다.

1. 대상 폴더, 모드, 언어 설정 물어봄
2. 파일 스캔하고 데이터셋 폴더 있으면 "이거 데이터셋 같은데 스킵할까요?" 물어봄
3. 파일 내용 분석
4. 드라이런 결과 보여줌:
5. 승인하면 실행, 아니면 수정 요청 가능
6. full-organize면 폴더 구조 재편성까지
7. 롤백 맵 저장

---

흐름 예시 이미지

1. 요청한다

2. 보여준다.

3. 물어본다.

4. 답변한다.

이렇게 하면 완료된다. 파일 많이 보고 하니까 오래걸린다.

summary md파일도 준다.

다 끝나면 혹시모르니 롤백도 되어야하니까 이런 json파일도 남겨놓는다.

짠! (한 폴더에 200개 파일 있었음)

---

Skill, 코딩보다 쉽다!