Guizang PPT Skill: Claude Code에서 바로 멋진 HTML 슬라이드 덱 만들기

긴 기사, 제품 분석 문서, 개인 에세이까지 PowerPoint를 켜고 텍스트 상자와 씨름하지 않고도 멋진 슬라이드 덱으로 바꾸고 싶었던 적이 있나요? 당신만 그런 것이 아닙니다. 그 문제를 정확히 해결하는 도구가 바로 Guizang PPT Skill입니다. AI 사상가 귀장(歸藏)이 만들고 실제 오프라인 강연을 통해 다듬어진 이 오픈소스 스킬은 Claude Code, Codex 등 유사한 에이전트 환경에서 실행되어 아름답고 단일 파일로 된 HTML 프레젠테이션을 생성합니다. 장난감 수준도 아닙니다. 이 스킬에는 두 가지의 뚜렷한 비주얼 시스템, 22개의 고정 레이아웃, 완전한 발표자 모드, 그리고 커버와 다이어그램을 위한 선택적 AI 이미지 생성 기능이 포함되어 있습니다.

왜 PPTX 대신 HTML인가?

이 프로젝트 전체는 하나의 단순한 신념에 기반합니다. HTML이 AI 에이전트가 슬라이드를 만들기에 이상적인 형식이라는 신념입니다. HTML과 CSS는 일반 텍스트이므로 에이전트가 파일을 직접 읽고, 수정하고, 검증할 수 있습니다. 마크다운 슬라이드 덱과 달리 HTML은 픽셀 단위 레이아웃 제어, 애니메이션, 반응형 디자인을 제공합니다. PPTX와 달리 최종 결과물은 브라우저에서 열거나, 발표하거나, 스크린샷을 찍거나, 동료에게 보낼 수 있는 단일 파일입니다. 빌드 단계도, 서버도, 의존성 지옥도 없습니다.

하지만 가장 큰 장점은 품질 관리입니다. 이 스킬에는 레이아웃 넘침, 정렬, 이미지가 지정된 슬롯 안에 들어가는지 등을 확인하는 검증 스크립트가 포함되어 있습니다. 다시 말해 AI는 그저 추측만 하는 것이 아니라, Playwright가 사용 가능할 때 실제 렌더링 결과를 측정합니다.

서로 다른 이야기를 위한 두 가지 비주얼 스타일

이 스킬에는 두 가지 스타일 시스템이 있습니다. 스타일 A는 “일렉트로닉 매거진 × 일렉트로닉 잉크(Electronic Magazine × Electronic Ink)”라고 불립니다. Monocle 매거진과 미니멀리스트 코드 미학이 만난 느낌입니다. 내러티브, 의견, 개인적인 공유, 그리고 개성이 중요한 모든 것에 완벽합니다. 챕터 오프너, 데이터 스테이트먼트 페이지, 이미지 그리드, 파이프라인, 비교 등을 위한 10가지 유연한 레이아웃이 있습니다. 잉크에서 영감을 받은 Classic Ink, Indigo Porcelain, Forest Ink, Kraft Paper, Dune의 5가지 테마 중에서 선택할 수 있습니다.

스타일 B는 반대 방향을 취합니다. 스위스 국제주의 스타일(Swiss International Style)입니다. 엄격한 그리드, 하나의 고채도 앵커 컬러, 직각, 극세선 규칙, 극적인 타입 스케일이 핵심입니다. 이 스타일은 사실, 제품, 분석, 방법론을 위해 설계되었습니다. Cover, Statement, KPI Tower, Loop Diagram, Duo Compare, Closing Manifesto 등 22개의 고정 레이아웃이 있습니다. 앵커 컬러 테마는 Klein Blue, Lemon Yellow, Lemon Green, Safety Orange의 4가지가 제공됩니다. 색상을 지정하지 않고 스위스 덱을 요청하면 에이전트는 기본적으로 Klein Blue를 추천합니다.

이 이중 시스템 덕분에 매번 디자인 바퀴를 다시 발명할 필요가 없습니다. 원하는 분위기를 말하기만 하면 스킬이 일관된 미적 시스템을 적용해 줍니다. 사용자 지정 hex 값 금지와 같은 엄격한 규칙도 포함됩니다. 디자인 감각을 보호하는 것이 누구나 색을 자유롭게 쓰도록 두는 것보다 더 중요하기 때문입니다.

30초 만에 시작하기

설치 방법은 놀라울 정도로 간단합니다. 권장하는 한 줄 명령은 다음과 같습니다.

AI가 모든 것을 처리하도록 하려면 이것을 Claude Code, Cursor 또는 셸 접근 권한이 있는 모든 에이전트에 붙여넣으세요:

guizang-ppt-skill을 설치해 줘. https://github.com/op7418/guizang-ppt-skill을 ~/.claude/skills/guizang-ppt-skill에 클론하고, 설치가 완료되면 SKILL.md, assets/, references/가 존재하는지 확인해 줘.

