opencode-sa-assistant 0.1.0

package/src/skills/pptx/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: pptx
+description: "PowerPoint 프레젠테이션 생성, 편집, 분석. 새 프레젠테이션 생성, 기존 콘텐츠 수정, 레이아웃 작업, 코멘트/발표자 노트 추가 등 모든 .pptx 파일 작업에 사용"
+license: Proprietary
+---
+
+# PPTX creation, editing, and analysis
+
+## Overview
+
+A user may ask you to create, edit, or analyze the contents of a .pptx file. A .pptx file is essentially a ZIP archive containing XML files and other resources that you can read or edit. You have different tools and workflows available for different tasks.
+
+## Reading and analyzing content
+
+### Text extraction
+If you just need to read the text contents of a presentation, you should convert the document to markdown:
+
+```bash
+# Convert document to markdown
+python -m markitdown path-to-file.pptx
+```
+
+### Raw XML access
+You need raw XML access for: comments, speaker notes, slide layouts, animations, design elements, and complex formatting. For any of these features, you'll need to unpack a presentation and read its raw XML contents.
+
+#### Unpacking a file
+`python ooxml/scripts/unpack.py <office_file> <output_dir>`
+
+#### Key file structures
+* `ppt/presentation.xml` - Main presentation metadata and slide references
+* `ppt/slides/slide{N}.xml` - Individual slide contents (slide1.xml, slide2.xml, etc.)
+* `ppt/notesSlides/notesSlide{N}.xml` - Speaker notes for each slide
+* `ppt/comments/modernComment_*.xml` - Comments for specific slides
+* `ppt/slideLayouts/` - Layout templates for slides
+* `ppt/slideMasters/` - Master slide templates
+* `ppt/theme/` - Theme and styling information
+* `ppt/media/` - Images and other media files
+
+## Creating a new PowerPoint presentation **without a template**
+
+When creating a new PowerPoint presentation from scratch, use the **html2pptx** workflow to convert HTML slides to PowerPoint with accurate positioning.
+
+### Design Principles
+
+**CRITICAL**: Before creating any presentation, analyze the content and choose appropriate design elements:
+1. **Consider the subject matter**: What is this presentation about? What tone, industry, or mood does it suggest?
+2. **Check for branding**: If the user mentions a company/organization, consider their brand colors and identity
+3. **Match palette to content**: Select colors that reflect the subject
+4. **State your approach**: Explain your design choices before writing code
+
+**Requirements**:
+- ✅ State your content-informed design approach BEFORE writing code
+- ✅ Use web-safe fonts only: Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact
+- ✅ Create clear visual hierarchy through size, weight, and color
+- ✅ Ensure readability: strong contrast, appropriately sized text, clean alignment
+- ✅ Be consistent: repeat patterns, spacing, and visual language across slides
+
+### Workflow
+1. **MANDATORY - READ RESOURCE FILE**: Read `references/html2pptx.md` completely for detailed syntax, critical formatting rules, and best practices
+2. Create an HTML file for each slide with proper dimensions (e.g., 720pt × 405pt for 16:9)
+   - Use `<p>`, `<h1>`-`<h6>`, `<ul>`, `<ol>` for all text content
+   - Use `class="placeholder"` for areas where charts/tables will be added
+   - **CRITICAL**: Rasterize gradients and icons as PNG images FIRST using Sharp, then reference in HTML
+3. Create and run a JavaScript file using the `html2pptx.js` library to convert HTML slides to PowerPoint
+4. **Visual validation**: Generate thumbnails and inspect for layout issues
+
+### AWS SA Presentation Style
+AWS Solutions Architect 스타일의 프레젠테이션을 생성할 때는 `references/sa_pptx_template.md` 파일을 참조하세요.
+AWS 브랜드 색상 팔레트, 표준 슬라이드 구성, HTML 템플릿 예제가 포함되어 있습니다.
+
+## Editing an existing PowerPoint presentation
+
+When editing slides in an existing PowerPoint presentation, you need to work with the raw Office Open XML (OOXML) format.
+
+### Workflow
+1. Unpack the presentation: `python ooxml/scripts/unpack.py <office_file> <output_dir>`
+2. Edit the XML files (primarily `ppt/slides/slide{N}.xml` and related files)
+3. **CRITICAL**: Validate immediately after each edit
+4. Pack the final presentation: `python ooxml/scripts/pack.py <input_directory> <office_file>`
+
+## Creating a new PowerPoint presentation **using a template**
+
+When you need to create a presentation that follows an existing template's design:
+
+### Workflow
+1. **Extract template text AND create visual thumbnail grid**:
+   * Extract text: `python -m markitdown template.pptx > template-content.md`
+   * Create thumbnail grids: `python scripts/thumbnail.py template.pptx`
+
+2. **Analyze template and save inventory to a file**
+
+3. **Create presentation outline based on template inventory**
+
+4. **Duplicate, reorder, and delete slides using `rearrange.py`**
+
+5. **Extract ALL text using the `inventory.py` script**
+
+6. **Generate replacement text and save the data to a JSON file**
+
+7. **Apply replacements using the `replace.py` script**
+
+## Dependencies
+
+Required dependencies:
+- **markitdown**: `pip install "markitdown[pptx]"` (for text extraction)
+- **pptxgenjs**: `npm install -g pptxgenjs` (for creating presentations)
+- **playwright**: `npm install -g playwright` (for HTML rendering)
+- **sharp**: `npm install -g sharp` (for SVG rasterization)
+- **LibreOffice**: For PDF conversion
+- **Poppler**: For pdftoppm

