Excel Sync 스킬

개요

Claude Code 로 엑셀을 만들면 결과물을 엑셀에서 직접 손보게 됩니다. 문구 하나, 열 너비, 행 하나 추가 같은 것들입니다. 그런데 다음에 코드로 다시 만들면 그 수정이 사라집니다.

Excel Sync는 Claude 가 엑셀을 넘길 때 기준본을 남겨 두고, 사람이 엑셀에서 고치고 저장하면 무엇이 바뀌었는지와 그 칸을 만든 코드 줄을 찾아 줍니다. 반영한 뒤에는 코드로 다시 만든 파일과 사람이 고친 파일을 비교해 차이 0 이 될 때까지 확인합니다.

찾기는 도구가, 고치기는 Claude 가, 확인은 다시 도구가 합니다. 사람이 고친 엑셀은 덮어쓰지 않습니다.

이런 일을 할 수 있습니다

"엑셀에서 고쳤어. 수정한 거 코드에 반영해 줘"
"뭐 바뀌었는지 봐 줘"
"템플릿에 행 두 개 넣었어. 이 템플릿 읽는 코드도 맞춰 줘"

준비물

Claude Code, 파이썬 3.11 이상, openpyxl · olefile
윈도우 + 데스크톱 엑셀과 pywin32(선택) - 엑셀로 다시 저장해 비교하면 openpyxl 과 엑셀 사이의 사소한 흔적 차이가 사라집니다

설치

이 페이지에서 excel-sync.zip을 내려받아 압축을 풉니다.
excel-sync 폴더를 ~/.claude/skills/ 아래에 넣습니다.
이후 Claude 가 엑셀을 만들면 기준본을 남기고, "엑셀에서 고쳤어"라고 하면 바뀐 점을 찾습니다.

주요 기능

기능	하는 일
기준본 남기기	엑셀 파일 옆 `_xlsync/` 폴더에 기준본을 남깁니다. 생성 스크립트를 기록하며 실행하면 칸마다 어느 코드 줄이 썼는지도 함께 남습니다
바뀐 점 찾기	값 · 수식 · 서식 · 행/열 삽입 · 열 너비 · 병합 · 데이터 유효성 · 조건부 서식 · 이름 정의 · 체크박스 · VBA 를 비교하고, 칸마다 그 값을 쓴 코드 위치를 붙입니다
반영 방법 고르기	상수 · 문구 · 서식 설정이면 코드 줄을 고치고, 한두 칸만 다르면 덮어쓰기 목록(overrides.json)으로, 행 · 열 삽입처럼 구조가 바뀌었으면 생성 코드를 고칩니다
차이 0 확인	코드로 다시 만든 파일(임시 경로)과 사람이 고친 파일을 비교해, 0 이 되기 전에는 "반영 완료"라고 하지 않습니다

생성 코드가 없는 템플릿이라면, 바뀐 점과 행 · 열 이동표를 보고 그 템플릿을 읽는 코드의 주소 · 시트 이름을 고칩니다.

FAQ

어떤 것은 비교하지 않나요? - 차트 · 그림 · 도형은 개수만 보고, 피벗 · 슬라이서 · 스파크라인과 계산된 값(캐시) · 선택 칸 · 확대율은 비교하지 않습니다.

기준본에 고객 자료가 남지 않나요? - 기준본은 엑셀 파일 옆에만 남습니다. 고객 자료 폴더 밖(git 저장소 등)으로 옮기지 마세요.

변경 이력

v2026.10.13 - 첫 공개.