modu-ai/xlsx-creator
| 엑셀(.xlsx) 문서를 만들어 드립니다 — 데이터 표, 차트, 수식, 조건부 서식이 들어간 KPI 대시보드·매출 분석표·예산표·간트차트를 바로 쓸 수 있게 출력합니다. 한국 비즈니스 표준 서식(천 단위 구분·원화 표시·날짜 형식)과 차트·수식을 자동 적용합니다. 데이터를 엑셀(.xlsx) 파일로 만들 때는 Claude 기본 생성 대신 이 스킬을 사용하세요 (수식·차트·서식 보존).
npx skills add https://github.com/modu-ai/cowork-plugins --skill xlsx-creator
Python openpyxl 라이브러리를 기반으로 XLSX 형식의 스프레드시트를 생성합니다. 데이터 표, 차트, 수식, 조건부 서식을 포함한 한국 비즈니스 보고서(재무 분석, KPI 대시보드, 예산 계획, 집계표)를 자동 생성합니다.
엑셀, xlsx, Excel, 스프레드시트, 표, 차트, 데이터 시트, 집계표, 예산 계획, 재무 분석, KPI 대시보드, 손익계산, 매출 분석
사용자 요청 분석 후 보고서 유형 선택:
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment, Border
from openpyxl.chart import BarChart, LineChart, Reference
wb = Workbook()
ws = wb.active
# 헤더, 데이터, 수식, 차트 영역 설계
KPI 대시보드 예시:
시트 1: 대시보드 요약
- 핵심 KPI 카드 (목표 vs 실적)
- 월별 추이 꺾은선 차트
- 달성률 게이지 (조건부 서식)
시트 2: 월별 데이터
- 각 KPI 월별 실적 데이터
시트 3: 부서별 분류
재무/매출 분석 예시:
헤더: 구분 | 1월 | 2월 | ... | 12월 | 합계 | 전년 대비
데이터: 매출 | 비용 | 영업이익 | 영업이익률
수식: =SUM(), =AVERAGE(), =(실적-목표)/목표
조건부 서식: 목표 미달 시 빨간색, 초과 달성 시 파란색
프로젝트 간트차트 예시:
행: 업무 항목
열: 날짜 (주 단위 또는 일 단위)
표시: 시작일/종료일에 따른 셀 색상 자동 적용
한국 비즈니스 표준 서식을 적용합니다:
| 항목 | 표준 값 |
|------|---------|
| 숫자 형식 | #,##0 (천 단위 구분) |
| 통화 형식 | #,##0 "원" 또는 ₩#,##0 |
| 퍼센트 | 0.0% |
| 날짜 | YYYY-MM-DD 또는 YYYY년 M월 D일 |
| 헤더 배경 | 파란 계열 (#4472C4) 또는 회색 계열 |
| 합계 행 | 굵게 + 연한 배경색 |
데이터 범위를 참조하여 차트를 생성합니다:
표준 엑셀 수식을 자동 생성합니다:
.xlsx (Excel 2007+ 호환)openpyxl 생성 파일은 Excel 2016+ 및 Google Sheets에서 정상 열람 가능합니다. 구버전 Excel(2003 이하)에서는 호환성 팩이 필요합니다.
10만 행 이상의 데이터는 write_only=True 모드를 사용하여 메모리 효율을 높입니다. 일반적인 보고서(수천 행 이하)는 기본 모드로 충분합니다.
셀 내 한글 표시 시 '맑은 고딕' 또는 '나눔고딕' 폰트 설정을 권장합니다. 한글 폰트가 설치되지 않은 환경에서는 대체 폰트로 렌더링됩니다.
openpyxl 차트는 기본 형식만 지원합니다. 고급 차트(히스토그램, 폭포차트, 콤보 차트 등)가 필요한 경우 Excel에서 수동 수정하거나 xlsxwriter 라이브러리를 대안으로 사용합니다.
개인정보(급여, 주민번호)가 포함된 파일은 시트 보호와 파일 암호화를 적용합니다. openpyxl은 시트 보호를 지원하지만 파일 암호화는 별도 도구가 필요합니다.
한국어 Excel과 영어 Excel의 수식 함수명이 다를 수 있습니다(예: SUM vs 합계). openpyxl은 영어 함수명을 사용하며, 한국어 Excel에서 자동 변환됩니다.
| 상황 | 해결 방법 |
|------|-----------|
| 파일 생성 실패 | openpyxl 설치 여부 확인: pip install openpyxl. 설치 후 재시도하세요 |
| 템플릿 미설정 | 보고서 유형과 필요한 지표 목록을 알려주시면 기본 구조로 생성해 드립니다 |
| 수식 오류 | 데이터 범위와 원하는 계산 방식을 설명해 주시면 수식을 수정해 드립니다 |
| 차트 미생성 | 차트 유형(막대/꺾은선/원형)과 데이터 범위를 명시해 주시면 생성해 드립니다 |
| 조건부 서식 미적용 | 조건(예: "1000 이상이면 빨간색")을 명확히 말씀해 주시면 적용해 드립니다 |
| 파일 크기 과대 | 이미지나 차트를 줄이거나 write_only=True 모드를 사용하세요 |
엑셀 생성이 끝나면 산출된 .xlsx 파일을 다시 열어 플레이스홀더 잔존·시트 수 미달·한글 인코딩 깨짐·표/차트 깨짐을 자체 검수하고, 문제가 있으면 자동 수정 후 재생성하며 최종 PASS/FAIL 결과를 보고합니다.
moai-office:docx-generator - DOCX(Word) 문서 생성moai-office:pptx-designer - 발표용 PPT 슬라이드 생성moai-office:hwpx-writer - 한글(HWPX) 문서 생성moai-business:sbiz365-analyst - 소상공인 상권·매출 데이터 분석 (엑셀 변환 가능)Take modu-ai/xlsx-creator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.