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.mdindex 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.pyindex 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/githubDependencies:None (standard library only).@@ -38,6 +35,12 @@ from console_encoding import configure_utf8_stdioconfigure_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 1return 0diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.mdindex 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 librariesThis 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