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): lock deck-wide stroke_width for stroke-style libraries

hugohe366361fa085cc
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 55f6a468..5264f4f5 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -130,7 +130,7 @@ Strategist chooses the icon approach and approved inventory. Executor only imple
> ⚠️ **Icon Color Rule**: For `<use data-icon="...">` tags, ALWAYS use `fill="#HEX"` to set the color. NEVER use `stroke` or `fill="none"` on these placeholders, even for stroke-style libraries.
>
-> Optional `stroke-width` on the placeholder (stroke-style libraries only — currently `tabler-outline`): default 2, pass 1.5 for thin, 3 for bold. Ignored on non-stroke libraries (`chunk-filled` / `tabler-filled` / `phosphor-duotone` / `simple-icons`).
+> `stroke-width` on the placeholder (stroke-style libraries only — currently `tabler-outline`): allowed values `1.5` / `2` / `3`. **If `spec_lock.md icons` declares `stroke_width`, every placeholder MUST use that exact value, deck-wide.** If the field is absent (legacy decks), default to `2`. Ignored on non-stroke libraries (`chunk-filled` / `tabler-filled` / `phosphor-duotone` / `simple-icons`). Values outside `{1.5, 2, 3}` are forbidden — heavier weight requires switching library, not thicker strokes.
>
> No need to manually run `embed_icons.py`; `finalize_svg.py` post-processing tool will auto-embed icons.
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index e511fd75..cc8325ee 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -104,6 +104,8 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
> 3. Use the verified filename (without `.svg`) as the icon name
> 4. Always include the library prefix (e.g., `chunk-filled/home` or `tabler-filled/home`)
> 5. List the final icon inventory and chosen library in the Design Spec; Executor may only use icons from this list
+> 6. **Stroke weight lock (stroke-style libraries only)** — when the chosen library is stroke-based (currently `tabler-outline`; applies to any future stroke library too), pick exactly one deck-wide value from `{1.5, 2, 3}` and record it as `stroke_width` in `spec_lock.md icons`. Default is `2`; pick `1.5` for refined / editorial tone, `3` for bolder presence on dense decks. Non-stroke libraries (`chunk-filled` / `tabler-filled` / `phosphor-duotone` / `simple-icons`) ignore this — omit the field entirely.
+> - **Why not `4` or higher?** On Tabler's 24×24 viewBox a 4-px stroke is 1/6 of the icon width — adjacent strokes merge and inner negative space collapses, so the icon stops reading as line art. If you want heavier visual presence, **switch the library** (to `tabler-filled` or `chunk-filled`) instead of fattening the stroke; that is precisely why multiple stylistic libraries exist.
>
> **Do NOT preload any index file** — use `ls | grep` to search on demand with zero token cost.
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index 45955dd4..c2a68a8b 100644
--- a/skills/ppt-master/templates/spec_lock_reference.md
+++ b/skills/ppt-master/templates/spec_lock_reference.md
@@ -56,6 +56,15 @@
- inventory: target, bolt, shield, users, chart-bar, lightbulb
> `library` MUST be one of `chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone` (exactly one — mixing is forbidden). `brand_library: simple-icons` is optional — include it only when the deck genuinely uses company / product / service brand marks; omit the line entirely if no brand icons are needed. `inventory` lists the approved icon names (without library prefix); Executor may only use icons from this list.
+>
+> **`stroke_width` (stroke-style libraries only)** — required when `library` is stroke-based (currently `tabler-outline`); allowed values `1.5` / `2` / `3`. Executor MUST apply this exact value to every `<use data-icon="...">` placeholder via the `stroke-width` attribute, deck-wide. Omit the field for non-stroke libraries (`chunk-filled` / `tabler-filled` / `phosphor-duotone`); it is ignored there. Heavier weight is achieved by switching library, not by going beyond `3` — at 24×24 the strokes would merge and the icon stops reading as line art.
+>
+> Example for stroke-style libraries:
+> ```
+> - library: tabler-outline
+> - stroke_width: 2
+> - inventory: home, chart-bar, users, bulb
+> ```
## images
- cover_bg: images/cover_bg.jpg