@nguyenphp/antigravity-marketing 1.0.16 → 1.0.19

package/templates/.agent/skills/pptx-generator/SKILL.md

@@ -0,0 +1,249 @@
+---
+name: pptx-generator
+description: "Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides."
+license: MIT
+metadata:
+  version: "1.0"
+  category: productivity
+  sources:
+    - https://gitbrent.github.io/PptxGenJS/
+    - https://github.com/microsoft/markitdown
+---
+
+# PPTX Generator & Editor
+
+## Overview
+
+This skill handles all PowerPoint tasks: reading/analyzing existing presentations, editing template-based decks via XML manipulation, and creating presentations from scratch using PptxGenJS. It includes a complete design system (color palettes, fonts, style recipes) and detailed guidance for every slide type.
+
+## Quick Reference
+
+| Task | Approach |
+|------|----------|
+| Read/analyze content | `python -m markitdown presentation.pptx` |
+| Edit or create from template | See [Editing Presentations](references/editing.md) |
+| Create from scratch | See [Creating from Scratch](#creating-from-scratch-workflow) below |
+
+| Item | Value |
+|------|-------|
+| **Dimensions** | 10" x 5.625" (LAYOUT_16x9) |
+| **Colors** | 6-char hex without # (e.g., `"FF0000"`) |
+| **English font** | Arial (default), or approved alternatives |
+| **Chinese font** | Microsoft YaHei |
+| **Page badge position** | x: 9.3", y: 5.1" |
+| **Theme keys** | `primary`, `secondary`, `accent`, `light`, `bg` |
+| **Shapes** | RECTANGLE, OVAL, LINE, ROUNDED_RECTANGLE |
+| **Charts** | BAR, LINE, PIE, DOUGHNUT, SCATTER, BUBBLE, RADAR |
+
+## Reference Files
+
+| File | Contents |
+|------|----------|
+| [slide-types.md](references/slide-types.md) | 5 slide page types (Cover, TOC, Section Divider, Content, Summary) + additional layout patterns |
+| [design-system.md](references/design-system.md) | Color palettes, font reference, style recipes (Sharp/Soft/Rounded/Pill), typography & spacing |
+| [editing.md](references/editing.md) | Template-based editing workflow, XML manipulation, formatting rules, common pitfalls |
+| [pitfalls.md](references/pitfalls.md) | QA process, common mistakes, critical PptxGenJS pitfalls |
+| [pptxgenjs.md](references/pptxgenjs.md) | Complete PptxGenJS API reference |
+
+---
+
+## Reading Content
+
+```bash
+# Text extraction
+python -m markitdown presentation.pptx
+```
+
+---
+
+## Creating from Scratch — Workflow
+
+**Use when no template or reference presentation is available.**
+
+### Step 1: Research & Requirements
+
+Search to understand user requirements — topic, audience, purpose, tone, content depth.
+
+### Step 2: Select Color Palette & Fonts
+
+Use the [Color Palette Reference](references/design-system.md#color-palette-reference) to select a palette matching the topic and audience. Use the [Font Reference](references/design-system.md#font-reference) to choose a font pairing.
+
+### Step 3: Select Design Style
+
+Use the [Style Recipes](references/design-system.md#style-recipes) to choose a visual style (Sharp, Soft, Rounded, or Pill) matching the presentation tone.
+
+### Step 4: Plan Slide Outline
+
+Classify **every slide** as exactly one of the [5 page types](references/slide-types.md). Plan the content and layout for each slide. Ensure visual variety — do NOT repeat the same layout across slides.
+
+### Step 5: Generate Slide JS Files
+
+Create one JS file per slide in `slides/` directory. Each file must export a synchronous `createSlide(pres, theme)` function. Follow the [Slide Output Format](#slide-output-format) and the type-specific guidance in [slide-types.md](references/slide-types.md). Generate up to 5 slides concurrently using subagents if available.
+
+**Tell each subagent:**
+1. File naming: `slides/slide-01.js`, `slides/slide-02.js`, etc.
+2. Images go in: `slides/imgs/`
+3. Final PPTX goes in: `slides/output/`
+4. Dimensions: 10" x 5.625" (LAYOUT_16x9)
+5. Fonts: Chinese = Microsoft YaHei, English = Arial (or approved alternative)
+6. Colors: 6-char hex without # (e.g. `"FF0000"`)
+7. Must use the theme object contract (see [Theme Object Contract](#theme-object-contract))
+8. Must follow the [PptxGenJS API reference](references/pptxgenjs.md)
+
+### Step 6: Compile into Final PPTX
+
+Create `slides/compile.js` to combine all slide modules:
+
+```javascript
+// slides/compile.js
+const pptxgen = require('pptxgenjs');
+const pres = new pptxgen();
+pres.layout = 'LAYOUT_16x9';
+
+const theme = {
+  primary: "22223b",    // dark color for backgrounds/text
+  secondary: "4a4e69",  // secondary accent
+  accent: "9a8c98",     // highlight color
+  light: "c9ada7",      // light accent
+  bg: "f2e9e4"          // background color
+};
+
+for (let i = 1; i <= 12; i++) {  // adjust count as needed
+  const num = String(i).padStart(2, '0');
+  const slideModule = require(`./slide-${num}.js`);
+  slideModule.createSlide(pres, theme);
+}
+
+pres.writeFile({ fileName: './output/presentation.pptx' });
+```
+
+Run with: `cd slides && node compile.js`
+
+### Step 7: QA (Required)
+
+See [QA Process](references/pitfalls.md#qa-process).
+
+### Output Structure
+
+```
+slides/
+├── slide-01.js          # Slide modules
+├── slide-02.js
+├── ...
+├── imgs/                # Images used in slides
+└── output/              # Final artifacts
+    └── presentation.pptx
+```
+
+---
+
+## Slide Output Format
+
+Each slide is a **complete, runnable JS file**:
+
+```javascript
+// slide-01.js
+const pptxgen = require("pptxgenjs");
+
+const slideConfig = {
+  type: 'cover',
+  index: 1,
+  title: 'Presentation Title'
+};
+
+// MUST be synchronous (not async)
+function createSlide(pres, theme) {
+  const slide = pres.addSlide();
+  slide.background = { color: theme.bg };
+
+  slide.addText(slideConfig.title, {
+    x: 0.5, y: 2, w: 9, h: 1.2,
+    fontSize: 48, fontFace: "Arial",
+    color: theme.primary, bold: true, align: "center"
+  });
+
+  return slide;
+}
+
+// Standalone preview - use slide-specific filename
+if (require.main === module) {
+  const pres = new pptxgen();
+  pres.layout = 'LAYOUT_16x9';
+  const theme = {
+    primary: "22223b",
+    secondary: "4a4e69",
+    accent: "9a8c98",
+    light: "c9ada7",
+    bg: "f2e9e4"
+  };
+  createSlide(pres, theme);
+  pres.writeFile({ fileName: "slide-01-preview.pptx" });
+}
+
+module.exports = { createSlide, slideConfig };
+```
+
+---
+
+## Theme Object Contract (MANDATORY)
+
+The compile script passes a theme object with these **exact keys**:
+
+| Key | Purpose | Example |
+|-----|---------|---------|
+| `theme.primary` | Darkest color, titles | `"22223b"` |
+| `theme.secondary` | Dark accent, body text | `"4a4e69"` |
+| `theme.accent` | Mid-tone accent | `"9a8c98"` |
+| `theme.light` | Light accent | `"c9ada7"` |
+| `theme.bg` | Background color | `"f2e9e4"` |
+
+**NEVER use other key names** like `background`, `text`, `muted`, `darkest`, `lightest`.
+
+---
+
+## Page Number Badge (REQUIRED)
+
+All slides **except Cover Page** MUST include a page number badge in the bottom-right corner.
+
+- **Position**: x: 9.3", y: 5.1"
+- Show current number only (e.g. `3` or `03`), NOT "3/12"
+- Use palette colors, keep subtle
+
+### Circle Badge (Default)
+
+```javascript
+slide.addShape(pres.shapes.OVAL, {
+  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
+  fill: { color: theme.accent }
+});
+slide.addText("3", {
+  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
+  fontSize: 12, fontFace: "Arial",
+  color: "FFFFFF", bold: true,
+  align: "center", valign: "middle"
+});
+```
+
+### Pill Badge
+
+```javascript
+slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
+  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
+  fill: { color: theme.accent },
+  rectRadius: 0.15
+});
+slide.addText("03", {
+  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
+  fontSize: 11, fontFace: "Arial",
+  color: "FFFFFF", bold: true,
+  align: "center", valign: "middle"
+});
+```
+
+---
+
+## Dependencies
+
+- `pip install "markitdown[pptx]"` — text extraction
+- `npm install -g pptxgenjs` — creating from scratch
+- `npm install -g react-icons react react-dom sharp` — icons (optional)

package/templates/.agent/skills/pptx-generator/references/design-system.md

@@ -0,0 +1,392 @@
+# Design System
+
+## Color Palette Reference
+
+| # | Name | Colors | Style | Use Cases | Tips |
+|---|------|--------|-------|-----------|------|
+| 1 | Modern & Wellness | `#006d77` `#83c5be` `#edf6f9` `#ffddd2` `#e29578` | Fresh, soothing | Healthcare, counseling, skincare, yoga/spa | Deep teal for titles, light pink for background |
+| 2 | Business & Authority | `#2b2d42` `#8d99ae` `#edf2f4` `#ef233c` `#d90429` | Formal, classic | Annual reports, financial analysis, corporate intro, government | Deep blue for professionalism, bright red to highlight data |
+| 3 | Nature & Outdoors | `#606c38` `#283618` `#fefae0` `#dda15e` `#bc6c25` | Grounded, earthy | Outdoor gear, environmental, agriculture, historical culture | Dark green base, cream text |
+| 4 | Vintage & Academic | `#780000` `#c1121f` `#fdf0d5` `#003049` `#669bbc` | Classic, scholarly | Academic lectures, history reviews, museums, heritage brands | Strong contrast between deep red and deep blue |
+| 5 | Soft & Creative | `#cdb4db` `#ffc8dd` `#ffafcc` `#bde0fe` `#a2d2ff` | Dreamy, candy-toned | Mother & baby, desserts, women's fashion, kindergarten | Use dark gray or black for text |
+| 6 | Bohemian | `#ccd5ae` `#e9edc9` `#fefae0` `#faedcd` `#d4a373` | Gentle, muted | Wedding planning, home decor, organic food, slow living | Cream background, green-brown accents |
+| 7 | Vibrant & Tech | `#8ecae6` `#219ebc` `#023047` `#ffb703` `#fb8500` | High energy, sporty | Sports events, gyms, startup pitches, youth education | Deep blue for stability, orange as focal accent |
+| 8 | Craft & Artisan | `#7f5539` `#a68a64` `#ede0d4` `#656d4a` `#414833` | Rustic, coffee-toned | Coffee shops, handicrafts, traditional culture, bakery | Suited for paper/leather textures |
+| 9 | Tech & Night | `#000814` `#001d3d` `#003566` `#ffc300` `#ffd60a` | Deep, luminous | Tech launches, astronomy, night economy, luxury automobiles | Must use dark mode |
+| 10 | Education & Charts | `#264653` `#2a9d8f` `#e9c46a` `#f4a261` `#e76f51` | Clear, logical | Statistical reports, education, market analysis, general business | Perfect chart color scheme |
+| 11 | Forest & Eco | `#dad7cd` `#a3b18a` `#588157` `#3a5a40` `#344e41` | Monochrome gradient, forest | Landscape design, ESG reports, environmental causes, botanical | Monochrome palette is safe and cohesive |
+| 12 | Elegant & Fashion | `#edafb8` `#f7e1d7` `#dedbd2` `#b0c4b1` `#4a5759` | Muted, Morandi tones | Haute couture, art galleries, beauty brands, magazine style | Negative space is key |
+| 13 | Art & Food | `#335c67` `#fff3b0` `#e09f3e` `#9e2a2b` `#540b0e` | Rich, vintage-poster | Food documentaries, art exhibitions, ethnic themes, vintage restaurants | Works well with large color blocks |
+| 14 | Luxury & Mysterious | `#22223b` `#4a4e69` `#9a8c98` `#c9ada7` `#f2e9e4` | Cool, purple-toned | Jewelry showcases, hotel management, high-end consulting, psychology | Purple evokes premium atmosphere |
+| 15 | Pure Tech Blue | `#03045e` `#0077b6` `#00b4d8` `#90e0ef` `#caf0f8` | Futuristic, clean | Cloud/AI, water/ocean, hospitals, clean energy | Deep ocean to sky gradient |
+| 16 | Coastal Coral | `#0081a7` `#00afb9` `#fdfcdc` `#fed9b7` `#f07167` | Refreshing, summery | Travel, summer events, beverage brands, ocean themes | Teal and coral as complementary focal colors |
+| 17 | Vibrant Orange Mint | `#ff9f1c` `#ffbf69` `#ffffff` `#cbf3f0` `#2ec4b6` | Bright, cheerful | Children's events, promotional posters, FMCG, social media | Orange grabs attention, mint feels fresh |
+| 18 | Platinum White Gold | `#0a0a0a` `#0070F3` `#D4AF37` `#f5f5f5` `#ffffff` | Premium, professional | Agent products, corporate websites, fintech, luxury brands | White-gold base, blue for action, gold for emphasis |
+
+---
+
+### Agent Design System — Full Color Scale
+
+Based on the Platinum White-Gold Theme design tokens. Provides complete color scales for fine-grained design work.
+
+#### White Scale (Backgrounds & Light Surfaces)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| white-0 | `#ffffff` | Primary background |
+| white-50 | `#fefefe` | Slightly warm white |
+| white-75 | `#fcfcfc` | Near-white |
+| white-100 | `#fafafa` | Secondary background |
+| white-200 | `#f7f7f7` | Card background |
+| white-300 | `#f5f5f5` | Tertiary background |
+| white-400 | `#f0f0f0` | Separator zones |
+| white-500 | `#ebebeb` | Light border |
+| white-600 | `#e5e5e5` | Disabled background |
+| white-700 | `#e0e0e0` | Deep white-gray |
+| white-800 | `#d9d9d9` | Placeholder |
+| white-900 | `#d4d4d4` | Divider lines |
+| white-1000 | `#cccccc` | Deepest white |
+
+#### Gold Scale (Platinum Business Accent)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| gold-25 | `#FFFDF5` | Extremely light gold background |
+| gold-50 | `#FEF9E7` | Light gold background |
+| gold-75 | `#FCF3D0` | Pale gold highlight |
+| gold-100 | `#FAECB8` | Gold hover state |
+| gold-200 | `#F5DC8A` | Bright gold accent |
+| gold-300 | `#E8C860` | Gold hover |
+| gold-400 | `#D4AF37` | **Primary gold (core)** |
+| gold-500 | `#B8972E` | Gold text |
+| gold-600 | `#9A7E26` | Deep gold accent |
+| gold-700 | `#7C651E` | Dark gold border |
+| gold-800 | `#5E4C16` | Deep gold background |
+| gold-900 | `#40330F` | Very deep gold |
+| gold-1000 | `#221A08` | Black gold |
+
+#### Blue Scale (Primary Action Color)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| blue-25 | `#F0F7FF` | Extremely light blue background |
+| blue-50 | `#E0EFFF` | Info alert background |
+| blue-75 | `#C2DFFF` | Light blue highlight |
+| blue-100 | `#A3CFFF` | Disabled blue |
+| blue-200 | `#66AFFF` | Bright blue |
+| blue-300 | `#338FFF` | Blue hover |
+| blue-400 | `#0070F3` | **Primary blue (core)** |
+| blue-500 | `#005FCC` | Blue text |
+| blue-600 | `#004FA6` | Deep blue accent |
+| blue-700 | `#003F80` | Dark blue border |
+| blue-800 | `#002F5A` | Deep blue background |
+| blue-900 | `#001F3D` | Very deep blue |
+| blue-1000 | `#001026` | Black blue |
+
+#### Gray Scale (Text & Neutral Colors)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| gray-0 | `#ffffff` | White |
+| gray-50 | `#fafafa` | Extremely light gray |
+| gray-75 | `#f5f5f5` | Light gray background |
+| gray-100 | `#ededed` | Light divider |
+| gray-200 | `#d4d4d4` | Light border |
+| gray-300 | `#a3a3a3` | Quaternary text |
+| gray-400 | `#737373` | Tertiary text |
+| gray-500 | `#525252` | Secondary text |
+| gray-600 | `#404040` | Dark gray |
+| gray-700 | `#2e2e2e` | Dark background |
+| gray-800 | `#1f1f1f` | Deep background |
+| gray-900 | `#141414` | Very deep background |
+| gray-1000 | `#0a0a0a` | **Primary text (core)** |
+
+#### Opacity Values
+
+##### Opacity Black
+
+| Opacity | Value | Usage |
+|---------|-------|-------|
+| 0% | `#0a0a0a00` | Fully transparent |
+| 2% | `#0a0a0a05` | Subtle overlay |
+| 4% | `#0a0a0a0a` | Secondary interactive background |
+| 8% | `#0a0a0a14` | Border / divider |
+| 15% | `#0a0a0a26` | Pressed state |
+| 20% | `#0a0a0a33` | Light overlay |
+| 25% | `#0a0a0a40` | Medium overlay |
+| 50% | `#0a0a0a80` | Semi-transparent |
+| 70% | `#0a0a0ab2` | Deep overlay |
+| 80% | `#0a0a0acc` | Hover state |
+| 90% | `#0a0a0ae5` | Tooltip |
+| 95% | `#0a0a0af2` | Modal |
+
+##### Opacity White
+
+| Opacity | Value | Usage |
+|---------|-------|-------|
+| 0% | `#ffffff00` | Fully transparent |
+| 2% | `#ffffff05` | Subtle overlay |
+| 4% | `#ffffff0a` | Secondary interactive background |
+| 8% | `#ffffff12` | Border / divider |
+| 15% | `#ffffff26` | Pressed state |
+| 20% | `#ffffff33` | Light overlay |
+| 25% | `#ffffff40` | Medium overlay |
+| 50% | `#ffffff80` | Semi-transparent |
+| 70% | `#ffffffb2` | Deep overlay |
+| 80% | `#ffffffcc` | Hover state |
+| 90% | `#ffffffe5` | Tooltip |
+| 95% | `#fffffff2` | Modal |
+
+---
+
+## Color Palette Rules (MANDATORY)
+
+### Strict Palette Adherence
+
+**Use ONLY the provided color palette. Do NOT create or modify colors.**
+
+- All colors must come from the user-provided palette
+- Do NOT use colors outside the palette
+- Do NOT modify palette colors (brightness, saturation, mixing)
+- **Only exception**: Add transparency using the `transparency` property (0-100)
+
+```javascript
+// Correct: Using palette colors
+slide.addShape(pres.shapes.RECTANGLE, { fill: { color: theme.primary } });
+slide.addText("Title", { color: theme.accent });
+
+// Wrong: Colors outside palette
+slide.addShape(pres.shapes.RECTANGLE, { fill: { color: "1a1a2e" } });
+```
+
+### No Gradients
+
+**Gradients are prohibited. Use solid colors only.**
+
+### No Animations
+
+**Animations and transitions are prohibited.** All slides must be static.
+
+---
+
+## Font Reference
+
+### Recommended Fonts
+
+| Language | Default Font | Alternatives |
+|----------|-------------|--------------|
+| **Chinese** | Microsoft YaHei | — |
+| **English** | Arial | Georgia, Calibri, Cambria, Trebuchet MS |
+
+- For mixed Chinese-English content: use Microsoft YaHei for Chinese, the chosen font for English
+- Prefer system fonts for cross-platform compatibility
+- Titles and body text can use different font pairings (e.g. Georgia + Calibri)
+
+### Recommended Font Pairings
+
+| Header Font | Body Font |
+|-------------|-----------|
+| Georgia | Calibri |
+| Arial Black | Arial |
+| Calibri | Calibri Light |
+| Cambria | Calibri |
+| Trebuchet MS | Calibri |
+| Impact | Arial |
+| Palatino | Garamond |
+| Consolas | Calibri |
+
+**Choose an interesting font pairing** — don't default to Arial for everything. Pick a header font with personality and pair it with a clean body font.
+
+### No Bold for Body Text
+
+**Plain body text and caption/legend text must NOT use bold.**
+
+- Body paragraphs, descriptions → normal weight
+- Captions, legends, footnotes → normal weight
+- Reserve bold for titles and headings only
+
+```javascript
+// Correct
+slide.addText("Main Title", { bold: true, fontSize: 36, fontFace: "Arial" });
+slide.addText("Body text here.", { bold: false, fontSize: 14, fontFace: "Arial" });
+
+// Wrong
+slide.addText("Body text here.", { bold: true, fontSize: 14 });
+```
+
+---
+
+## Style Recipes
+
+The same design can be rendered in 4 distinct visual styles by adjusting corner radius (`rectRadius`) and spacing. Choose the style recipe that fits the presentation tone.
+
+> **Unit note**: PptxGenJS uses inches. Slide dimensions are 10" x 5.625" (LAYOUT_16x9).
+
+### Style Overview
+
+| Style | Corner Radius | Spacing | Best For |
+|-------|--------------|---------|----------|
+| **Sharp & Compact** | 0 ~ 0.05" | Tight | Data-dense, tables, professional reports |
+| **Soft & Balanced** | 0.08" ~ 0.12" | Moderate | Corporate, business presentations, general use |
+| **Rounded & Spacious** | 0.15" ~ 0.25" | Relaxed | Product intros, marketing, creative showcases |
+| **Pill & Airy** | 0.3" ~ 0.5" | Open | Brand showcases, launch events, premium presentations |
+
+### Sharp & Compact
+
+**Visual character**: Geometric, high information density, formal and serious.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0" | Full right angle |
+| Corner radius — medium | 0.03" | Micro-rounded |
+| Corner radius — large | 0.05" | Slight rounding |
+| Element padding | 0.1" ~ 0.15" | Compact |
+| Element gap | 0.1" ~ 0.2" | Compact |
+| Page margin | 0.3" | Narrow |
+| Block gap | 0.25" ~ 0.35" | Compact |
+
+### Soft & Balanced
+
+**Visual character**: Moderate rounding, comfortable whitespace, professional yet approachable.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.05" | Slight rounding |
+| Corner radius — medium | 0.08" | Medium rounding |
+| Corner radius — large | 0.12" | Larger rounding |
+| Element padding | 0.15" ~ 0.2" | Moderate |
+| Element gap | 0.15" ~ 0.25" | Moderate |
+| Page margin | 0.4" | Standard |
+| Block gap | 0.35" ~ 0.5" | Moderate |
+
+### Rounded & Spacious
+
+**Visual character**: Large corners, generous whitespace, friendly and modern.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.1" | Medium rounding |
+| Corner radius — medium | 0.15" | Large rounding |
+| Corner radius — large | 0.25" | Very large rounding |
+| Element padding | 0.2" ~ 0.3" | Relaxed |
+| Element gap | 0.25" ~ 0.4" | Relaxed |
+| Page margin | 0.5" | Wide |
+| Block gap | 0.5" ~ 0.7" | Relaxed |
+
+### Pill & Airy
+
+**Visual character**: Full pill-shaped corners, abundant whitespace, light and open feel, strong brand presence.
+
+| Category | Value (inches) | Notes |
+|----------|---------------|-------|
+| Corner radius — small | 0.2" | Large rounding |
+| Corner radius — medium | 0.3" | Pill shape |
+| Corner radius — large | 0.5" | Full pill |
+| Element padding | 0.25" ~ 0.4" | Open |
+| Element gap | 0.3" ~ 0.5" | Open |
+| Page margin | 0.6" | Wide |
+| Block gap | 0.6" ~ 0.9" | Open |
+
+### Component Style Mapping
+
+| Component | Sharp | Soft | Rounded | Pill |
+|-----------|-------|------|---------|------|
+| **Button / Tag** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
+| **Card / Container** | rectRadius: 0.03 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.3 |
+| **Image Container** | rectRadius: 0 | rectRadius: 0.08 | rectRadius: 0.15 | rectRadius: 0.25 |
+| **Input Field** | rectRadius: 0 | rectRadius: 0.05 | rectRadius: 0.1 | rectRadius: 0.2 |
+| **Badge** | rectRadius: 0.02 | rectRadius: 0.05 | rectRadius: 0.08 | rectRadius: 0.15 |
+| **Avatar Frame** | rectRadius: 0 | rectRadius: 0.1 | rectRadius: 0.2 | rectRadius: 0.5 (circle) |
+
+#### PptxGenJS Corner Radius Examples
+
+```javascript
+// Sharp style card
+slide.addShape("rect", {
+  x: 0.5, y: 1, w: 4, h: 2.5,
+  fill: { color: "F5F5F5" },
+  rectRadius: 0.03
+});
+
+// Rounded style card
+slide.addShape("rect", {
+  x: 0.5, y: 1, w: 4, h: 2.5,
+  fill: { color: "F5F5F5" },
+  rectRadius: 0.2
+});
+
+// Pill style button (height 0.4", rectRadius 0.2" = perfect pill)
+slide.addShape("rect", {
+  x: 3, y: 4, w: 2, h: 0.4,
+  fill: { color: "4A90D9" },
+  rectRadius: 0.2
+});
+```
+
+### Mixing Rules
+
+#### 1. Outer container corner >= inner element corner
+
+```javascript
+// Correct: outer > inner
+card:   rectRadius: 0.2
+button: rectRadius: 0.1
+
+// Wrong: inner > outer → visual overflow effect
+card:   rectRadius: 0.1
+button: rectRadius: 0.2
+```
+
+#### 2. Information density drives spacing
+
+| Zone Type | Recommended Style |
+|-----------|------------------|
+| Data display zone | Sharp / Soft (compact spacing) |
+| Content browsing zone | Rounded / Pill (relaxed spacing) |
+| Title zone | Soft / Rounded (moderate spacing) |
+
+#### 3. Corner radius vs element height
+
+| Element Height | Sharp | Soft | Rounded | Pill |
+|---------------|-------|------|---------|------|
+| Small (< 0.3") | 0" | 0.03" | 0.08" | height/2 |
+| Medium (0.3" ~ 0.6") | 0.02" | 0.05" | 0.12" | height/2 |
+| Large (0.6" ~ 1.2") | 0.03" | 0.08" | 0.2" | 0.3" |
+| Extra large (> 1.2") | 0.05" | 0.12" | 0.25" | 0.4" |
+
+> **Pill tip**: For a perfect pill shape, set `rectRadius = element height / 2`
+
+### Typography Scale (PPT)
+
+| Usage | Size (pt) | Notes |
+|-------|-----------|-------|
+| Annotations / Sources | 10 ~ 12 | Minimum readable size |
+| Body / Description | 14 ~ 16 | Standard body |
+| Subtitle | 18 ~ 22 | Secondary heading |
+| Title | 28 ~ 36 | Page title |
+| Large Title | 44 ~ 60 | Cover / section title |
+| Data Callout | 60 ~ 96 | Key number display |
+
+### Spacing Scale (PPT)
+
+Based on 10" x 5.625" slide dimensions:
+
+| Usage | Recommended (inches) |
+|-------|---------------------|
+| Icon-to-text gap | 0.08" ~ 0.15" |
+| List item spacing | 0.15" ~ 0.25" |
+| Card inner padding | 0.2" ~ 0.4" |
+| Element group gap | 0.3" ~ 0.5" |
+| Page safe margin | 0.4" ~ 0.6" |
+| Major block gap | 0.5" ~ 0.8" |
+
+### Quick Selection Guide
+
+| Presentation Type | Recommended Style | Reason |
+|------------------|------------------|--------|
+| Finance / Data reports | Sharp & Compact | High density, serious and precise |
+| Corporate / Business | Soft & Balanced | Balances professionalism and approachability |
+| Product intro / Marketing | Rounded & Spacious | Modern feel, friendly |
+| Launch events / Brand | Pill & Airy | Premium feel, visual impact |
+| Training / Education | Soft / Rounded | Clear, readable, friendly |
+| Tech sharing | Sharp / Soft | Professional, information-dense |