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

fix(icons): streamline strategist selection and enforce library boundaries

hugohe3ca8ce72e2279
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 6f0c8ff1..f5696b6c 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -180,7 +180,7 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
> **Mandatory rules when choosing C**:
>
-> **At the Strategist confirmation stage — decide the library only. Do NOT run `ls | grep` yet.**
+> **At the Strategist confirmation stage — decide the library and stroke only; resolve and sync filenames after approval.**
>
> 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
@@ -193,15 +193,15 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre
>
> **After the Strategist confirmation stage is approved — when writing `design_spec.md` §VI / `spec_lock.md`**, then materialize the icon inventory:
>
-> 3. Enumerate the concepts the deck actually needs (home, chart, users, …) based on the confirmed outline.
-> 4. Search for each concept's filename in the chosen library: `ls skills/ppt-master/templates/icons/<chosen-library>/ | grep <keyword>`
-> 5. Use the verified filename (without `.svg`) as the icon name; always include the library prefix (e.g., `chunk-filled/home`). Icon identifiers are case-sensitive: bundled-library basenames are lowercase and MUST be copied exactly (`tabler-outline/award`, never `tabler-outline/Award`). Do not rely on downstream lowercasing; custom icons preserve their file's exact case.
-> 6. **Copy each chosen icon into the project as you confirm it** — `python3 skills/ppt-master/scripts/icon_sync.py <project_path> <lib/name> [<lib/name> …]`. This populates `<project>/icons/<lib>/` (the set the Executor embeds from) and, more importantly, **validates existence on the spot**.
-> 7. List the final icon inventory and chosen library in `design_spec.md` §VI; record the same in `spec_lock.md icons` (including `stroke_width` for stroke-style libraries). Executor may only use icons from this list.
+> 3. Enumerate only the concepts required by the confirmed outline.
+> 4. Put known basenames in the final batch. For an uncertain one, search the chosen style library — or `simple-icons` for a real brand mark — with `rg --files "skills/ppt-master/templates/icons/<library>" -g '*<keyword>*.svg'`; do not enumerate broad keyword families.
+> 5. **Copy and validate in one batch** — run `python3 skills/ppt-master/scripts/icon_sync.py <project_path> <lib/name> [<lib/name> …]`. This both validates and materializes `<project>/icons/<lib>/`; skip per-file prechecks.
+> 6. Keep each successful, case-sensitive `lib/name`: bundled basenames are lowercase (`tabler-outline/award`, never `tabler-outline/Award`); custom icons retain exact case.
+> 7. Record the successful inventory, library, and stroke-library `stroke_width` in `design_spec.md` §VI and `spec_lock.md icons`. Executor may use only this list.
>
-> 🚧 **GATE — missing icon = re-pick now**: if `icon_sync.py` reports any name as missing (non-zero exit), that icon is not in the library — re-pick a real filename via `ls … | grep`, fix `§VI` / `spec_lock.md`, and re-run until it exits clean. Never carry a missing icon forward to generation. Over-copying candidates is harmless — finalize embeds only the icons actually referenced by `<use data-icon>`.
+> 🚧 **GATE — missing icon = re-pick now**: on non-zero exit, search only the missing concept in the chosen library, re-pick, and rerun the final batch until clean. Never carry a missing icon forward or switch stylistic libraries to fill the gap.
>
-> **Do NOT preload any index file** — when the inventory step arrives, use `ls | grep` to search on demand with zero token cost.
+> **Default — targeted lookup only**: do not load or rebuild a full index; search only unresolved concepts.
### g. Typography Plan Confirmation (Font + Size)
diff --git a/skills/ppt-master/scripts/icon_sync.py b/skills/ppt-master/scripts/icon_sync.py
index 2b88b198..34c5ca72 100644
--- a/skills/ppt-master/scripts/icon_sync.py
+++ b/skills/ppt-master/scripts/icon_sync.py
@@ -2,22 +2,19 @@
"""
PPT Master - Icon Sync
-Copy chosen library icons into a project's own `icons/` folder at the moment they
-are selected. Run it with the icon names you are picking; each is copied from the
-global library into `<project>/icons/<lib>/`. Any name the library does not have
-is reported on the spot and the command exits non-zero — so you re-pick a valid
-icon then, not at export time. Over-copying candidates is fine: finalize only
-embeds the icons actually referenced by `<use data-icon>`, the rest sit unused.
+Copy chosen library icons into `<project>/icons/<lib>/` when selected. Missing
+names exit non-zero before export. Known basenames need no separate existence
+check; search the chosen library only for unresolved concepts.
-Custom icons you place in `<project>/icons/<lib>/` yourself are honored too — a
-name already present in the project is treated as satisfied, not missing.
+Project-local custom icons count as satisfied. `simple-icons` may accompany one
+stylistic library only for real brand marks.
Usage:
python3 scripts/icon_sync.py <project_path> <lib/name> [<lib/name> ...]
Examples:
- python3 scripts/icon_sync.py projects/deck chunk-filled/home tabler-outline/chart
- python3 scripts/icon_sync.py projects/deck simple-icons/github
+ python3 scripts/icon_sync.py projects/deck tabler-outline/home tabler-outline/chart
+ python3 scripts/icon_sync.py projects/deck tabler-outline/home simple-icons/github
Dependencies:
None (standard library only).
@@ -38,6 +35,12 @@ from console_encoding import configure_utf8_stdio
configure_utf8_stdio()
_LIB_ALIASES = {"chunk": "chunk-filled"}
+_STYLISTIC_LIBRARIES = {
+ "chunk-filled",
+ "phosphor-duotone",
+ "tabler-filled",
+ "tabler-outline",
+}
_GLOBAL_ICONS_DIR = Path(__file__).resolve().parent.parent / "templates" / "icons"
@@ -93,6 +96,19 @@ def main(argv: Optional[list[str]] = None) -> int:
print(f"[ERROR] project not found: {project}", file=sys.stderr)
return 1
+ requested_libraries = {_split_name(raw)[0] for raw in args.icons}
+ stylistic_libraries = sorted(requested_libraries & _STYLISTIC_LIBRARIES)
+ if len(stylistic_libraries) > 1:
+ print(
+ f"[ERROR] mixed stylistic icon libraries: {', '.join(stylistic_libraries)}",
+ file=sys.stderr,
+ )
+ print(
+ "Choose one stylistic library per deck; simple-icons may coexist for real brand marks.",
+ file=sys.stderr,
+ )
+ return 1
+
copied, missing = sync_icons(project, args.icons)
if copied:
@@ -104,7 +120,10 @@ def main(argv: Optional[list[str]] = None) -> int:
print(f"\n[MISSING] {len(missing)} icon(s) not in the library — re-pick before continuing:", file=sys.stderr)
for m in missing:
lib = m.split("/", 1)[0]
- print(f" ✗ {m} (search: ls {_GLOBAL_ICONS_DIR}/{lib}/ | grep <keyword>)", file=sys.stderr)
+ print(
+ f' ✗ {m} (search: rg --files "{_GLOBAL_ICONS_DIR / lib}" -g \'*<keyword>*.svg\')',
+ file=sys.stderr,
+ )
return 1
return 0
diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.md
index 436c5afe..753a1d13 100644
--- a/skills/ppt-master/templates/icons/README.md
+++ b/skills/ppt-master/templates/icons/README.md
@@ -19,10 +19,10 @@ This directory provides **11,600+ high-quality SVG icons** across five libraries
This directory is the **global library**. At selection time the Strategist copies the chosen icons into the deck's own `<project>/icons/<lib>/` with `icon_sync.py`:
```bash
-python3 skills/ppt-master/scripts/icon_sync.py <project_path> chunk-filled/home tabler-outline/bulb
+python3 skills/ppt-master/scripts/icon_sync.py <project_path> tabler-outline/home tabler-outline/bulb simple-icons/github
```
-A name the library does not have is reported and the command exits non-zero — re-pick a real one then, not at export. `finalize_svg.py embed-icons` embeds **project-first** (from `<project>/icons/`), falling back to this global library per-icon.
+Missing names and batches that mix stylistic libraries exit non-zero; `simple-icons` may coexist for real brand marks. `finalize_svg.py embed-icons` embeds **project-first** from `<project>/icons/`, with per-icon global fallback.
**Custom icons**: drop your own `.svg` into `<project>/icons/<lib>/` (any `<lib>`, e.g. `custom/`) and reference it as `data-icon="<lib>/<name>"` — it embeds like any library icon.
@@ -71,16 +71,17 @@ python3 scripts/svg_finalize/embed_icons.py svg_output/*.svg
## Searching for Icons
-Use `ls | grep` — zero token cost:
+For a known basename, run `icon_sync.py` directly; it copies and validates without a per-file precheck.
+
+For an uncertain basename, search only the chosen stylistic library; use `simple-icons` only for a real brand mark:
```bash
-ls skills/ppt-master/templates/icons/chunk-filled/ | grep home
-ls skills/ppt-master/templates/icons/tabler-filled/ | grep home
-ls skills/ppt-master/templates/icons/tabler-outline/ | grep chart
-ls skills/ppt-master/templates/icons/phosphor-duotone/ | grep house
-ls skills/ppt-master/templates/icons/simple-icons/ | grep github
+rg --files "skills/ppt-master/templates/icons/tabler-outline" -g '*chart*.svg'
+rg --files "skills/ppt-master/templates/icons/simple-icons" -g '*github*.svg'
```
+Do not load a full index or enumerate broad keyword families. Re-pick from the narrow result and rerun the final batch until clean; never switch stylistic libraries for a missing generic icon.
+
---
## Style Rules