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(quick): read the signals the scripts already emit

hugohe332e3eb766e00
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 5afcb896..3ba4f1e7 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -188,6 +188,14 @@ python3 ${SKILL_DIR}/scripts/project_manager.py import-sources \
[projects/<research_slug>.md projects/<research_slug>.facts.json]
```
+**✅ Checkpoint — every named input landed**: `import-sources` exits 0 as long
+as one input produced a usable artifact, so a partially failed batch still
+succeeds. Read the printed `skipped` reasons before continuing. An entry skipped
+because equivalent content already exists is benign; `path not found`, a failed
+conversion, or no usable Markdown means that source is absent. Re-import or
+supply a converted equivalent for each absent source, or state why the deck
+proceeds without it.
+
The facts JSON is the sole URL authority, not a download queue.
`project_manager.py` imports it as an ordinary file and never expands its
`source_url` values. If normal web-image search is exhausted, follow
@@ -327,6 +335,12 @@ content requires a clean full-canvas base plus registered RGBA cutout
a floating cutout may use `#A2-01`. Finish assets before SVG per
[`image-base.md`](../../references/image-base.md) §2–3.
+**Prepared derivative**: create it with `image_treat.py` (blur,
+desaturation/grayscale, duotone, brightness, contrast) under a name separate
+from its source. The canonical file stays intact: a derivative never overwrites
+its source, never becomes another derivative's parent, and never has its output
+equal its input. Derive only after that source is itself final.
+
**Mandatory — whole-roster rhythm check**: During the same active-context
resolution, compare neighbors and section arcs to judge whether chapter entries
visibly reset, extended same-density runs are intentional, extended repetitions
@@ -703,6 +717,12 @@ roster. Then run:
python3 ${SKILL_DIR}/scripts/total_md_split.py <project_path>
```
+**Success criterion**: per-slide Markdown files exist under
+`<project_path>/notes/` and cover every published slide. The command exits
+non-zero when a slide has no notes or a write fails; repair `notes/total.md` and
+rerun before animations or export, and never let leftover files from an earlier
+run satisfy this criterion.
+
Run [`customize-animations`](../stages/customize-animations.md) after that notes
pass when the active-context outcome or an existing sidecar triggers it. Resolve
deck-wide-only motion through the selected exporter flags instead.