사용 가이드로 건너뛰기
pptx-reference-deck-analysis작성자 Seth Hobson

PPTX Reference Deck Analysis 스킬.

PPT 및 슬라이드 덱을 위한 Claude Code 및 Codex 스킬입니다. 참조 PPTX의 테마, 타이포그래피, 레이아웃 리듬 및 진단을 분석합니다.

  • Presentations
  • 리뷰 리포트
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.mdSKILL.md
--- name: pptx-reference-deck-analysis description: Use when analyzing a reference PPTX for read-only structure, theme, typography, layout rhythm, diagnostics, derived template catalogs, or safe OOXML package inspection. --- ## Contract ## Rules ## OOXML package inspection
2026-09-14에 업스트림 파일에서 읽은 앞부분 및 섹션 제목 · 전체 2,755자

01 기능

Claude Code와 Codex에서 pptx-reference-deck-analysis 스킬이 수행하는 작업

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

참조 PPTX를 디자인 증거로 검사하며, 이를 복사, 복제 또는 변형하지 않도록 의도적으로 설계되었습니다. 작업별 소규모 python-pptx 스크립트가 필요에 따라 추출을 수행하며, 간결한 프롬프트 컨텍스트(슬라이드 수와 크기, 도형 수, 브랜드 신호, 레이아웃 리듬), 읽기 전용 layout_tree 증거를 포함한 전체 추출, 폴더 진단, 스타일 마스터 분석, 0부터 시작하는 소스 인덱스를 가진 파생 템플릿 카탈로그를 다룹니다.

내장된 OOXML 유틸리티는 원시 테마, 관계, 노트, 주석, 애니메이션, 미디어, 마스터, 레이아웃을 처리하며, inspect.py, validate_package.py, unpack.py 스크립트는 JSON 리포트, 패키지 검증, 선택적 원시 패키지 추출을 제공합니다. 검사된 모든 부분과 파싱 예외는 분석 매니페스트에 기록되며, 라이선스 증거가 없는 추출된 자산은 새 덱에 포함되지 않습니다.

산출물

  • 간결한 프롬프트 컨텍스트: 슬라이드 수와 크기, 텍스트 요약, 도형 수, 스타일, 브랜드 신호, 템플릿 사용, 레이아웃 리듬.
  • 요약, 슬라이드, 읽기 전용 layout_tree 증거에 대한 전체 추출.
  • 색상, 폰트, 크기 분포, 마스터/레이아웃 사용, 흐름 패턴을 다루는 스타일 마스터 분석.
  • 0부터 시작하는 소스 인덱스, 레이아웃 역할, 사용 가능한 영역, 플레이스홀더, 시각적 구조와 제약을 가진 파생 템플릿 카탈로그.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    작업별 Extractor 작성

    필요한 추출은 고정된 파이프라인이 아니라 소규모 python-pptx 스크립트로 필요에 따라 구현되므로, 새 덱에 필요한 정보만 수집됩니다.

  2. 02
    간결한 검사 실행

    scripts/inspect.py는 덱 경로를 받아 슬라이드 순서, 텍스트, 테마 토큰, 관계, 노트, 주석, 애니메이션, 미디어를 다루는 하나의 JSON 리포트를 반환합니다.

  3. 03
    OOXML 유틸리티로 확장

    내장된 유틸리티는 고수준 추출이 볼 수 없는 원시 테마, 관계, 노트, 주석, 애니메이션, 미디어, 마스터, 레이아웃에 대한 대체 경로입니다.

  4. 04
    관계를 .rels 소유자에 고정

    관계 대상은 .rels 파일을 소유한 부분을 기준으로 해석되며, 슬라이드 순서는 파일 이름에서 추론되지 않습니다.

02 적합성 확인

pptx-reference-deck-analysis Skill을 사용해야 하는 경우

이러한 종류의 PPT 및 슬라이드 덱 작업일 때 Claude Code 또는 Codex에서 pptx-reference-deck-analysis 스킬을 사용합니다. 적합성 및 제한 사항은 스킬 자체 파일에서 가져옵니다.

적합한 경우

  • 참조 덱이 새 덱에 복제되는 것이 아니라 디자인 증거로 읽히기를 원하는 경우입니다.
  • 덱 폴더 전체에 대해 진단을 실행하고 덱별 결과와 매니페스트를 원하는 경우입니다.
  • 출력 형태와 문서 전용 패턴에 대한 내장 참조 문서가 필요한 경우입니다.

한계 인지하기

  • 소스 덱을 읽기만 하는 대신 복제하거나 변형하는 모든 작업입니다.

제공할 사항

  • 참조 덱 경로내장된 스크립트는 .pptx를 첫 번째 인자로 받으며, 이는 유일하게 필수적인 입력입니다.
  • 원시 패키지 증거를 위한 출력 디렉터리unpack.py는 제공한 디렉터리에 추출된 부분을 기록하며, 원시 패키지 증거가 필요한 경우에만 실행됩니다.
  • requirements.txt의 defusedxml내장 OOXML 유틸리티를 사용하기 전에 설치됩니다.

