xlsx — Claude Code 스킬

Excel(.xlsx) 스프레드시트를 다루는 Anthropic 공식 스킬. 수식 오류 없는 생성, 차트, 조건부 서식, 피벗 테이블 등을 지원한다.

xlsx는 Claude Code가 Excel 스프레드시트(.xlsx, .xlsm, .csv, .tsv)를 직접 다루도록 하는 Anthropic 공식 문서 스킬(document-skills 묶음)이다. "스프레드시트 파일이 주된 입력 또는 출력일 때" 발동하며, 기존 시트를 열어 읽고 수정·보정하거나 새 시트를 처음부터 만들고 표 형식 간 변환을 수행한다.

핵심은 단순 값 채우기가 아니라 동적 스프레드시트 유지다. 하드코딩된 값 대신 실제 Excel 수식을 넣어 입력값이 바뀌면 결과가 따라 갱신되게 하고, 재무 모델 관례(입력=파랑, 수식=검정, 시트 내 링크=초록, 외부 링크=빨강)와 숫자 서식(연도는 텍스트, 통화는 단위 표기, 백분율 0.0%)을 적용한다. 하드코딩 값에는 출처와 날짜를 기록하도록 요구한다.

작업에는 두 라이브러리를 쓴다. pandas는 데이터 분석·대량 처리·집계에, openpyxl은 복잡한 서식·수식·Excel 고유 기능에 사용한다. 또한 LibreOffice를 이용한 자동 재계산(scripts/recalc.py)으로 산출물을 검증해 #REF!, #DIV/0!, #VALUE!, #N/A, #NAME? 같은 수식 오류가 0인 상태로 결과를 내보내며, 오류가 있으면 위치를 담은 JSON 리포트를 돌려준다. 열 추가, 수식 계산, 조건부 서식, 깨진 행·잘못된 헤더·잡데이터 정리 같은 작업도 처리한다.

데이터 분석가, 재무 모델 담당자, 리포트를 반복 생성하는 운영 담당자, 지저분한 CSV를 정돈된 Excel로 바꿔야 하는 사람에게 적합하다. 차트·피벗 등 세부 동작과 최신 지원 범위는 공식 SKILL.md 확인을 권장한다.

언제 쓰나

스프레드시트 자체가 최종 산출물일 때 쓴다. 수식이 살아있는 재무·예측 모델을 만들거나, 기존 .xlsx를 열어 열 추가·수식 보정·서식 적용을 하거나, 지저분한 CSV/표 데이터를 정돈된 Excel로 변환할 때 유용하다. 수식 오류 없는 결과와 일관된 숫자·색 서식이 필요한 반복 리포트 작업에 특히 맞다. 반대로 산출물이 Word·HTML·DB·Google Sheets면 다른 스킬을 고려한다.

설치

/plugin marketplace add anthropics/skills 후 /plugin install document-skills@anthropic-agent-skills

Anthropic skills 마켓플레이스를 추가한 뒤 document-skills 플러그인을 설치하면 함께 제공된다(pdf·docx·pptx 등과 묶음). 별도 API 키는 필요 없다. 다만 데이터 처리에 pandas·openpyxl이, 수식 재계산에는 LibreOffice가 필요하며 LibreOffice는 첫 실행 시 자동 구성된다고 안내된다 — 환경에 미설치 시 재계산·오류검증 단계가 동작하지 않을 수 있으니 사전 설치 여부를 확인하라. 정확한 의존성·발동 조건은 공식 SKILL.md 확인 권장.

보안 주의

외부 네트워크 호출이나 API 키·비밀키가 필요 없는 로컬 파일 처리 스킬이라 자격증명 유출 위험은 낮다. 다만 로컬 파일 시스템에서 스프레드시트를 읽고 쓰며 기존 파일을 덮어쓸 수 있으므로, 중요한 원본은 백업 후 작업하라. 신뢰할 수 없는 출처의 시트에는 수식·외부 링크·매크로(.xlsm)가 포함될 수 있어 의도치 않은 데이터 참조나 외부 링크 평가가 일어날 수 있다 — 내용을 검토하고 필요 시 매크로를 비활성화하라. 민감·개인정보가 든 시트를 다룰 때는 산출물 공유 범위에 주의한다.

자주 묻는 질문

수식이 깨진 채로 결과가 나오나요?

아니요. 이 스킬은 LibreOffice 기반 자동 재계산(scripts/recalc.py)으로 산출물을 검증해 #REF!, #DIV/0!, #VALUE!, #N/A, #NAME? 같은 수식 오류가 0인 상태로 내보내는 것을 목표로 합니다. 오류가 발견되면 위치가 담긴 JSON 리포트를 돌려줍니다.

값을 그냥 채우지 않고 수식으로 넣나요?

네. 하드코딩된 값 대신 실제 Excel 수식을 사용해 입력이 바뀌면 결과가 자동으로 갱신되는 동적 시트를 지향합니다. 재무 모델 색 규칙(입력 파랑, 수식 검정, 내부 링크 초록, 외부 링크 빨강)과 표준 숫자 서식도 적용합니다.

CSV나 지저분한 데이터도 정리해 주나요?

네. .csv/.tsv를 포함한 표 형식 간 변환을 지원하고, 깨진 행·잘못 놓인 헤더·잡데이터 같은 지저분한 데이터를 정리하는 작업도 처리합니다. pandas로 대량 처리, openpyxl로 서식·수식 작업을 수행합니다.