📌 참고: 이 문서는 공식 Claude Code 문서의 원문 + 레퍼런스입니다.

• 원문 링크를 직접 사용하셔도 됩니다
• 이 파일을 .claude/skills/ 하위에 복사하여 스킬로 등록할 수도 있습니다

(2026.03.15 기준)

PPTX 스킬

빠른 참조

작업	가이드
내용 읽기/분석	python -m markitdown presentation.pptx
템플릿에서 편집 또는 생성	editing.md 읽기
처음부터 생성	pptxgenjs.md 읽기

---

내용 읽기

# 텍스트 추출
python -m markitdown presentation.pptx

# 시각적 미리보기
python scripts/thumbnail.py presentation.pptx

# 원본 XML
python scripts/office/unpack.py presentation.pptx unpacked/

---

편집 워크플로우

전체 세부사항은 editing.md를 읽으세요.

1. thumbnail.py로 템플릿 분석
2. 언팩 → 슬라이드 조작 → 내용 편집 → 정리 → 팩

---

처음부터 생성

전체 세부사항은 pptxgenjs.md를 읽으세요.

템플릿이나 참조 프레젠테이션이 없을 때 사용합니다.

---

디자인 아이디어

지루한 슬라이드를 만들지 마세요. 흰 배경에 평범한 글머리 기호는 아무도 감동시키지 못합니다. 각 슬라이드에 이 목록의 아이디어를 고려하세요.

시작하기 전에

• 대담하고 콘텐츠에 맞는 색상 팔레트를 선택하세요: 팔레트는 이 주제를 위해 디자인된 느낌이어야 합니다. 색상을 완전히 다른 프레젠테이션에 바꿔 넣어도 여전히 "어울린다"면, 충분히 구체적인 선택을 하지 않은 것입니다.
• 동등함보다 지배력: 하나의 색상이 지배적이어야 합니다 (시각적 비중 60-70%), 1-2개의 보조 톤과 하나의 강렬한 액센트. 모든 색상에 동일한 비중을 주지 마세요.
• 명암 대비: 타이틀 + 결론 슬라이드에는 어두운 배경, 콘텐츠에는 밝은 배경 ("샌드위치" 구조). 또는 프리미엄 느낌을 위해 전체적으로 어두운 배경을 사용하세요.
• 시각적 모티프에 전념하세요: 하나의 특징적인 요소를 선택하고 반복하세요 -- 둥근 이미지 프레임, 색상 원 안의 아이콘, 두꺼운 단측 테두리. 모든 슬라이드에 걸쳐 유지하세요.

색상 팔레트

주제에 맞는 색상을 선택하세요 -- 기본 파란색으로 설정하지 마세요. 이 팔레트를 영감으로 사용하세요:

테마	Primary	Secondary	Accent
Midnight Executive	1E2761 (navy)	CADCFC (ice blue)	FFFFFF (white)
Forest & Moss	2C5F2D (forest)	97BC62 (moss)	F5F5F5 (cream)
Coral Energy	F96167 (coral)	F9E795 (gold)	2F3C7E (navy)
Warm Terracotta	B85042 (terracotta)	E7E8D1 (sand)	A7BEAE (sage)
Ocean Gradient	065A82 (deep blue)	1C7293 (teal)	21295C (midnight)
Charcoal Minimal	36454F (charcoal)	F2F2F2 (off-white)	212121 (black)
Teal Trust	028090 (teal)	00A896 (seafoam)	02C39A (mint)
Berry & Cream	6D2E46 (berry)	A26769 (dusty rose)	ECE2D0 (cream)
Sage Calm	84B59F (sage)	69A297 (eucalyptus)	50808E (slate)
Cherry Bold	990011 (cherry)	FCF6F5 (off-white)	2F3C7E (navy)

각 슬라이드에 대해

모든 슬라이드에는 시각적 요소가 필요합니다 -- 이미지, 차트, 아이콘, 또는 도형. 텍스트만 있는 슬라이드는 잊혀집니다.

레이아웃 옵션:

• 2열 (왼쪽 텍스트, 오른쪽 일러스트레이션)
• 아이콘 + 텍스트 행 (색상 원 안의 아이콘, 굵은 헤더, 아래 설명)
• 2x2 또는 2x3 그리드 (한쪽 이미지, 다른 쪽 콘텐츠 블록 그리드)
• 반출혈 이미지 (좌측 또는 우측 전체) + 콘텐츠 오버레이

데이터 표시:

• 큰 통계 콜아웃 (60-72pt 큰 숫자에 아래에 작은 레이블)
• 비교 열 (전/후, 장단점, 나란히 옵션)
• 타임라인 또는 프로세스 흐름 (번호 매긴 단계, 화살표)

시각적 세련미:

• 섹션 헤더 옆에 작은 색상 원 안의 아이콘
• 핵심 통계나 태그라인에 기울임체 액센트 텍스트

타이포그래피

흥미로운 폰트 페어링을 선택하세요 -- Arial을 기본으로 사용하지 마세요. 개성 있는 헤더 폰트를 선택하고 깔끔한 본문 폰트와 짝지으세요.

헤더 폰트	본문 폰트
Georgia	Calibri
Arial Black	Arial
Calibri	Calibri Light
Cambria	Calibri
Trebuchet MS	Calibri
Impact	Arial
Palatino	Garamond
Consolas	Calibri

요소	크기
슬라이드 제목	36-44pt 굵게
섹션 헤더	20-24pt 굵게
본문 텍스트	14-16pt
캡션	10-12pt 연한 색상

간격

• 최소 0.5인치 여백
• 콘텐츠 블록 사이 0.3-0.5인치
• 여유 공간을 남기세요 -- 모든 공간을 채우지 마세요

