Communitygithub.com

lainshao/modern-ppt

한 줄로 현대적인 발표 웹 PPT를 생성하는 Agent Skill: 전문적 미니멀리즘 · 12가지 레이아웃 · 3가지 색상 세트 · 인터랙티브 효과 · 단일 파일 HTML

modern-ppt란 무엇인가요?

이 스킬은 AI 에이전트가 단일 HTML 파일로 구성된 전문적이고 미니멀리즘한 가로 방향 넘김 발표 덱(deck)을 생성할 수 있도록 설계되었습니다. 내장된 12가지 레이아웃, 3가지 색상 테마(기본 검정+주황, 파랑, 연어 분홍), 그리고 키보드, 마우스 휠, 터치 제스처를 지원하는 전체 화면 프레젠테이션 기능을 제공합니다. 사용자는 단순히 주제나 아이디어를 제공하기만 하면 되며, AI는 명확한 내러티브 아크를 구성하고, 적절한 레이아웃을 선택하며, 데이터 시각화(Chart.js), 카운트업 애니메이션, 썸네일 벽과 같은 상호작용 요소를 통합합니다. 이 스킬은 guizang-ppt-skill을 기반으로 하며 AGPL-3.0 라이선스를 따르므로, 재배포 시 라이선스와 원저작자 표시를 유지해야 합니다. 생성된 최종 덱에는 별도의 저작권 표기가 필요 없습니다. 주요 워크플로는 먼저 사용자 요구 사항을 명확히 하고, 대략적인 개요를 확정한 후, 템플릿을 복사하고, 몇 가지 샘플 페이지를 제시한 다음, 나머지 페이지를 일괄 생성한 후, 엄격한 레이아웃 규칙(예: 통일된 본문 글꼴 크기 토큰, 내용을 카드 하단에 고정하지 않음 등)을 자체 점검하는 순서로 진행됩니다. 스킬은 '먼저 자르고 쓰라'는 원칙을 강조하여, 페이지 수를 줄이고 내용을 재구성하는 것이 단순히 자료를 쌓는 것보다 더 효과적이라고 제안합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add lainshao/modern-ppt

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Modern PPT · 현대식 발표 웹 덱

단일 파일 HTML로 된 가로 방향 넘김 덱(deck)을 생성합니다: 전문적 미니멀리즘, 깔끔하고 절제된 레이아웃, 내장 12가지 레이아웃 + 인터랙티브 + 3가지 색상 세트(기본 안전 주황, 발표 시 1/2/3 누르면 밝은 파랑/부드러운 분홍으로 전환). 키보드 ← →, 마우스 휠, 터치로 페이지 넘김, ESC로 인덱스, B로 정적 모드 전환. 기본적으로 '바로 발표/전송 가능하고 다른 사람이 포크해서 수정 가능한' 완성품입니다.

출처 및 라이선스(필독): 이 스킬은 guizang-ppt-skill(© op7418, AGPL-3.0)에서 파생되었습니다. Swiss 템플릿 베이스, WebGL/ASCII 배경, 페이지 넘김/인덱스/모션 엔진을 재사용했습니다. 그 위에 안전 주황 테마(현재 3가지 전환 가능한 색상 세트로 확장), 전체 발표 레이아웃 규범(아래), 12가지 레이아웃 + 인터랙티브 모션, 검증된 레이아웃 정리, 템플릿 버그 수정을 추가했습니다. 따라서 이 스킬 전체는 여전히 AGPL-3.0입니다: 재배포 시 LICENSE + 이 단락의 저작자 표시 + 변경 사항 명시를 유지해야 합니다. 회사 내부 저장소에 넣기 전에 오픈소스 규정을 먼저 확인하세요(AGPL은 종종 금지됨). 생성된 최종 덱에는 저작자 표시가 필요 없습니다. 템플릿 예제 페이지는 일반/공개 내용만 사용하고 프로젝트의 비공개 내용을 포함하지 마세요(그렇지 않으면 재공유 전에 현장에서 정리해야 함—이 스킬이 이미 겪은 일입니다).

