Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(icons): clarify filled vs outline selection rules

hugohe353b2539fc952
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index a868818c..ff75d5a3 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -81,10 +81,10 @@ Four approaches: **A: Emoji** (`<text>🚀</text>`) | **B: AI-generated** (SVG b
**Two icon libraries**:
-| Library | Style | Count | Prefix | Best for |
-|---------|-------|-------|--------|----------|
-| `tabler-filled` | fill/solid | 1000+ | `tabler-filled/` | Modern solid icons |
-| `tabler-outline` | stroke/line | 5000+ | `tabler-outline/` | Light, elegant style |
+| Library | Style | Count | Prefix | When to use |
+|---------|-------|-------|--------|-------------|
+| `tabler-filled` | fill/solid | 1000+ | `tabler-filled/` | ✅ **Default** — projection / presentation / most scenarios |
+| `tabler-outline` | stroke/line | 5000+ | `tabler-outline/` | Screen-only decks needing a light, elegant aesthetic |
**Searching for icons** — use terminal, zero token cost:
```bash
@@ -92,30 +92,30 @@ ls skills/ppt-master/templates/icons/tabler-filled/ | grep home
ls skills/ppt-master/templates/icons/tabler-outline/ | grep chart
```
-**Abstract concept → icon name** (for concepts whose meaning isn't obvious from the filename):
-
-| Concept | tabler-filled | tabler-outline |
-|---------|---------------|----------------|
-| Growth / Increase | `arrow-trend-up` | `arrow-trend-up` |
-| Decline / Decrease | `arrow-trend-down` | `arrow-trend-down` |
-| Success / Complete | `circle-check` | `circle-check` |
-| Warning / Risk | `alert-triangle` | `alert-triangle` |
-| Innovation / Idea | `bulb` | `bulb` |
-| Strategy / Goal | `target` | `target` |
-| Efficiency / Speed | `bolt` | `bolt` |
-| Collaboration / Team | `users` | `users` |
-| Settings / Config | `settings` | `settings` |
-| Security / Trust | `shield` | `shield` |
-| Money / Finance | `currency-dollar` | `currency-dollar` |
-| Time / Deadline | `clock` | `clock` |
-| Location / Region | `map-pin` | `map-pin` |
-| Communication | `message` | `message` |
-| Analysis / Data | `chart-bar` | `chart-bar` |
-| Process / Flow | `refresh` | `refresh` |
-| Global / World | `world` | `world` |
-| Excellence / Award | `star` | `star` |
-| Expand / Scale | `maximize` | `maximize` |
-| Problem / Issue | `bug` | `bug` |
+**Abstract concept → icon name** (icon names are identical across both libraries; add the library prefix when using):
+
+| Concept | Icon Name |
+|---------|-----------|
+| Growth / Increase | `arrow-trend-up` |
+| Decline / Decrease | `arrow-trend-down` |
+| Success / Complete | `circle-check` |
+| Warning / Risk | `alert-triangle` |
+| Innovation / Idea | `bulb` |
+| Strategy / Goal | `target` |
+| Efficiency / Speed | `bolt` |
+| Collaboration / Team | `users` |
+| Settings / Config | `settings` |
+| Security / Trust | `shield` |
+| Money / Finance | `currency-dollar` |
+| Time / Deadline | `clock` |
+| Location / Region | `map-pin` |
+| Communication | `message` |
+| Analysis / Data | `chart-bar` |
+| Process / Flow | `refresh` |
+| Global / World | `world` |
+| Excellence / Award | `star` |
+| Expand / Scale | `maximize` |
+| Problem / Issue | `bug` |
> For self-evident names (home, user, file, search, arrow, etc.) — just `grep` directly without consulting the table.
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 4fc104e2..b9c33379 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -106,15 +106,15 @@ Proactively provide a color scheme (HEX values) based on content characteristics
Built-in library contains 6000+ icons across two libraries:
-| Library | Style | Count | Prefix |
-|---------|-------|-------|--------|
-| `tabler-filled` | fill/solid | 1000+ | `tabler-filled/` |
-| `tabler-outline` | stroke/line | 5000+ | `tabler-outline/` |
+| Library | Style | Count | Prefix | When to use |
+|---------|-------|-------|--------|-------------|
+| `tabler-filled` | fill/solid | 1000+ | `tabler-filled/` | ✅ **Default** — projection / presentation / most scenarios |
+| `tabler-outline` | stroke/line | 5000+ | `tabler-outline/` | Screen-only decks needing a light, elegant aesthetic |
> **Mandatory rules when choosing C**:
-> 1. **Lock icon style first** — choose ONE of the two styles for the entire presentation:
-> - **Fill/Solid style**: use `tabler-filled`
-> - **Outline/Stroke style**: use `tabler-outline`
+> 1. **Lock icon style first** — default to `tabler-filled`; only switch to `tabler-outline` when the design explicitly calls for a light, line-art style and the deck will be viewed on-screen (not projected):
+> - **Fill/Solid style** (default): use `tabler-filled`
+> - **Outline/Stroke style** (screen-only, light aesthetic): use `tabler-outline`
> - ⚠️ Mixing fill and outline icons in the same presentation is FORBIDDEN
> 2. Search for icon availability: `ls skills/ppt-master/templates/icons/<library>/ | grep <keyword>`
> 3. Use the verified filename (without `.svg`) as the icon name
diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.md
index 7f37104a..3db0f70c 100644
--- a/skills/ppt-master/templates/icons/README.md
+++ b/skills/ppt-master/templates/icons/README.md
@@ -52,6 +52,13 @@ ls skills/ppt-master/templates/icons/tabler-outline/ | grep chart
## Style Rules
-- **Fill / Solid**: use `tabler-filled`
-- **Stroke / Line**: use `tabler-outline`
-- ⚠️ Do **not** mix fill and outline icons in the same presentation
+**Default: use `tabler-filled`** — PPT is a projection medium (bright rooms, projector washes out contrast, audience sits 3–10 m away). Solid filled icons remain clearly legible under these conditions.
+
+Use `tabler-outline` only when the design explicitly calls for a light, minimal, line-art style — and only when the presentation will be viewed on-screen at close range rather than projected.
+
+| Library | When to use |
+|---------|-------------|
+| `tabler-filled` ✅ **(default)** | Projection / presentation / most scenarios |
+| `tabler-outline` | Screen-only decks needing a light, elegant aesthetic |
+
+⚠️ Do **not** mix fill and outline icons in the same presentation — pick one style and use it consistently throughout.