03 스킬 내부

pptx-reference-deck-analysis 스킬이 Claude Code와 Codex에 부여하는 규칙

에이전트에게 SKILL.md가 설정하는 6가지 구체적인 지침, 기본값 및 제한 사항입니다 — 결과를 바꾸는 파일의 핵심 부분입니다.

  1. 소스는 읽기 전용으로 유지

    참조 덱은 절대 수정되지 않으며, 새 대상 슬라이드의 모든 좌표는 상속되지 않고 독립적으로 작성됩니다.

  2. 검사한 내용 기록

    검사한 모든 부분과 모든 파싱 예외는 분석 매니페스트에 기록해야 합니다.

  3. 라이선스 증거 없이는 재사용 불가

    추출된 콘텐츠, 폰트, 이미지, 독점 자산은 명시적 허가와 라이선스 증거 없이 생성된 덱에 포함되어서는 안 됩니다.

  4. 신뢰된 작업 공간에서 실행

    스크립트는 경로 조작, 심볼릭 링크, 과대 크기 멤버, 압축 폭탄을 거부하므로 신뢰된 작업 디렉터리를 전제로 합니다.

  5. Defusedxml로 XML 파싱

    신뢰할 수 없는 XML은 엔티티 확장, DTD 로딩, 네트워크 접근을 모두 끈 상태로 defusedxml을 거쳐야 합니다.

  6. 테마 색상을 토큰으로 취급

    테마 색상은 색상 구성표에 대해 완전히 해석되기 전까지는 토큰으로 유지됩니다.

04 활용하기

Claude Code 또는 Codex에 pptx-reference-deck-analysis 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용 중인 Agent에 pptx-reference-deck-analysis 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소에서 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 PPT 및 슬라이드 덱 작업 제공

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
I have a reference deck at [path/to/reference.pptx]. Inspect it as design evidence and give me the compact prompt context, a style-master analysis of colors, fonts and flow patterns, and a derived template catalog with layout roles, usable regions and placeholders. Validate the package and record inspected parts and parsing exceptions in the manifest, keeping the source read-only.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • --output과 함께 validate_package.py를 실행하고, 잘못된 XML, 깨진 내부 관계, content-type 누락, 중복된 레이아웃 링크, 고아 부분에 대한 보고서를 확인합니다.

OpenDesign에서 pptx-reference-deck-analysis를 SKILL.md 링크에서 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Repository
github.com/wshobson/agents Branch main
스킬 파일
plugins/pptx-deck-creation/skills/pptx-reference-deck-analysis/SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 4236bb9
License
MIT LICENSE에서.
리포지토리 스타
39,635 2026-09-14에 촬영된 wshobson/agents 저장소 전체의 GitHub 스냅샷이며, 이 카탈로그에는 18개의 스킬이 포함되어 있습니다. pptx-reference-deck-analysis의 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 계약다섯 가지 추출 결과물: 프롬프트 컨텍스트, 전체 추출, 폴더 진단, 스타일 마스터 분석, 템플릿 카탈로그.
  2. 규칙읽기 전용 소스, 독립적으로 작성된 좌표, 매니페스트 기록, 재사용 전 라이선스 증거.
  3. OOXML 패키지 검사defusedxml을 설치한 후 inspect.py, validate_package.py, unpack.py를 실행하고 .rels 대상을 해석합니다.
  4. 안전성신뢰된 작업 공간, 경로 조작 및 압축 폭탄 거부, defusedxml 파싱, 토큰으로서의 테마 색상.
스킬 자체 설명
"읽기 전용 구조, 테마, 타이포그래피, 레이아웃 리듬, 진단, 파생 템플릿 카탈로그 또는 안전한 OOXML 패키지 검사를 위해 참조 PPTX를 분석할 때 사용합니다."

SKILL.md의 앞부분 설명입니다. 전체 파일은 약 2,755자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

pptx-reference-deck-analysis 스킬에 대한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

참조 덱을 분석하면 파일이 변경되나요?

아니요. 이 스킬은 제공된 덱을 절대 수정하지 않으며 패키지 부분을 새 덱에 무조건 복사하지도 않습니다. 소스는 읽기 전용으로 유지되고 새 슬라이드는 독립적으로 작성됩니다.

PPTX Reference Deck Analysis

실제 PPT 및 슬라이드 덱 작업에서 pptx-reference-deck-analysis를 실행합니다.

OpenDesign을 다운로드하고, SKILL.md 링크에서 pptx-reference-deck-analysis를 가져온 다음, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽습니다.

터미널
npx skills add https://github.com/wshobson/agents --skill pptx-reference-deck-analysis

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원