Drilldown Table — Gerador de Tabelas Hierárquicas
pal815/drilldown-table
Tabelas hierárquicas drill-down para Excel/Word/PowerPoint com 3 orientações e temas
Ver no GitHubSkill que gera tabelas hierárquicas em formato ┌ (drill-down) para Excel, Word e PowerPoint a partir de dados estruturados. Suporta 3 orientações (linha, coluna, 2D cruzada), 3 temas visuais e múltiplos níveis de profundidade com renderização idêntica entre formatos via IR único.
Instalação
npx convez-ai pal815/drilldown-table1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar relatórios executivos com tabelas hierárquicas de múltiplos níveis
- Criar apresentações de desempenho por unidade/departamento com drill-down automático
- Padronizar tabelas hierárquicas em documentos corporativos (IR, relatórios financeiros)
Veredito

Solução robusta e bem-estruturada para um problema real em documentos corporativos. Arquitetura limpa (IR + 3 renderizadores) garante coerência entre formatos; integração nativa com Claude skill é pronta. Ideal para equipes que precisam automatizar relatórios hierárquicos de forma profissional.
README
A tradução para o português deste README ainda está na fila.
drilldown-table — 드릴다운(┌ / 코너헤더) 계층형 표 생성기
상위 항목을 좌상단 코너에 두고 세부(drill-through)를 옆 열·아래 행으로 ┌ 모양으로 펼쳐 묶는, 기업 보고서·실적 자료식 계층형 표(일명 "ㄱ자 표") 를 Excel(.xlsx)·Word(.docx)·PowerPoint(.pptx) 로 생성합니다.
데이터만 주면 동일한 v14 양식으로 3종 문서를 만들고, 방향 3 × 테마 3을 옵션으로 받습니다.
- 방향 —
row(항목 세로) ·column(항목 가로) ·both(행·열 2D 교차표) - 테마 —
color(네이비/연파랑) ·grey(그레이스케일) ·mono(테두리만) - 다단계 — 대분류>중분류>… 깊이 2~4단계 자동 인식(행·열), 합계 줄 생략 시 자동 합산, 가지별 깊이 달라도 됨
- 단일 IR(공용 중간표현) → 3 렌더러. 양식은 v14로 동결.
결과 예시
다단계(depth 2~4) — 상위 ▸ 중간 ▸ 세부를 ┌ 모양으로 묶는 행 기준 표(가지별 깊이 달라도 됨):

열 기준(column) — 항목이 가로로 펼쳐지고 세부가 아래로:

행+열 2D 교차표(both) — 좌상단 코너에 행 \ 열, 양방향 드릴다운:

테마 3가지 — color · grey · mono:
위 스크린샷은
docs/make_screenshots.py로 재생성합니다(Windows + Excel 필요). 원본 산출물은samples/참고.
네 가지 사용 방법
이 리포는 하나의 엔진(drilldown_table.py)을 여러 방식으로 감쌉니다.
1) Claude Code / Codex 스킬 (플러그인)
리포 루트가 그대로 Claude Code 스킬·플러그인입니다(SKILL.md, .claude-plugin/plugin.json, commands/).
- 개인 스킬: 리포를
~/.claude/skills/drilldown-table로 두거나 플러그인으로 설치. - "사업부별 실적 표 만들어 / 드릴다운 표 / ㄱ자 표" 같은 요청에 발동.
- 데이터 스키마는
examples/의sample_column.yaml(row·column) /sample_both.yaml(both) 참고.
2) 데스크톱 앱 (EXE) — 언어모델·파이썬 불필요
일반 사무직용 GUI. 엑셀 첨부 또는 클립보드 붙여넣기 → 방향·테마·포맷 선택 → 생성.
DRM/다중시트 엑셀은 Excel COM으로 자동 처리. 빌드·배포는 app/ 참조.
cd app
.\build.ps1 # PyInstaller onedir EXE (창모드). -OneFile / -Console 옵션
3) 웹 (브라우저, 설치 0) — 잠긴 PC용
단일 HTML 한 파일을 브라우저에서 열면 Pyodide로 동일 엔진이 돕니다(데이터는 PC 밖으로 안 나감).
cd app
py build_web.py # → app/drilldown_web.html 생성(엔진 바뀌면 다시 실행)
4) Python에서 직접
import drilldown_table as G
G.generate(model, "out.xlsx", "row", "color") # 단일
# 또는 CLI: py drilldown_table.py data.yaml out.pptx column grey
리포 구조
drilldown-table/
├─ drilldown_table.py # ★ 엔진(단일 소스) — IR + 3 렌더러 + 레이아웃 빌더
├─ SKILL.md # Claude/Codex 스킬 정의
├─ .claude-plugin/ # 플러그인 매니페스트
├─ commands/ # /drilldown-table 슬래시 커맨드
├─ examples/ # 입력 데이터 스키마 예시(YAML)
├─ samples/ # 쇼케이스 출력물(v14 × 3테마 × 3포맷)
├─ render_png.py / render_pptx_png.py / render_docx_png.py # 검수용 PNG 렌더
└─ app/ # 독립 배포 wrapper(EXE + 웹)
├─ app.py · excel_io.py # GUI/CLI + 입력양식↔모델 어댑터
├─ build.ps1 · build_web.py · sign.ps1
├─ assets/ # GUI 아이콘·미리보기 썸네일
├─ RELEASE.md · 사용법.txt · 웹버전_안내.txt
└─ make_*.py · pyodide_verify.mjs
엔진 단일 소스: drilldown_table.py가 정본이며, app/(빌드 시 번들)과 Claude/Codex 스킬 설치본이 이를 사용합니다.
별도 위치(~/.claude/skills/…, ~/.codex/skills/…)에 설치된 사본은 sync.ps1로 동기화합니다:
.\sync.ps1 # Claude + Codex 둘 다 (엔진·예시·렌더, Claude는 SKILL/plugin 포함)
요구 사항
- Python 3.10+ (개발/스킬 사용 시). 끝사용자는 EXE/웹이면 불필요.
- 패키지:
openpyxl,python-docx,python-pptx,PyYAML(스킬 입력),customtkinter·Pillow(앱 GUI),pywin32(Excel COM·검수 렌더). - Excel COM 입력/PNG 검수 렌더는 Windows + Microsoft Excel 필요.