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)

1. ppt_coordinator — takes the source report/manuscript + audience/length, runs the flow, returns the .pptx + a slide-by-slide summary.
2. 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.
3. 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.
4. figure_placer — selects figures/tables from the source (or calls food-figure) and maps them to slides as editable picture objects / native tables.
5. deck_builder — assembles the deck-spec JSON (references/deck-spec.md) and runs python3 scripts/build_pptx.py <spec>.json --out <deck>.pptx.
6. 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.