Guizang PPT Skill

왜 쓰나요

핵심 기능

단일 파일 HTML 출력 — 브라우저에서 열고, 발표하고, 완료
10개 레이아웃 변형 (표지, 큰 숫자, 비교, 인용, 이미지 그리드...)
5개 큐레이션 테마 (light/dark/serif/mono/playful)
키보드 단축키가 있는 수평 스와이프 내비게이션
타이틀 슬라이드를 위한 선택적 WebGL 히어로 배경
인플레이스 편집 가능 — 산문은 HTML에 있어 조정하기 쉬움

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "guizang-ppt-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "guizang-ppt-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/op7418/guizang-ppt-skill",
        "~/.claude/skills/guizang-ppt"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "guizang-ppt-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/op7418/guizang-ppt-skill",
          "~/.claude/skills/guizang-ppt"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add guizang-ppt-skill -- git clone https://github.com/op7418/guizang-ppt-skill ~/.claude/skills/guizang-ppt

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Guizang PPT Skill

10분 만에 Markdown 개요를 발표 가능한 덱으로 변환

👤 PowerPoint를 건너뛰고 싶은 누구나 ⏱ ~30 min beginner

언제 쓸까: 개요가 있고 내일 덱이 필요할 때.

사전 조건

스킬 설치됨 — git clone https://github.com/op7418/guizang-ppt-skill ~/.claude/skills/guizang-ppt
Markdown 개요 — 섹션 헤더가 있는 글머리 기호 목록

흐름

테마 선택

guizang-ppt: /talks/ai-strategy.md를 읽으세요. 25슬라이드 덱에 'serif-light' 테마를 사용하세요. 슬라이드 제목은 간결하게.✓ 복사됨

→ 단일 deck.html 생성됨; 브라우저에서 열림
슬라이드별 다듬기

슬라이드 7이 너무 텍스트가 많습니다. 비교 레이아웃(좌측 vs 우측)으로 변환하세요.✓ 복사됨

→ 슬라이드 7이 인플레이스 변경됨; 나머지는 그대로
히어로 추가

타이틀 슬라이드에 미묘한 WebGL 배경을 추가하세요. 테마와 어울리는 색상만.✓ 복사됨

→ 타이틀 슬라이드에 텍스트 뒤에 절제된 WebGL

결과: 단일 HTML 파일에 폴리시된 덱, 발표 준비 완료

함정

슬라이드당 단어가 너무 많음 — 슬라이드당 25단어 목표; Claude에게 예산을 적용하도록 요청

함께 쓰기: filesystem

논문을 15분 발표로 변환

👤 연구자 / 학자 ⏱ ~60 min intermediate

언제 쓸까: 논문 PDF가 있고 2일 후 컨퍼런스 슬롯이 있을 때.

사전 조건

Markdown으로 된 논문 — PDF를 MD로 변환 (Pandoc 등)

흐름

압축

paper.md를 읽으세요. 12슬라이드로 압축: 동기, 방법, 핵심 결과, 그림 2개, 향후 연구, 참고문헌. 'mono-dark' 테마 사용.✓ 복사됨

→ 12슬라이드 덱; 그림은 이미지 경로로 참조됨
반복

슬라이드 5 '방법'은 아키텍처 다이어그램을 보여야지 텍스트가 아니어야 합니다. /paper/figs/arch.png 이미지로 교체하세요.✓ 복사됨

→ 슬라이드 5가 이미지 중심으로 재작업됨

결과: 컨퍼런스 준비 완료 덱

함정

PDF 그림이 추출되지 않음 — 먼저 pdfimages 실행; 프롬프트에서 경로 참조

함께 쓰기: dailypaper-skills

PPT에서 30분 허비하지 않고 주간 팀 업데이트

👤 테크 리드 / EM ⏱ ~10 min beginner

언제 쓸까: 금요일 오후: 월요일 전체 회의를 위한 덱이 필요할 때.

흐름

구성

8슬라이드 팀 업데이트: 출시됨 / 진행 중 / 차단됨 / Q3 계획. 'playful' 테마. 숫자를 눈에 띄게.✓ 복사됨

→ 통계를 위한 big-number 레이아웃으로 덱 생성됨

결과: 5분 만에 업데이트 덱 완성

함정

기업 청중에게 너무 장난스러움 — 'serif-light' 또는 'mono-dark'로 전환

조합

다른 MCP와 조합해 10배 효율

guizang-ppt-skill + filesystem

로컬 노트에서 콘텐츠 소스 가져오기

/notes/q2.md를 읽고 'mono-dark' 덱을 생성하세요. /decks/q2.html로 저장.✓ 복사됨

guizang-ppt-skill + dailypaper-skills

논문-발표 파이프라인

Daily paper: paper.md 추출. guizang-ppt: 12슬라이드 덱으로 변환.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
generate_deck	outline, theme, slide_count	첫 번째 패스
edit_slide	deck.html, slide_num, change	단일 슬라이드 반복
add_webgl_hero	deck.html, palette?	타이틀 슬라이드를 눈에 띄게
switch_theme	deck.html, theme	톤이 맞지 않을 때 — 테마 교체

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 1000–6000 (HTML 출력이 큰 부분)
금액: 무료
팁: 먼저 구조를 생성한 후 전체 덱을 재생성하지 말고 슬라이드별로 반복

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-write

자격 증명 저장: 없음

데이터 외부 송신: 없음 (모든 것이 로컬; 출력은 HTML)

출력 HTML은 기본적으로 원격 스크립트를 로드하지 않음 — 민감한 발표를 위해 그대로 유지하세요

문제 해결

자주 발생하는 오류와 해결

슬라이드 오버플로

슬라이드당 단어 예산 줄이기; 레이아웃에는 고정된 높이가 있음

WebGL 히어로가 Safari에서 충돌

WebGL을 비활성화하거나 정적 대체 변형 사용

테마가 프로젝터에서 이상하게 보임

고대비 장소에는 'mono-dark'로 전환

대안