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): replace tone-to-library mapping with visual characteristic descriptions

hugohe35b3626ce28b4
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 4a665145..e511fd75 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -93,12 +93,11 @@ The built-in icon library contains multiple stylistic libraries plus a brand-log
See [`../templates/icons/README.md`](../templates/icons/README.md) for the current library inventory, counts, prefixes, and SVG placeholder details.
> **Mandatory rules when choosing C**:
-> 1. **Pick exactly one stylistic library based on content tone** (reference mappings — not hard rules):
-> - **Tech / engineering / enterprise / data** → `chunk-filled` — sharp, rectilinear geometry (M/L/H/V/Z only) matches the precise, structured tone
-> - **Lifestyle / health / home / wellness** → `tabler-filled` — smooth bezier curves and arcs (C/A) match the warm, organic tone
-> - **Light, refined, minimal showcases** (screen-only) → `tabler-outline` — stroke-only forms match the airy, elegant tone
-> - **Modern SaaS / fintech / product launches** → `phosphor-duotone` — soft depth via single-color backplate, more contemporary than flat fill
-> - When content tone doesn't cleanly match any row above, pick the library whose visual character best serves the deck — explain the choice in the Design Spec.
+> 1. **Pick exactly one stylistic library** — read the source material, then choose the library whose visual character best serves the deck:
+> - **`chunk-filled`** — fill, straight-line geometry (M/L/H/V/Z only); sharp right angles; heavy, solid, architectural
+> - **`tabler-filled`** — fill, bezier curves and arcs (C/A); smooth, rounded, organic; medium weight, approachable
+> - **`tabler-outline`** — stroke (line art); airy, refined, lightweight; best for screen-only (thin strokes may be hard to read in print)
+> - **`phosphor-duotone`** — duotone; main shape + 20% opacity backplate; medium weight, layered, contemporary
> - ⚠️ **One presentation = one stylistic library** for generic icons (home, chart, users, etc.). Mixing `chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone` is FORBIDDEN. If the chosen library lacks an exact icon, find the closest alternative **within that same library**.
> - **Brand-logo exception**: `simple-icons` is NOT a stylistic library. Add it to the deck's icon inventory **only when** the deck genuinely contains real company / product / service brand marks (customer logos, tech-stack icons, social handles). Never substitute it for a missing generic icon.
> 2. Search for icon availability: `ls skills/ppt-master/templates/icons/<chosen-library>/ | grep <keyword>`
diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.md
index 65fb3b56..78540f17 100644
--- a/skills/ppt-master/templates/icons/README.md
+++ b/skills/ppt-master/templates/icons/README.md
@@ -65,14 +65,16 @@ ls skills/ppt-master/templates/icons/simple-icons/ | grep github
## Style Rules
-**No default library — actively choose based on content tone.** Read the source material first, judge its character, then lock a library. Each library's visual language suits a different kind of content:
+**No default library — actively choose based on the deck's visual needs.** Read the source material first, then pick the library whose visual character best serves the presentation. Each library has a distinct visual personality:
-- **`chunk-filled`** — **fill** style, built from straight-line commands only (M/L/H/V/Z); sharp, precise angles; structured and highly legible.
-- **`tabler-filled`** — **fill** style, built from bezier curves and arcs (C/A); smooth, rounded, organic contours — warmer and softer in tone.
-- **`tabler-outline`** — **stroke** style (line art); airy and refined.
-- **`phosphor-duotone`** — **duotone** style; main shape at full opacity plus a backplate of the same color at 20% opacity, producing a soft sense of depth without the heaviness of a solid fill.
+- **`chunk-filled`** — **fill** style, built from straight-line commands only (M/L/H/V/Z). Sharp, precise right angles; rectilinear geometry; structured and highly legible at small sizes. Visual weight: heavy, solid, architectural.
+- **`tabler-filled`** — **fill** style, built from bezier curves and arcs (C/A). Smooth, rounded, organic contours; warmer and softer than `chunk-filled`. Visual weight: medium, approachable.
+- **`tabler-outline`** — **stroke** style (line art, default stroke-width 2). Airy, refined, lightweight; uses negative space. Visual weight: light, elegant. Best for screen-only viewing since thin strokes may become hard to read when printed or projected.
+- **`phosphor-duotone`** — **duotone** style; main shape at full opacity plus a backplate of the same color at 20% opacity, producing a soft sense of depth. Visual weight: medium, layered, contemporary.
-> The geometric / weight axes: `chunk-filled` (straight fill) vs. `tabler-filled` (curved fill) vs. `tabler-outline` (stroke) vs. `phosphor-duotone` (single-color duotone with depth).
+> **Two axes to consider when choosing**:
+> 1. **Geometry**: straight lines (`chunk-filled`) vs. curves (`tabler-filled` / `phosphor-duotone`) vs. open strokes (`tabler-outline`)
+> 2. **Visual weight**: heavy solid (`chunk-filled`) → medium solid (`tabler-filled`) → medium layered (`phosphor-duotone`) → light stroke (`tabler-outline`)
**One presentation = one stylistic library.** Pick `chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone` at the start and use it exclusively throughout for generic icons (home, chart, users, etc.). If the chosen library doesn't have an exact icon, find the closest available alternative within that same library — never cross stylistic libraries to fill a gap.
@@ -84,13 +86,4 @@ ls skills/ppt-master/templates/icons/simple-icons/ | grep github
| Tech stack icons on architecture / integration diagrams | Replacing a missing icon in `chunk-filled` / `tabler-*` / `phosphor-duotone` |
| Social media handles in a footer | Decorative / illustrative purposes |
-| Content tone | Recommended library |
-|--------------|---------------------|
-| Tech / engineering / enterprise / data | `chunk-filled` |
-| Lifestyle / health / home / wellness | `tabler-filled` |
-| Light, refined, minimal showcases (screen-only) | `tabler-outline` |
-| Modern SaaS / fintech / product launches — depth without solid weight | `phosphor-duotone` |
-
-> The table above is a reference, not a hard rule. When content tone doesn't cleanly match a row, pick the library whose visual character best serves the deck and document the choice.
-
⚠️ Do **not** mix icons from different **stylistic** libraries (`chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone`). `simple-icons` is the sole exception and may co-exist as a brand-logo inset — see the brand-logo exception above.