English | 简体中文
Turn a course topic, source files, and a reference PPT style into an image2-first classroom PPT image workflow:
- sourced slide outline
- per-page image2 prompts
- high-quality PPT page images generated with image2 or another raster image model
- contact-sheet QA
- PPTX wrapper created by inserting the final images
- timed presentation script
- revision notes from user feedback
This is a Codex skill for students, teachers, researchers, and anyone who needs to make a polished lecture-style or report-style PPT from messy materials.
The core idea is simple:
source files + reference PPT style
-> image2-ready per-page prompts
-> generated 16:9 PPT page images
-> contact sheet QA
-> targeted fixes only if QA fails or user asks
-> insert final images into a full-bleed PPTX wrapper
-> timed speaking script
The helper scripts do not replace image2. They help after image generation: checking the image set and inserting final PNG/JPG page images into a .pptx wrapper.
The skill is designed for one-pass delivery for non-expert users. Codex should deliver a complete usable version by default, then make targeted fixes only if QA fails or the user asks:
- Content-rich gate: avoid thin pages by requiring claims, source-backed points, and meaningful page structures.
- Style-lock gate: lock the visual system before generating the full deck so pages do not drift.
- Cleanup QA gate: remove meaningless marks, random icons, fake labels, unrequested Q&A, and decorative elements that do not support the report.
Before it starts, the skill runs a bounded grill-me-style intake. It inspects provided materials first, tracks missing requirements as open decision branches, asks only 1-3 missing questions per batch, then records assumptions, open risks, and confidence before starting the one-pass build.
Most AI PPT workflows stop too early:
- They summarize the source.
- They generate a few pretty slides.
- They leave the user to fix structure, visual consistency, citations, and the speaking script.
ppt-image-share-builder packages a fuller workflow:
flowchart LR
A["Topic + source files"] --> B["Extract and verify source facts"]
B --> C["Audit reference PPT style"]
C --> D["Build narrative spine"]
D --> E["Create style lock + image2 prompts"]
E --> F["Generate full PPT image set"]
F --> G["Contact-sheet QA + targeted fixes"]
G --> H["Insert final images into PPTX"]
H --> I["Write timed talk script"]
The skill is especially useful when the user has:
- a course topic
- a textbook excerpt or
.docx - pasted notes
- government/regulatory source material
- a sample PPT whose style should be followed
- a target speaking duration such as 8-10 minutes
Typical output:
<topic>_image2逐页大纲.md
<topic>_10分钟汇报稿.md
<topic>.pptx
outputs/<topic-slug>-images/
slide-01-cover.png
slide-02-contents.png
...
slide-13-closing.png
contact-sheet-13-slides.jpg
The exact filenames can be adapted to the project language and topic.
The repository now includes a real end-to-end demo run: Medical Device Flight Check. It uses public regulatory inspection cases plus a desensitized classroom source extract, turns the content into image2-ready page prompts, uses image2-generated full-page PPT images as the visual source of truth, checks the result with a contact sheet, and wraps the final image set in PPTX.
The older Campus Lab Safety Risk Inspection example remains as a privacy-safe synthetic fallback, but it is no longer the primary preview.
If your Codex environment includes the built-in skill installer, use:
Windows PowerShell:
python "$env:USERPROFILE\.codex\skills\.system\skill-installer\scripts\install-skill-from-github.py" --repo uuoov/ppt-image-share-builder --path . --name ppt-image-share-buildermacOS / Linux:
python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo uuoov/ppt-image-share-builder --path . --name ppt-image-share-builderRestart Codex so it loads the new skill metadata.
Clone this repository directly into your Codex skills directory.
Windows PowerShell:
git clone https://github.com/uuoov/ppt-image-share-builder.git "$env:USERPROFILE\.codex\skills\ppt-image-share-builder"macOS / Linux:
git clone https://github.com/uuoov/ppt-image-share-builder.git ~/.codex/skills/ppt-image-share-builderYou can also download the latest release ZIP from GitHub Releases.
If you are editing the skill locally, clone it anywhere and symlink or copy the folder into your Codex skills directory.
Invoke the skill explicitly:
Use $ppt-image-share-builder to turn my course topic, source files, and reference PPT style into image2 page prompts, generated PPT page images, a PPTX wrapper, and a 10-minute presentation script.
A strong request usually includes:
Topic: <your sharing topic>
Audience: <class / teacher / meeting>
Duration: <8-10 minutes>
Reference PPT: <path to sample PPT or style example>
Sources: <docx/pdf/txt/web links>
Required keywords: <terms that must appear>
Output: image2 prompts + PPT page images + PPTX wrapper + script
Use $ppt-image-share-builder.
I need a 10-minute classroom report about a regulation topic.
I have a reference PPT in the current folder and a textbook excerpt as a .docx file.
Please:
1. extract the source material,
2. audit the reference PPT style,
3. create a 12-14 page image2 outline,
4. create a style lock so all pages stay visually consistent,
5. generate the full PPT page image set,
6. create a contact sheet and fix only pages that fail QA,
7. insert the final images into PPTX,
8. write the final talk script.
The commands below are PowerShell-safe. On Windows PowerShell 5.x, run multi-step commands on separate lines instead of joining them with &&.
Install optional script dependencies first:
python -m pip install -r requirements.txtAfter image2 has generated numbered PPT page images, create a contact sheet:
python scripts/make_contact_sheet.py --input-dir examples/medical-device-flight-check/images -o examples/medical-device-flight-check/contact-sheet-demo.jpgRegenerate the privacy-safe synthetic fallback demo and refresh README preview assets. If the medical-device demo exists, top-level preview assets are refreshed from that primary demo instead of the synthetic placeholders:
python scripts/create_demo_assets.pyInsert final image2-generated PPT page images into a full-bleed PPTX wrapper:
python scripts/images_to_pptx.py --input-dir examples/medical-device-flight-check/images -o examples/medical-device-flight-check/demo-deck.pptxThe default goal is one complete delivery, not staged approval.
When a user says the first version is too simple, the skill should add content depth before regenerating: stronger claims, cases, source-backed points, and richer diagrams.
When a user says revised pages look inconsistent, the skill should write a style lock and reuse it in every subsequent page prompt.
When a user says the final pages include meaningless marks or strange symbols, the skill should run final cleanup QA and regenerate only the affected pages.
The skill follows these stages:
-
Run grill-me style intake Inspect provided materials first, close essential decision branches, ask only the missing requirements, then summarize assumptions and proceed.
-
Extract and normalize sources
Chinese.docx,.txt,.csv, and government-style documents are normalized before analysis. The skill warns against Windows PowerShell path-encoding pitfalls. -
Audit reference PPT style
It extracts slide rhythm, title style, colors, fonts, page markers, chart/table style, and image language. -
Build the narrative spine
It creates slide claims rather than just topic labels. -
Write image prompts
It creates one unified visual prompt plus per-page prompts with required text and composition. -
Generate and save PPT page images with image2
It generates the full planned image set by default, then saves stable numbered files. Treat these images as the visual source of truth. -
QA with contact sheets
It checks slide count, visible text, page numbers, duplicate variants, style consistency, and meaningless elements. It should fix failed pages before delivery when possible. -
Insert images into PPTX
It inserts the final images as full-bleed pages, so the PPTX wrapper preserves the image2 visual design. -
Write the timed script
It writes a report script that adds spoken bridges and supporting cases instead of just reading the slides.
ppt-image-share-builder/
SKILL.md
README.md
README.zh-CN.md
agents/
openai.yaml
assets/
hero-contact-sheet.jpg
demo.gif
social-preview.jpg
examples/
medical-device-flight-check/
input-notes.md
report-content.md
image2-outline.md
contact-sheet-demo.jpg
demo-deck.pptx
10-minute-script.md
images/
lab-safety-check/
input-notes.md
image2-outline.md
contact-sheet-demo.jpg
10-minute-script.md
references/
intake-grillme.md
workflow-checklist.md
iteration-playbook.md
prompt-patterns.md
qa-checklist.md
scripts/
create_demo_assets.py
make_contact_sheet.py
images_to_pptx.py
requirements.txt
- Source-backed first: facts, laws, dates, statistics, and cases should be tied to source notes.
- Reference-style aware: generated slides should match the user's existing PPT language.
- Bounded intake before work: inspect materials, close missing decision branches, then deliver a complete first version by default.
- Chinese text aware: keep generated Chinese text short enough to inspect and fix.
- Private by default: do not publish user textbooks, generated course files, personal names, or classroom materials unless the user explicitly asks.
This is a focused skill for image2-first classroom and report-style presentation workflows. It is meant for:
- turning source material into image2-ready slide prompts
- generating polished 16:9 PPT page images
- checking the whole image set with a contact sheet
- inserting the final images into a PPTX wrapper
- writing a timed speaking script
- Real medical-device flight-check demo with image2 full-page visuals, source-backed report content, contact-sheet QA, PPTX wrapper, and talk script.
- Privacy-safe synthetic fallback demo for public examples that must avoid regulatory or classroom specifics.
- Contact sheet generator for quick QA after image2 generation.
- PPTX wrapper helper that inserts image2-generated page images without stretching them.
- README preview image, animated GIF, and social-preview asset.
- Release ZIP for manual download.
- PowerShell-safe command examples for Windows users.
- Use Issues for bugs, install problems, or script failures.
- Use Discussions for demo ideas, classroom use cases, and prompt-pattern feedback.
MIT. See LICENSE.