package/src/skills/pptx/references/sa_pptx_template.md

@@ -0,0 +1,89 @@
+# SA PPTX Template - AWS Architecture Review Style
+
+AWS Solutions Architect 아키텍처 리뷰 프레젠테이션 템플릿입니다.
+
+## 색상 팔레트
+
+```javascript
+const SA_TEMPLATE_COLORS = {
+  // Primary
+  PRIMARY_DARK: "232F3E",     // AWS Squid Ink - 헤더, 제목
+  PRIMARY_ORANGE: "FF9900",   // AWS Orange - 강조, CTA
+  
+  // Secondary
+  SECONDARY_GRAY: "545B64",   // Anchor - 본문 텍스트
+  LIGHT_GRAY: "879596",       // Harbor - 보조 텍스트
+  BG_GRAY: "F2F3F3",          // Cloud - 배경
+  
+  // Status Colors
+  SUCCESS_GREEN: "1B660F",
+  WARNING_YELLOW: "F2B705",
+  ERROR_RED: "D13212",
+  INFO_BLUE: "0073BB",
+  
+  // Chart Colors
+  CHART: ["FF9900", "232F3E", "1B660F", "0073BB", "8C4FFF", "DD344C"]
+};
+```
+
+## 슬라이드 템플릿
+
+### 1. 타이틀 슬라이드
+
+```html
+<body style="background: #232F3E;">
+<div class="container">
+  <p class="subtitle">AWS ARCHITECTURE REVIEW</p>
+  <h1 class="title">[고객사명] 아키텍처 리뷰</h1>
+  <p class="info">2025년 1월 | AWS SA Team</p>
+</div>
+</body>
+```
+
+### 2. 아젠다 슬라이드
+
+```html
+<div class="header"><h1>Agenda</h1></div>
+<div class="content">
+  <div class="agenda-item">
+    <div class="number"><p>1</p></div>
+    <p>프로젝트 개요</p>
+  </div>
+  <!-- ... -->
+</div>
+```
+
+### 3. 섹션 구분 슬라이드
+
+2단 레이아웃: 왼쪽 다크 패널 (섹션 번호 + 제목), 오른쪽 라이트 패널 (설명)
+
+### 4. 콘텐츠 슬라이드 (텍스트 + 다이어그램)
+
+헤더 + 2단 레이아웃: 왼쪽 35% (텍스트), 오른쪽 65% (다이어그램 placeholder)
+
+### 5. 비교 슬라이드 (As-Is vs To-Be)
+
+2단 레이아웃: 왼쪽 (빨간색 테두리, ✕ 아이콘), 오른쪽 (녹색 테두리, ✓ 아이콘)
+
+### 6. 비용 분석 슬라이드
+
+2단 레이아웃: 왼쪽 (비용 카드), 오른쪽 (서비스별 내역 + 차트 placeholder)
+
+### 7. 타임라인 슬라이드
+
+가로 타임라인: Phase 1 → Phase 2 → Phase 3 → Go-Live
+
+### 8. 다음 단계 슬라이드
+
+3단 카드 레이아웃: 각 카드에 번호, 제목, 설명, 담당자/기한
+
+### 9. 감사 슬라이드
+
+중앙 정렬: "Thank You" + 구분선 + "Questions & Discussion" + 연락처
+
+## 사용 가이드
+
+1. 위 템플릿 중 필요한 슬라이드 선택
+2. 고객/프로젝트 정보로 내용 수정
+3. html2pptx로 각 슬라이드 변환
+4. PptxGenJS로 차트/다이어그램 추가