피해야 할 것 (흔한 실수)

• 같은 레이아웃을 반복하지 마세요 -- 슬라이드마다 열, 카드, 콜아웃을 다양하게 사용하세요
• 본문 텍스트를 가운데 정렬하지 마세요 -- 단락과 목록은 왼쪽 정렬; 제목만 가운데 정렬
• 크기 대비를 아끼지 마세요 -- 제목은 14-16pt 본문과 구별되려면 36pt 이상이 필요합니다
• 기본 파란색으로 설정하지 마세요 -- 구체적인 주제를 반영하는 색상을 선택하세요
• 간격을 무작위로 섞지 마세요 -- 0.3인치 또는 0.5인치 간격을 선택하고 일관되게 사용하세요
• 하나의 슬라이드만 스타일링하고 나머지를 방치하지 마세요 -- 전체적으로 적용하거나 처음부터 심플하게 유지하세요
• 텍스트만 있는 슬라이드를 만들지 마세요 -- 이미지, 아이콘, 차트, 또는 시각적 요소를 추가하세요; 단순한 제목 + 글머리 기호를 피하세요
• 텍스트 상자 패딩을 잊지 마세요 -- 텍스트 가장자리에 선이나 도형을 정렬할 때 텍스트 상자에 margin: 0을 설정하거나 패딩을 고려하여 도형을 오프셋하세요
• 저대비 요소를 사용하지 마세요 -- 아이콘과 텍스트 모두 배경에 대해 강한 대비가 필요합니다; 밝은 배경에 밝은 텍스트나 어두운 배경에 어두운 텍스트를 피하세요
• 절대 제목 아래 액센트 라인을 사용하지 마세요 -- 이것은 AI 생성 슬라이드의 특징입니다; 대신 여백이나 배경 색상을 사용하세요

---

QA (필수)

문제가 있다고 가정하세요. 여러분의 임무는 그것을 찾는 것입니다.

첫 번째 렌더링은 거의 항상 정확하지 않습니다. QA를 확인 단계가 아닌 버그 사냥으로 접근하세요. 첫 번째 검사에서 문제를 하나도 찾지 못했다면, 충분히 꼼꼼하게 보지 않은 것입니다.

콘텐츠 QA

python -m markitdown output.pptx

누락된 콘텐츠, 오탈자, 잘못된 순서를 확인하세요.

템플릿을 사용할 때, 남아있는 플레이스홀더 텍스트를 확인하세요:

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

grep이 결과를 반환하면, 성공을 선언하기 전에 수정하세요.

시각적 QA

서브에이전트를 사용하세요 -- 2-3개 슬라이드일지라도. 코드를 계속 보고 있었으므로 실제 내용이 아닌 기대하는 내용이 보일 것입니다. 서브에이전트는 신선한 눈을 가지고 있습니다.

슬라이드를 이미지로 변환한 후 (아래 이미지로 변환 참조), 이 프롬프트를 사용하세요:

이 슬라이드를 시각적으로 검사하세요. 문제가 있다고 가정하세요 -- 찾아주세요.

다음을 확인하세요:
- 겹치는 요소 (도형을 통과하는 텍스트, 단어를 통과하는 선, 겹쳐진 요소)
- 가장자리/상자 경계에서 넘치거나 잘린 텍스트
- 한 줄 텍스트용으로 배치된 장식 선인데 제목이 두 줄로 줄바꿈된 경우
- 위 콘텐츠와 충돌하는 출처 인용이나 바닥글
- 너무 가까운 요소 (< 0.3인치 간격) 또는 거의 맞닿은 카드/섹션
- 불균등한 간격 (한 곳에 큰 빈 공간, 다른 곳은 빽빽함)
- 슬라이드 가장자리로부터 불충분한 여백 (< 0.5인치)
- 일관되지 않게 정렬된 열이나 유사 요소
- 저대비 텍스트 (예: 크림색 배경에 밝은 회색 텍스트)
- 저대비 아이콘 (예: 대비 원 없이 어두운 배경에 어두운 아이콘)
- 과도한 줄바꿈을 유발하는 너무 좁은 텍스트 상자
- 남아있는 플레이스홀더 콘텐츠

각 슬라이드에 대해 사소한 것이라도 문제나 우려 사항을 나열하세요.

이 이미지를 읽고 분석하세요:
1. /path/to/slide-01.jpg (예상: [간략한 설명])
2. /path/to/slide-02.jpg (예상: [간략한 설명])

사소한 것을 포함하여 발견된 모든 문제를 보고하세요.

검증 루프

1. 슬라이드 생성 → 이미지로 변환 → 검사
2. 발견된 문제 나열 (문제를 찾지 못했다면, 더 비판적으로 다시 보세요)
3. 문제 수정
4. 영향받은 슬라이드 재검증 -- 하나의 수정이 종종 다른 문제를 만듭니다
5. 전체 패스에서 새로운 문제가 발견되지 않을 때까지 반복

최소 한 번의 수정-검증 사이클을 완료하기 전까지 성공을 선언하지 마세요.

---

이미지로 변환

시각적 검사를 위해 프레젠테이션을 개별 슬라이드 이미지로 변환하세요:

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

이렇게 하면 slide-01.jpg, slide-02.jpg 등이 생성됩니다.

수정 후 특정 슬라이드를 다시 렌더링하려면:

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

---

의존성

• pip install "markitdown[pptx]" - 텍스트 추출
• pip install Pillow - 썸네일 그리드
• npm install -g pptxgenjs - 처음부터 생성
• LibreOffice (soffice) - PDF 변환 (샌드박스 환경에서 scripts/office/soffice.py를 통해 자동 설정)
• Poppler (pdftoppm) - PDF를 이미지로 변환