apple-style-ppt

jeonguk-marketplace

jeonguk(GitHub: jeonguk29)의 Claude Code 플러그인 마켓플레이스입니다.

이 저장소 하나만 등록하면, 여기 담긴 플러그인들을 Claude Code 안에서 바로 설치해 쓸 수 있습니다. 지금은 Apple Keynote 스타일 발표자료 생성기(apple-style-ppt) 하나가 들어 있습니다.

---

🧩 이게 뭔가요? (개념부터)

Claude Code에는 세 가지 개념이 겹쳐 있습니다. 헷갈리기 쉬우니 먼저 정리합니다.

용어	한 줄 설명
스킬(Skill)	Claude가 특정 작업을 할 때 따라 읽는 "설명서 + 자료 묶음". 여기서는 발표자료를 만드는 방법(web-presentation)이 스킬입니다.
플러그인(Plugin)	스킬·명령어·에이전트 등을 하나로 포장한 배포 단위. 여기서는 apple-style-ppt가 플러그인이고, 그 안에 위 스킬이 들어 있습니다.
마켓플레이스(Marketplace)	여러 플러그인을 모아둔 "앱스토어". 바로 이 저장소(jeonguk-marketplace)입니다.

즉 흐름은 이렇습니다:

마켓플레이스 등록  →  플러그인 설치  →  플러그인 안의 스킬이 자동으로 활성화  →  사용
 (저장소 1번 추가)     (apple-style-ppt)    (web-presentation 스킬)         ("발표자료 만들어줘")

마켓플레이스를 등록하고 플러그인을 설치하면, 플러그인 안에 들어 있는 스킬이 자동으로 함께 설치됩니다. 스킬을 따로 복사하거나 경로를 잡아줄 필요가 없습니다.

---

🚀 설치 방법

Claude Code 프롬프트 창에 아래 슬래시 명령을 그대로 입력하면 됩니다.

1단계 — 마켓플레이스 등록

이 저장소를 Claude Code에 "앱스토어"로 추가합니다. (한 번만 하면 됩니다.)

/plugin marketplace add jeonguk29/my-marketplace

위는 GitHub 공개 저장소에서 받아오는 방식입니다. 로컬에 클론해 둔 폴더로 등록하고 싶다면 경로를 그대로 넣어도 됩니다: /plugin marketplace add /Users/quantarium/Documents/my-marketplace

2단계 — 플러그인 설치

마켓플레이스에 담긴 apple-style-ppt 플러그인을 설치합니다.

/plugin install apple-style-ppt@jeonguk-marketplace

형식은 플러그인이름@마켓플레이스이름 입니다.

메뉴로 둘러보며 설치하고 싶다면 그냥 /plugin 만 입력해도 됩니다. (Browse → 마켓플레이스 선택 → Install)

3단계 — 설치 확인

/plugin

목록에서 apple-style-ppt가 Enabled(활성) 상태이면 끝입니다. 이때 플러그인 안의 web-presentation 스킬도 함께 로드되어, 발표자료 관련 요청이 들어오면 Claude가 알아서 이 스킬을 사용합니다.

---

✨ 사용 방법

설치 후에는 별도 명령 없이, 자연어로 발표자료를 요청하기만 하면 됩니다. Claude가 web-presentation 스킬을 자동으로 골라 씁니다.

예시 프롬프트:

이 PDF를 애플 느낌 슬라이드 10장으로 만들어줘
발표자료 만들어줘 — 주제는 우리 회사 소개
키노트 스타일 슬라이드로 이 노트를 정리해줘

생성 결과는 의존성 0개의 단일 index.html 파일입니다. 브라우저로 바로 열 수 있고, 발표자 노트가 필요하면 speaker.html도 함께 생성됩니다.

만들어진 슬라이드 열기

발표자 노트 창 동기화 때문에 file://이 아니라 로컬 서버로 여는 것을 권장합니다.

cd <슬라이드가-생성된-폴더>
python3 -m http.server 8000
# 브라우저에서 http://localhost:8000/index.html 열기

조작 키

키	동작
→ / Space / PageDown	다음 슬라이드
← / PageUp	이전 슬라이드
S	발표자 노트 창 열기
F	전체화면
하단 점 클릭	해당 슬라이드로 점프
#slide-N (URL)	N번 슬라이드로 딥링크

모바일에서는 좌우 스와이프로 넘깁니다.

---

🔄 업데이트 / 제거

/plugin marketplace update jeonguk-marketplace   # 마켓플레이스 최신화
/plugin uninstall apple-style-ppt                # 플러그인 제거

---

📂 저장소 구조

my-marketplace/
├── .claude-plugin/
│   └── marketplace.json              # 마켓플레이스 매니페스트 (어떤 플러그인이 있는지 목록)
└── plugins/
    └── apple-style-ppt/              # 플러그인 1개
        ├── .claude-plugin/
        │   └── plugin.json           # 플러그인 메타데이터 (이름·버전·작성자)
        └── skills/
            └── web-presentation/     # 플러그인이 품고 있는 스킬
                ├── SKILL.md          # 스킬 설명서 (Claude가 읽는 핵심 문서)
                ├── assets/           # 슬라이드 엔진 템플릿 (template.html, speaker.html)
                └── references/       # 컴포넌트 카탈로그 (레이아웃 패턴 모음)

• marketplace.json 의 plugins[].source 가 ./plugins/apple-style-ppt 를 가리키며, 이 경로가 실제 플러그인 폴더입니다.
• 플러그인을 설치하면 그 안의 skills/ 가 통째로 함께 설치되어, 스킬을 따로 다룰 필요가 없습니다.

플러그인을 더 추가하려면

1. plugins/ 아래에 새 플러그인 폴더를 만들고 .claude-plugin/plugin.json 을 둡니다.
2. .claude-plugin/marketplace.json 의 plugins 배열에 항목 한 개를 추가합니다.
3. 커밋 후 push 하면, 사용자는 /plugin marketplace update 한 번으로 새 플러그인을 볼 수 있습니다.

---

만든 사람: jeonguk · 라이선스: 자유 사용