워크플로(실행 전에 먼저 확인)

  1. 명확화(사용자가 주제/모호한 아이디어만 제공한 경우): 대상 및 장면? 시간(15분≈10페이지 / 30분≈18-22페이지)? 기본 색상(❶ 검정+주황 / ❷ 밝은 파랑 / ❸ 부드러운 연어 분홍—3가지 세트 모두 내장, 발표 시 1/2/3으로 언제든지 전환 가능, 여기서는 기본값만 설정, 확실하지 않으면 기본 검정-주황 사용)? 자료/데이터 있음? 하드 제약 사항 있음(X 반드시 포함 / Y 금지)? 숫자는 반드시 사용자 자료에서 가져오고, 없으면 '보충 예정'으로 표시, 절대 지어내지 않음.
  2. 개요 먼저 확정 후 실행:소스 문서 / URL에서 덱을 만들 때, 먼저 핵심 문장(thesis)을 찾아 앵커로 삼음(예: '맥락이 채워지면 멍청해진다'). 전체 내용은 결론을 먼저 제시하고 이를 중심으로 전개. 각 페이지는 하나의 주장(제목=주장). '내러티브 아크'(훅→분위기 설정→본론→전환→수렴) 사용; 긴 덱은 4-5페이지마다 divider(진한 먹지 배경 + 유령 번호, 레이아웃 규범 §9 참조)를 하나씩 삽입. 개요를 사용자와 맞춘 후 작성. 먼저 자르고 쓰기: 첫 번째 버전은 항상 과부하됨. 페이지 삭제 / 재구성이 자료 쌓기보다 더 효과적임(comprehensive ≠ persuasive).
  3. 템플릿 복사:cp assets/template.html 프로젝트/index.html. 완성된 제품입니다—18페이지로 12가지 레이아웃 전부 + 3가지 색상 세트 + 인터랙티브(count-up / Chart.js / 썸네일 벽 / 챕터 divider)를 보여주며, 모든 CSS/JS 포함. <title> 수정하고, 사용할 레이아웃 페이지는 남기고, 사용하지 않는 것은 삭제한 후, 내용을 사용자의 것으로 교체.
  4. 샘플 페이지 먼저, 대량 생산은 나중에:표지 + 2-3장 대표 페이지 먼저 제작 → 스크린샷 리뷰(아래 '검증' 참조) → 사용자 승인 → 나머지 페이지 일괄 생산. 매 라운드마다 스크린샷 촬영.
  5. 자체 점검:아래 하드 규칙 + references/레이아웃-규범.md를 하나씩 확인; font-size(본문 크기는 0에 가까워야 함)가 있는지 grep.

레이아웃 하드 규칙(결과물 일관성의 핵심 · references/레이아웃-규범.md 참조)

  1. 본문은 단일 --fs-body 토큰 사용(발표 ≈21px; 비디오 편집 32px). 모든 설명/문단/카드 설명/표 셀에 var(--fs-body) 사용, 각각 따로 font-size를 쓰는 것 금지.
  2. 각 페이지의 글자 크기 ≤ 몇 단계: 페이지 제목 / 카드 제목 / 본문 / 모노 각주 + 큰 숫자 특례. 글자 크기 계층화 코딩.
  3. 열 제목은 '구분선 + 여백 + 역할 대비'로 정의하고, 글자 크기를 키우지 않음. .col-head 사용(조용한 회색 글자 + border-bottom:2px solid ink). 크게/굵게 하면 오히려 본문과 충돌하여 가독성이 떨어짐.
  4. 본문에 색상을 사용하지 않음:accent / 브랜드 색상은 제목 키워드, 차트 데이터, 1px 구분선에만 사용; 본문 강조 = 검정 굵게, 이탤릭체 사용 금지.
  5. 내용은 제목 바로 아래 연속 배치, 하단 고정 금지:margin-top:auto를 사용하여 내용을 카드 하단으로 밀어 '제목은 위, 내용은 아래' 상황 금지.
  6. 하단 안전 영역 ≥6vh(.canvas-card 하단 패딩):높이가 꽉 찬 내용 블록이 오른쪽 아래 탐색 프롬프트/페이지 표시와 겹치지 않도록 함.
  7. 번호 목록(01/02/03)은 단일 grid 공유 열 트랙 + font-feature-settings:'tnum' 사용, 그렇지 않으면 비례 글꼴에서 숫자 폭이 달라 각 행 제목의 왼쪽 가장자리가 들쭉날쭉해짐.
  8. 강도는 5칸 사각형 눈금(선두=5칸 꽉 참) 사용, 가로로 훑어보기 가능; 텍스트만 쓰지 않음.
  9. 카드 '작은 레이블은 위쪽'에, 오른쪽 위 각주 금지(긴 제목과 겹칠 수 있음); 카드 그룹에 함부로 개별 강조(hightlight)를 넣지 않음(강조는 데이터/초점 의미가 있을 때만 추가, 그렇지 않으면 넣지 않음).
  10. accent를 화면 전체에 채우지 않음(안전 주황이 화면 전체면 눈부심):표지/장표지는 진한 먹지 배경 + 키워드 색상 사용; split 마무리 페이지의 반 화면 주황은 허용 가능.

12가지 레이아웃(템플릿에 이미 예제 페이지 내장, cp 후 문구만 수정)

세 가지 수준으로 분류, 각 수준에 divider로 장 구분(레이아웃 규범 §9 참조):

  • ① 기본 뼈대:Cover 표지 · Agenda 목차 · Page divider 챕터 페이지 · Closing 마무리
  • ② 데이터·비교·차트:Stat grid(큰 숫자 count-up 0부터 롤링)· Chart(Chart.js 막대+꺾은선, 막대 하나씩 상승/자동 선 그리기 + hover tooltip + 꺾은선에 QoQ% 표시)· Comparison 비교 행렬(표준×옵션 + 5칸 눈금, 주요 열 강조)
  • ③ 내러티브·프로세스·내용:Two-column 그림-텍스트 분할(오른쪽 열은 그림/mock/차트/코드 터미널로 교체 가능)· Three-column 삼열 카드(3-grid)· Strategy house 전략 하우스 다이어그램(SVG OGSM: 주황 지붕 미션 + 주제 열×번호 목표 카드 + 가치관 기초)· Process/Timeline 프로세스 타임라인 · Quote 명언
  • 추가 썸네일 벽:실시간으로 모든 레이아웃 복제, 한 화면 미리보기, 색상 세트 자동 추적.

