Excel 파일을 CSV로 변환하여 Claude Code에서 분석 가능하게 만듦. "엑셀 변환", "Excel CSV", "xlsx 변환", "엑셀을 CSV로", "데이터 변환", "excel to csv" 등을 언급하거나 .xlsx/.xls 파일 경로를 제공하면 자동 실행.
Claude Code는 .xlsx/.xls 파일을 직접 읽을 수 없다. 이 스킬은 Excel 파일을 UTF-8 CSV로 변환하여 분석 가능하게 만든다.
.claude/skills/excel-to-csv/scripts/excel-to-csv.py
pip install openpyxl>=3.1.0
설치 여부를 먼저 확인하고, 없으면 설치한다.
사용자로부터 Excel 파일 경로 또는 폴더 경로를 확인한다. 경로가 명확하지 않으면 Glob으로 .xlsx/.xls 파일을 스캔한다.
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <파일경로> --info
출력 내용:
사용자에게 어떤 시트를 변환할지 확인한다. 단일 시트이거나 사용자가 "전부"라고 하면 바로 진행.
# 전체 시트 변환
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <파일경로> --all
# 특정 시트만
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <파일경로> --sheet "시트명"
# 출력 경로 지정
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <파일경로> --all --output /path/to/output/
# 폴더 일괄 변환
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <폴더경로> --all
# CSV 인코딩 변환 (EUC-KR -> UTF-8)
python .claude/skills/excel-to-csv/scripts/excel-to-csv.py <csv파일경로> --encoding euc-kr
변환 완료 후:
| 조건 | 파일명 패턴 |
|---|---|
| 단일 시트 Excel | {원본파일명}.csv |
| 멀티 시트 Excel | {원본파일명}_{시트명}.csv |
| CSV 인코딩 변환 | {원본파일명}_utf8.csv |
| 입력 | 처리 방식 |
|---|---|
| .xlsx | openpyxl로 읽음 (인코딩 이슈 없음) |
| .xls | openpyxl 호환 시 처리, 아니면 안내 |
| .csv | 인코딩 변환만 수행 (EUC-KR/CP949 -> UTF-8) |
openpyxl 미설치 시: pip install openpyxl>=3.1.0 실행 안내--encoding 옵션으로 강제 지정 안내