수동으로 진행하려면 다음을 실행하세요:

설치가 완료되면 다음과 같은 요청을 할 때 스킬이 자동으로 실행됩니다.

실제 워크플로우의 모습

진짜 마법은 이 스킬이 모호한 프롬프트가 아니라 구조화된 워크플로우라는 점입니다. 덱을 요청하면 에이전트는 다음과 같은 여러 단계를 거칩니다. 스타일 선택, 7가지 질문 목록으로 요구 사항 파악, assets/template.html 또는 assets/template-swiss.html에서 올바른 템플릿 복사, 리듬 테이블을 참고해 콘텐츠 채우기, 선택적으로 이미지 생성, 발표자 노트 작성, 검증 실행, 브라우저에서 덱 미리보기.

전형적인 요청은 이럴 수 있습니다. “이 제품 분석 문서를 일렉트로닉 매거진 스타일 PPT로 만들어 줘. 의견과 서사 리듬을 중점적으로 살려 줘.” 그러면 에이전트는 매거진 템플릿에 페이지 전환, 테마 색상, 발표자 노트, 발표자 런타임을 포함한 단일 파일 HTML 덱을 생성합니다.

실제로 유용한 발표자 모드

놀랄 만큼 깊이 있는 기능 중 하나는 내장 발표자 모드입니다. 오른쪽 하단 모서리에서 P를 클릭하면 덱이 전용 발표자 보기를 열고, 다른 탭에는 깔끔한 청중용 창이 열립니다. 현재 슬라이드와 다음 슬라이드의 실시간 16:9 미리보기, 목적과 말할 요점이 있는 구조화된 노트, 경과 시간과 전체 진행 속도 타이머, 페이지당 실제 시간을 로컬에 기록하는 리허설 모드를 제공합니다. 레이저 포인터, 드로잉 하이라이터, 원클릭 블랙 또는 화이트 화면 같은 실용적인 도구도 있습니다. 인터넷이 끊겨도 이 기능은 전혀 문제없이 작동합니다. 모두 로컬 HTML과 브라우저 API 기반이며 클라우드 서비스가 아니기 때문입니다.

AI 생성 이미지와 커버 아트

Codex 내에서 이 스킬은 GPT-Image 2.0 / GPT-M 2.0을 활용해 다큐멘터리 스타일 사진, 인포그래픽, 순서도, 시스템 다이어그램, UI 목업을 생성할 수 있습니다. 핵심 규칙은 이미지가 독립형 포스터가 아닌 임베디드 에셋이라는 것입니다. 따라서 이미지에는 자체 푸터, 제목 또는 장식적 테두리가 포함되어서는 안 됩니다. 이 스킬은 포함된 배경 라이브러리를 사용해 지저분한 스크린샷을 깔끔한 프레젠테이션 에셋으로 재설계하는 방법도 알고 있습니다. 모든 슬라이드를 수동으로 다시 만들지 않고 일관된 비주얼이 필요할 때 큰 도움이 됩니다.

슬라이드 외에도 동일한 비주얼 시스템은 소셜 커버로 확장됩니다. 21:9의 위챗 공식 계정 히어로 이미지, 1:1의 공유 카드, 3:4의 샤오홍슈 커버, 16:9의 가로형 비디오 커버를 생성할 수 있으며, 모두 덱의 테마 색상과 타이포그래피에 맞춰집니다.

언제 사용해야 하나(그리고 언제 사용하지 말아야 하나)

Guizang PPT Skill은 오프라인 강연, 내부 발표, AI 제품 출시, 데모데이, 그리고 개인의 목소리가 강한 모든 연설에 적합합니다. 빽빽한 스프레드시트 대시보드, 교육용 코스웨어, 또는 실시간 공동 작업이 많이 필요한 덱에는 적합하지 않습니다. 결과물이 설계상 정적 HTML 파일이기 때문입니다.

이 프로젝트의 디자인 철학은 신선합니다. 화려함보다 절제, 장식보다 구조, 안정적인 화면 비율을 가진 이미지를 핵심 요소로 취급합니다. 시스템 성능이 떨어진다면 B 키를 눌러 WebGL/캔버스 애니메이션을 비활성화하고 저사양 정적 모드로 전환할 수 있습니다.

다음 단계

Guizang PPT Skill은 더 많은 사례 연구, 더 많은 스위스 검증 규칙, 확장된 커버 사양 등을 포함한 활발한 로드맵이 있는 오픈소스 프로젝트입니다. AI 어시스턴트가 그냥 슬라이드를 만들어 주면 좋겠다고 생각한 적이 있다면, 지금 바로 시도해 볼 만한 훌륭한 도구입니다. 위의 npx 명령으로 설치하고 에이전트에게 기사를 건네면, 브라우저에서 바로 발표할 수 있는 세련된 HTML 덱이 생성되는 것을 볼 수 있습니다.