검증된 레이아웃 컴포넌트(이것들만 사용, 새로 만들지 않음)

  • 카드:.sub-card(.accent/.ink)、.sub-grid-3-2(6칸)、.triad(3-grid 삼열 카드)
  • 데이터:.cnt(count-up 숫자)、.stat-card、canvas[data-chart="bar|line"](Chart.js)、5칸 사각형 눈금、.cmp(비교 행렬)
  • 구조:.stack-row/.stack-block、.duo-compare(이중 트랙 대조 + .vrule)、.timeline-v/.timeline-h、.house-svg(전략 하우스 다이어그램)
  • 텍스트:.h-xl-zh(페이지 제목)、.lead/.body(본문)、.t-cat/.t-meta(모노 각주)、.mk(accent 키워드)
  • 레이아웃:.split-half(마무리)、slide.dark + 유령 큰 번호(챕터 divider)、.code-card(터미널)、.chart-card、.dot-mat(점 행렬)
  • 18페이지 예제가 이들 컴포넌트의 실제 예시이므로,직접 copy해서 문구만 수정하는 것이 가장 빠름.

인터랙션 / 모션(템플릿에 이미 연결됨, </body> 앞의 IIFE가 자동 실행)

  • 숫자 count-up:<span class="cnt" data-to="85" data-dec="0">85</span> → 해당 페이지로 넘기면 0부터 85까지 롤링(tnum으로 떨림 방지).
  • 차트:<canvas data-chart="bar"> / data-chart="line", 페이지 진입 시 자동 초기화, 막대 하나씩 상승 / 자동 선 그리기 + hover tooltip; 꺾은선 각 점에 QoQ% 표시. 데이터 수정은 IIFE의 chartConfig에서.
  • Agenda 항목별 점등:.agenda-list[data-agenda-steps] → ←→로 한 번에 한 항목만 점등, 마지막 항목에서 다음 페이지로 넘김.
  • 썸네일 벽:.thumb-wall[data-thumb-wall] → 페이지 진입 시 모든 레이아웃 복제하여 썸네일 생성, 색상 세트 자동 추적.

색상(3가지 세트 · 발표 시 1/2/3 또는 URL ?scheme= 로 전환)

  • 1 = 검정+주황(기본, 어두운 페이지 유지)· 2 = 밝은 파랑(순백색 배경)· 3 = 부드러운 연어 분홍(따뜻한 흰색 배경).
  • 파랑/분홍 세트는 자동으로 <body>에 .lite 추가 → 어두운 페이지(표지/데이터/챕터/명언)가 밝은 배경으로 전환됨. 색상 추가/변경: IIFE의 SCHEMES 객체 수정(--paper/--ink/--accent 등 CSS 변수 재정의). 단일 색상 세트는 하나의 accent만 사용.
  • 기본 색상 설정(사용자가 파랑/분홍을 선택한 경우): IIFE 끝에 applyScheme('blue')(또는 'salmon') 한 줄 추가, 이 덱을 열면 해당 색상 세트가 표시됨. 1/2/3으로 실시간 전환 가능.

알려진 함정(다시 밟지 말 것)

  • 스크린샷 검증 함정: Chrome 백그라운드 탭은 애니메이션 클록을 고정시킴, 스크린샷에 '애니메이션 첫 프레임=빈 화면'이 찍힘—버그 아님, 포그라운드 발표는 정상. 모션 검증 시 먼저 B를 눌러 정적 모드 전환(window.__setLowPowerMode(true,{persist:false})) 후 페이지별 스크린샷 촬영.
  • 위에 나열된 컴포넌트만 사용:템플릿에 CSS가 없는 화려한 레이아웃(matrix/four-cards/loop 등)을 직접 사용하면 깨짐.
  • 단일 파일을 스크립트/정규식으로 수정 시:고유 문자열을 앵커로 사용하고, 수정 후 section 개수를 세어 자체 점검(앵커 문자열이 충돌하면 페이지를 잘못 삭제할 수 있음).
  • 색상 전환 시 밝은 배경(.lite)이 인라인 흰색 글자를 덮어씀:motion 모션은 인라인 color:#fff를 color: rgb(255, 255, 255)로 정규화함. body.lite .slide.dark 선택자는 #fff와 rgb(255, 255, 255) 두 가지 표기법을 모두 일치시켜야 함, 그렇지 않으면 흰색 글자가 밝은 배경에서 보이지 않게 됨.

미리보기

open 프로젝트/index.html   # macOS, 서버 불필요; 오프라인 시 motion 자동으로 애니메이션 없는 읽기 가능 모드로 다운그레이드

관련 스킬