guizang-ppt-skill
무엇인가
guizang-ppt-skill은 AI 코딩 에이전트가 단일 파일 HTML 가로 넘김 슬라이드 덱과 슬라이드용 삽화, 다중 플랫폼 커버 이미지를 만들 때 따르는 판형·시각·검증 규칙 묶음이다. 규율 대상은 페이지 레이아웃 선택, 테마 색 적용, 이미지 슬롯 배치, 발표자 모드 동작, 생성 후 자체 검증 절차다.
어떻게 동작하나
동작은 SKILL.md를 중심으로 한 파일 구조로 이뤄진다. assets/template.html(전자잡지풍)과 assets/template-swiss.html(스위스풍)이 기본 골격이고, references/checklist.md가 P0 자체 점검 항목을, references/presenter-mode.md가 발표자 모드 계약을 담는다. scripts/validate-swiss-deck.mjs와 scripts/validate-presenter-mode.mjs가 렌더링 결과를 검사한다. Claude Code는 대화에서 스킬을 자동 발견하며 '잡지풍 PPT', '스위스풍 PPT', 'horizontal swipe deck', '公众号 21:9 封面' 같은 발화가 트리거가 된다. 절차는 스타일 선택 → 7문항 요구 명확화 → 템플릿 복사 → 레이아웃 골격 선택과 문안 채우기 → 선택적 이미지 생성 → 발표 노트 작성 → 체크리스트 자체 점검 → 브라우저 미리보기 → 리허설 순으로 진행된다.
무엇과 다른가
프롬프트를 매번 직접 쓰는 방식과 달리, 스위스풍은 본문 페이지를 S01~S22의 명명된 22개 판형으로 고정하고 16열 그리드, 1px 헤어라인, 무그림자·무그라디언트·무라운드를 강제한다. 이미지는 템플릿이 미리 비워 둔 data-image-slot에만 들어가야 한다. Markdown 기반 슬라이드 도구와 달리 산출물이 HTML/CSS 텍스트라 에이전트가 직접 읽고 수정하고 검증할 수 있고, 검증 스크립트가 중앙 정렬 제목, 실험적 판형, SVG 내 텍스트, 슬롯 이탈 이미지를 차단한다. Playwright가 있으면 overflow, 하단 여백, 제목 간격을 실제 렌더링 기준으로 측정한다.
어떻게 쓰나
설치는 npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill 한 줄로 끝나며, git clone으로 ~/.claude/skills/guizang-ppt-skill에 직접 넣어도 된다. 설치 후 SKILL.md, assets/, references/ 세 항목이 있는지 확인한다. 첫 사용은 '이 글을 바탕으로 스위스풍 PPT를 7페이지 정도로 만들어줘, 삽화 2~3장 포함'처럼 요청하면 된다. 업데이트는 해당 디렉터리에서 git pull로 한다.
전제와 한계
Claude Code와 Codex 등 스킬 디렉터리를 읽는 에이전트에서 동작하며, 설치와 검증에 shell 권한과 Node.js가 필요하다. 산출물은 빌드·서버 없이 브라우저로 여는 단일 HTML이고, 발표자 모드는 로컬 브라우저 두 창만 사용한다. 큰 표 데이터, 정보 밀도가 높은 교육용 교재, 여러 사람이 동시에 편집하는 용도에는 맞지 않는다. 이미지 생성은 Codex 환경에서 GPT-Image 2.0 / GPT-M 2.0을 쓸 때만 선택적으로 붙는다.