consulting-pptx-skill로 컨설팅 품질의 슬라이드를 AI로 만들기
機械翻訳 / Machine-translated
원문: consulting-pptx-skill로 컨설팅 품질의 슬라이드를 AI로 만들기（cccskills）
스킬 페이지: consulting-pptx-skill
이 글에서 알 수 있는 것
회의 자료 슬라이드를 AI에게 만들게 하면 페이지마다 외형이 들쭉날쭉해져서 그대로 사용하기 어려운 경우가 있습니다.
consulting-pptx-skill은 설계 규약 slide-rules.md와 62종의 HTML 파츠 모음을 바탕으로 덱을 구성하고, check_deck.py의 자동 검사로 마무리하는 스킬입니다.
이 글에서는 할 수 있는 것과 설치 방법을 소개합니다.
기존 PowerPoint에 동일한 서식으로 페이지를 추가하는 사용법도 다룹니다.
consulting-pptx-skill은 경영 회의에 제출할 수 있는 품질의 슬라이드를 만들기 위한 스킬입니다.
핵심은 설계 규약 references/slide-rules.md로, 에이전트는 작성 전에 이 규약을 전문 읽습니다.
그 위에서 HTML 파츠 모음을 사용해 초안을 구성하고, 규약 범위 내에서 조정하여 완성하는 흐름입니다.
결과물은 16:9 HTML과 Chrome으로 인쇄한 PDF입니다.
HTML에서는 하나의 section이 슬라이드 1장에 해당합니다.
PowerPoint 파일이 필요할 때는 명시적으로 요청하면 마지막에 변환해 줍니다.
규약에는 자료의 내용과 외형 양쪽의 규칙이 정리되어 있습니다.
SKILL.md에 기재된 요점 중 몇 가지를 소개합니다.
파츠 모음은 두 개의 HTML 파일로 나뉩니다.
기본으로 부족할 때 추가 파일을 사용하는 구성입니다.
| 파츠 모음 | 종류 수 | 주요 내용 |
|---|---|---|
| 기본 freeform_parts_16x9.html | 27 | 표지, 전체 맵, 화살표 깃발, 전제→귀결, 축이 있는 표, 평가표, 분포도 등 |
| 추가 freeform_parts_more_16x9.html | 35 | 이그제큐티브 서머리, 누적 막대, 브리지, 산점도, 매트릭스, 로드맵, 간트 등 |
초안은 scripts/new_deck.py에 파츠 번호를 나열하여 하나의 HTML로 생성합니다.
CSS 결합이나 페이지 번호 재부여는 스크립트가 담당합니다.
62종을 인쇄한 assets/SlideCatalog_16x9.pdf도 있으므로, 종류를 눈으로 보면서 찾을 수 있습니다.
이 스킬에서는 종류 카탈로그를 레이아웃 아이디어 노트로 위치짓고 있습니다.
슬라이드를 종류에 맞추는 것이 아니라, 스토리에 맞는 종류를 선택하고 맞지 않으면 버리고 자유롭게 구성한다는 사고방식입니다.
장마다 '이 종류 그대로 괜찮은가'를 의심하는 것도 절차에 포함되어 있습니다.
마무리 단계에서는 scripts/check_deck.py로 규약을 자동 검사하고, FAIL이 0이 될 때까지 수정합니다.
남아있는 플레이스홀더나 종류 이름 그대로인 제목도 FAIL 대상입니다.
이어지는 scripts/check_layout.mjs는 실제로 렌더링하여 겹침, 넘침, 판면의 40% 이상이 비어있는 페이지를 감지합니다.
자동 검사 후에는 '프레시 아이 리뷰'로 넘어갑니다.
작성 방법을 모르는 별도의 에이전트에게 덱을 읽히는 과정입니다.
마지막으로 PDF로 만들어 전 페이지를 육안으로 확인합니다.
막대가 찌그러지거나 아래 절반이 비어있는 등의 깨짐은 육안으로만 알 수 있다고 SKILL.md에 명시되어 있습니다.
사내 회의나 제안 슬라이드를 AI로 일정한 품질까지 초안 작성하고 싶은 분에게 적합합니다.
AI에게 맡기면 외형이 매번 들쭉날쭉해지는 고민에는, 규약과 검사로 기준을 고정하는 이 방식이 맞을 것으로 생각됩니다.
한편, 1장만 빠르게 만들고 싶은 상황에서는 무겁게 느껴질 수 있습니다.
규약 전문 읽기부터 전 페이지 육안 확인까지 공정이 많기 때문입니다.
둥근 모서리 금지 등 장식에 관한 규칙도 강하므로, 자유로운 디자인을 우선하는 자료에는 맞지 않을 수 있습니다.
터미널에서 설치하는 경우, 다음 명령을 실행하세요.
npx skills add https://github.com/carnot-tech/jinba-consulting-pptx-skill --skill consulting-pptx-skill
Claude Code에 요청하여 설치하는 경우, 다음 내용을 그대로 보내주세요.
次の Agent Skill をインストールしてください。
https://github.com/carnot-tech/jinba-consulting-pptx-skill
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、~/.claude/skills/consulting-pptx-skill/ に配置してください。
모든 프로젝트에서 사용하려면, 저장 위치는 ~/.claude/skills/입니다.
특정 프로젝트에서만 사용하려면, 해당 프로젝트의 .claude/skills/에 배치하세요.
배포처는 GitHub의 carnot-tech/jinba-consulting-pptx-skill입니다.
SKILL.md에는 "컨설팅 품질의 슬라이드를 만들어줘", "규약에 맞는 덱으로", "종류 카탈로그에서 골라서", "이 pptx에 추가할 페이지를 같은 서식으로"라는 트리거 예시가 나와 있습니다.
여기에 목적과 내용을 덧붙여 요청하면, 스킬의 절차대로 진행하기 쉬워집니다.
다음 분기 신규 사업 검토 현황을 경영 회의에서 보고합니다.
컨설팅 품질의 슬라이드를 10장 내외로 만들어 주세요.
이 요청이라면, 진행 순서는 SKILL.md의 절차대로 다음과 같습니다.
반환되는 것은 자동 검사를 통과한 HTML과 PDF입니다.
규약에 맞는 덱으로 외부향 제안서를 만들어 주세요.
고객명 목록은 ~/.config/deck-forbidden-terms.txt에 있습니다.
외부에 내보내는 덱에서는 --forbid 옵션으로 고객명이나 건명 코드의 혼입을 검사합니다.
HTML 코멘트나 속성에 남은 어구도 감지하지만, 어구 자체는 출력에 표시하지 않습니다.
이 pptx에 추가할 페이지를 같은 서식으로, 시장 규모 추이를 보여주는 1장을 만들어 주세요.
PPTX로 부탁드립니다.
이 경우에는 변환을 사용하지 않고, 전달받은 자료의 마스터 위에 직접 페이지를 구성합니다(slide-rules §8.7).
measure_deck.py로 서식을 측정하여 skin.json에 기록하고, deck_pptx.py로 구성한 뒤 check_deck.py --house로 검사하는 흐름입니다.
반환되는 것은 삽입할 페이지만 담긴 파일로, 자료에 넣는 작업은 사용자가 수행합니다.
출력 형식은 요청 방식에 따라 달라집니다.
기존 자료의 마스터 위에 직접 구성하는 것은, 기존 PowerPoint를 전달받아 PPTX로 요청받은 경우에만 해당합니다.
PPTX로의 변환도 "PPTX로", "파워포인트로"라고 명시한 경우에 한합니다.
| 요청 방식 | 출력 | 주로 사용하는 스크립트 |
|---|---|---|
| 형식 지정 없음 | HTML과 PDF | new_deck.py, check_deck.py, check_layout.mjs |
| "PPTX로" 명시 | 편집 가능한 PPTX | html_to_pptx.py |
| 기존 pptx를 전달하여 PPTX로 요청 | 삽입할 페이지만의 PPTX | measure_deck.py, deck_pptx.py |
실행에는 Python 3이 필요합니다.
check_layout.mjs는 playwright를 사용하므로, npm run setup으로 미리 설치해 두세요.
PDF화는 Chrome 헤드리스 인쇄로 수행하며, SKILL.md의 예시는 macOS 경로로 작성되어 있습니다.
PPTX 변환에는 Node 22 이상과 Chrome, python-pptx가 필요합니다.
SVG 차트나 그림은 이미지로 변환되어 내부 수치를 편집할 수 없습니다.
서체는 Yu Gothic과 Yu Mincho로 교체되며, 줄 끝이 한 글자 어긋나는 경우도 있습니다.
따라서 육안 확인은 생략할 수 없습니다.
기존 자료에 구성한 PPTX는 PowerPoint에서 열기 전에 반드시 check_deck.py를 통과시키세요.
올바르지 않은 파일을 열면 PowerPoint에 복구 다이얼로그가 남기 때문입니다.
보안 면에서는, 스킬이 업데이트 반영이나 PR 생성을 제안해 오는 점을 알아두면 좋습니다.
세션 시작 시 git fetch로 업데이트를 확인하고, 범용적인 지적은 본체에 대한 PR로 한 번만 제안하는 구조입니다.
gh pr create까지 진행하는 것은 승낙한 경우에 한합니다.
그래도 고객명 등이 섞이지 않도록, push 전에 차이를 직접 확인하세요.
라이선스는 MIT입니다.
완성된 PDF를 수정하고 싶을 때는 nano-pdf가 후보가 됩니다.
PDF의 지정 페이지에 대해 제목 변경이나 오탈자 수정을 자연어로 지시할 수 있는 스킬입니다.
슬라이드가 아닌 문서 형태로 설명을 정리하려면 technical-documentation이 있습니다.
기술 문서나 에이전트용 지시 파일의 작성과 리뷰를 지원하는 스킬입니다.
받을 수 있습니다.
"PPTX로", "파워포인트로"라고 명시하면, 완성한 HTML을 html_to_pptx.py로 변환합니다.
수정은 HTML 쪽에서 하고, 변환은 마지막에 한 번만 하는 방침입니다.
local/ 폴더에 slide-rules.local.md나 forbid.txt를 두면, 본체 규약 뒤에 읽힙니다.
본체 파일은 수정하지 않으므로, 스킬 업데이트를 반영해도 충돌하지 않습니다.
기본값은 미색 배경에 진한 갈색 텍스트를 배치한 따뜻한 계열입니다.
각 파츠 모음의 <style> 첫 부분에 있는 :root 토큰으로 변경할 수 있습니다.
네이비 계열 값도 코멘트 형태로 포함되어 있습니다.
완성이 아닙니다.
자동 검사가 보는 것은 겹침·넘침·규약 위반에 한합니다.
PDF로 만들어 전 페이지를 육안으로 확인하는 과정도 절차에 포함되어 있습니다.
consulting-pptx-skill은 규약과 자동 검사로 슬라이드 품질을 균일하게 맞추는 스킬입니다.
62종의 파츠 모음은 아이디어 노트로 활용하며, 스토리에 맞게 조합합니다.
새로운 덱 초안 작성에도, 기존 PowerPoint에 페이지 추가에도 사용할 수 있습니다.
공정이 많은 편이므로, 회의나 제안 자료를 안정적인 품질로 만들고 싶은 상황에 어울리는 스킬입니다.
자세한 내용은 cccskills 페이지를 참고하세요.
이 글은 cccskills의 읽을거리 「consulting-pptx-skill로 컨설팅 품질의 슬라이드를 AI로 만들기」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 consulting-pptx-skill 페이지에 있습니다.