Food-Ppt — Editable Presentations from Food & Nutrition Reports
Turn a review report, evidence brief, or manuscript into a fully editable
.pptx — every title, bullet, table, and figure is a native PowerPoint object the
author can edit, never a flattened image. Original work; the schema→builder→QA
architecture and design sensibility are informed by the open-source (MIT) ppt-master,
GordenPPTSkill, and codex-ppt-skill skills and the taste-skill and
ui-ux-pro-max-skill design guides (see the repo README Acknowledgements). No
third-party templates are bundled.
What it converts
The outputs of the suite's other skills, or any report/paper the user supplies:
food-review panel report / Review & Response Report → a review-findings deck.
food-research / food-deep-research evidence brief or literature review → a
synthesis deck.
food-paper manuscript (or sections) → a paper-presentation / journal-club deck.
food-pipeline — offered at FINALIZE to package the finished work as slides.
Required content for a proposal / paper deck
- Experimental-design flow diagram — a
flow slide near the front, built from
food-figure's blueprint (experimental-flow.md) and rendered as native,
movable PowerPoint shapes (one box per step, one arrow per transition — never a
flattened image), so the audience grasps the design at a glance. Mandatory for
any deck from a research proposal or research paper.
- Results slides illustrate the result — each is a
result slide: a
figure (from food-figure, theme-matched) where feasible, or a scientific
table when the numbers are the point, plus a Key findings panel of takeaways.
- Big numbers and parallel facts get their own design — a single striking figure
goes on a
metric big-number hero; a set of parallel facts (objectives,
contributions, study parameters, KPIs) goes on a cards accent-bar grid, not a
bullet list (references/slide-design.md).
- Executive summary — a closing summary slide is required in every deck.
- Theme-matched figures — figures use the deck theme's palette so they match the
slides.
Editable-first (non-negotiable) — references/editability-and-qa.md
Build with python-pptx so the deck is genuinely editable: real text frames
for titles/bullets, native tables (editable cells) for data, and figures placed as
movable/resizable picture objects. Never render a slide to a background image,
never bake text into a picture, never deliver a PDF in place of a .pptx. If a figure
exists only as a raster, embed it as a picture object (still movable/replaceable) and
say so; prefer a vector/redrawable source where available.
Subagents (dispatch via the Agent tool)
ppt_coordinator — takes the source report/manuscript + audience/length, runs the flow, returns the .pptx + a slide-by-slide summary.
outline_planner — reads the source and builds the slide outline (references/source-to-slides.md): one idea per slide, a clear narrative arc, target slide count for the audience.
slide_writer — writes concise, grounded slide text (bullets ≤ ~1 line each), speaker notes carrying the detail; every claim/number traces to the source — no new facts, no invented data.
figure_placer — selects figures/tables from the source (or calls food-figure) and maps them to slides as editable picture objects / native tables.
deck_builder — assembles the deck-spec JSON (references/deck-spec.md) and runs python3 scripts/build_pptx.py <spec>.json --out <deck>.pptx.
deck_qa — verifies editability, checks text overflow / slide density, and confirms every slide's content is faithful to the source (references/editability-and-qa.md).
Templates & design (references/templates.md, references/slide-design.md)
Pick one of 17 editable themes — slate (default) · sage · burgundy · teal · graphite
· ocean · terracotta · forest · consulting · dashboard · azure · geometric · indigo ·
scholar · claret · apricot · midnight (a dark theme) — with the deck-spec "theme"
field (catalog: templates/INDEX.md; preview: templates/theme-previews.svg). Most
recreate the look of the open-source GordenPPTSkill gallery (in English) as original
theme definitions; midnight recreates a Grok-generated dark deck. ppt_coordinator
auto-picks a theme from the deck's text via scripts/suggest_theme.py and offers the
top few as options for the user to choose. A theme is a palette +
type + layout style (cover brand bar + side panel, full-bleed section dividers, accent
edge stripe, underlined titles, big-number heroes, accent-bar cards, footer + slide
numbers, styled tables) applied as editable shapes — no bundled template files,
nothing flattened. ppt_coordinator chooses the theme from topic/audience or asks.
Restrained academic look informed by taste-skill and ui-ux-pro-max-skill: a real
type scale (strong size + weight contrast), one accent + ink/greys, whitespace, one idea
per slide, and layout variety — never the templated "AI deck" look.
Grounding & privacy (inherited)
Slides are only as true as the source — never add a finding, number, or citation
that isn't in it (food-paper/references/faithfulness-and-citation.md). Apply the
academic-style + human-writing.md pairing to slide prose. Run
scripts/privacy_scan.py on the deliverable; keep the mandatory AI-use disclosure
on a closing slide when the deck presents AI-assisted work.
Requirements
python-pptx (pip install python-pptx). Figures come from the source or food-figure.
1---2name: food-ppt3description: Turn a food & nutrition review report, evidence brief, or manuscript into a fully EDITABLE PowerPoint (.pptx) that opens in PowerPoint / Keynote / Google Slides with every title, bullet, table, and figure as a native editable object — nothing flattened to an image. Converts the outputs of food-research, food-deep-research, food-paper, and food-pipeline (or any Word/PDF/Markdown/txt source) into a well-designed deck: it plans the outline, writes concise grounded slide text with presenter notes on every slide, places figures as movable picture objects, builds the .pptx via python-pptx, and QA-checks editability. Design informed by taste-skill. Use to make slides, a presentation, a PPT, or a deck from a report or paper. Triggers: make a PPT, create slides, presentation from my report, turn this review into slides, build a deck, PPTX from my paper, journal-club slides, conference presentation.4---56# Food-Ppt — Editable Presentations from Food & Nutrition Reports78Turn a **review report, evidence brief, or manuscript** into a **fully editable9`.pptx`** — every title, bullet, table, and figure is a **native PowerPoint object the10author can edit**, never a flattened image. Original work; the schema→builder→QA11architecture and design sensibility are informed by the open-source (MIT) `ppt-master`,12`GordenPPTSkill`, and `codex-ppt-skill` skills and the `taste-skill` and13`ui-ux-pro-max-skill` design guides (see the repo README Acknowledgements). No14third-party templates are bundled.1516## What it converts17The outputs of the suite's other skills, or any report/paper the user supplies:18- **`food-review`** panel report / Review & Response Report → a review-findings deck.19- **`food-research` / `food-deep-research`** evidence brief or literature review → a20 synthesis deck.21- **`food-paper`** manuscript (or sections) → a paper-presentation / journal-club deck.22- **`food-pipeline`** — offered at FINALIZE to package the finished work as slides.2324## Required content for a proposal / paper deck25- **Experimental-design flow diagram** — a **`flow`** slide near the front, built from26 **`food-figure`**'s blueprint (`experimental-flow.md`) and rendered as **native,27 movable PowerPoint shapes** (one box per step, one arrow per transition — never a28 flattened image), so the audience grasps the design at a glance. **Mandatory** for29 any deck from a research proposal or research paper.30- **Results slides illustrate the result** — each is a **`result`** slide: a31 **figure** (from `food-figure`, theme-matched) where feasible, or a **scientific32 table** when the numbers are the point, **plus a Key findings** panel of takeaways.33- **Big numbers and parallel facts get their own design** — a single striking figure34 goes on a **`metric`** big-number hero; a set of parallel facts (objectives,35 contributions, study parameters, KPIs) goes on a **`cards`** accent-bar grid, not a36 bullet list (`references/slide-design.md`).37- **Executive summary** — a closing summary slide is **required** in every deck.38- **Theme-matched figures** — figures use the deck theme's palette so they match the39 slides.4041## Editable-first (non-negotiable) — `references/editability-and-qa.md`42Build with **python-pptx** so the deck is genuinely editable: **real text frames**43for titles/bullets, **native tables** (editable cells) for data, and figures placed as44**movable/resizable picture objects**. **Never** render a slide to a background image,45never bake text into a picture, never deliver a PDF in place of a `.pptx`. If a figure46exists only as a raster, embed it as a picture object (still movable/replaceable) and47say so; prefer a vector/redrawable source where available.4849## Subagents (dispatch via the Agent tool)501. **`ppt_coordinator`** — takes the source report/manuscript + audience/length, runs the flow, returns the `.pptx` + a slide-by-slide summary.512. **`outline_planner`** — reads the source and builds the **slide outline** (`references/source-to-slides.md`): one idea per slide, a clear narrative arc, target slide count for the audience.523. **`slide_writer`** — writes concise, **grounded** slide text (bullets ≤ ~1 line each), speaker notes carrying the detail; every claim/number traces to the source — no new facts, no invented data.534. **`figure_placer`** — selects figures/tables from the source (or calls **`food-figure`**) and maps them to slides as editable picture objects / native tables.545. **`deck_builder`** — assembles the **deck-spec JSON** (`references/deck-spec.md`) and runs **`python3 scripts/build_pptx.py <spec>.json --out <deck>.pptx`**.556. **`deck_qa`** — verifies editability, checks text overflow / slide density, and confirms every slide's content is faithful to the source (`references/editability-and-qa.md`).5657## Templates & design (`references/templates.md`, `references/slide-design.md`)58**Pick one of 17 editable themes** — slate (default) · sage · burgundy · teal · graphite59· ocean · terracotta · forest · consulting · dashboard · azure · geometric · indigo ·60scholar · claret · apricot · **midnight** (a dark theme) — with the deck-spec `"theme"`61field (catalog: `templates/INDEX.md`; preview: `templates/theme-previews.svg`). Most62recreate the look of the open-source `GordenPPTSkill` gallery (in English) as original63theme definitions; `midnight` recreates a Grok-generated dark deck. **`ppt_coordinator`64auto-picks a theme from the deck's text via `scripts/suggest_theme.py` and offers the65top few as options** for the user to choose. A theme is a palette +66type + layout style (cover brand bar + side panel, full-bleed section dividers, accent67edge stripe, underlined titles, big-number heroes, accent-bar cards, footer + slide68numbers, styled tables) applied as **editable shapes** — no bundled template files,69nothing flattened. `ppt_coordinator` chooses the theme from topic/audience or asks.70Restrained academic look informed by `taste-skill` and `ui-ux-pro-max-skill`: a real71type scale (strong size + weight contrast), one accent + ink/greys, whitespace, one idea72per slide, and layout variety — never the templated "AI deck" look.7374## Grounding & privacy (inherited)75Slides are **only** as true as the source — never add a finding, number, or citation76that isn't in it (`food-paper/references/faithfulness-and-citation.md`). Apply the77academic-style + `human-writing.md` pairing to slide prose. Run78`scripts/privacy_scan.py` on the deliverable; keep the mandatory **AI-use disclosure**79on a closing slide when the deck presents AI-assisted work.8081## Requirements82`python-pptx` (`pip install python-pptx`). Figures come from the source or `food-figure`.