html2ppt

name	html2ppt
description	Generate PowerPoint decks from outlines or HTML slide decks; use when the user wants a .pptx, a slide narrative, or an HTML-to-PPT export workflow.

Html2PPT

When To Use

Use this skill when the user asks for a presentation, pitch deck, report deck, workshop deck, or any .pptx output. Prefer the HTML-to-PPT path when layout fidelity matters. Prefer the schema-to-PPT path when PowerPoint editability matters. If the deck needs fresh facts or image leads, research first with SearxNG.

Workflow

1. If the user gives only an outline, first draft the deck as HTML slides.
2. If the user already has HTML, keep it and export it directly.
3. Build each slide as a self-contained .slide block.
4. Choose the source of truth:
   • HTML when browser fidelity matters
   • schema when native PPT editability matters
5. If needed, collect current facts or image leads with scripts/searxng_research.py.
6. Validate the HTML deck against the slide contract before export.
7. Export with scripts/html2ppt.py or scripts/schema2ppt.py.
8. If the deck needs edits, update the HTML, schema, or use scripts/deck_editor.py, then rerun the export.

Rules

• Prefer one idea per slide.
• Keep the canvas fixed at 16:9 unless the user asks otherwise.
• Use local assets and stable relative paths.
• Make text large enough to survive screenshot export.
• Use SVG for charts, icons, and logos when possible.
• Split dense tables and long bullets across slides.
• When users complain that the PPT looks blurry, increase --render-scale or switch to the schema workflow.
• When users want AI to search for references or images, use the SearxNG script rather than ad-hoc scraping.
• Some self-hosted SearxNG instances may need --insecure if the local Python trust store cannot verify their TLS chain.

HTML Contract

• Use section.slide as the slide root.
• Default slide size is 1280x720.
• Design each slide to stand alone as a screenshot.
• Avoid scrollable content, hidden overflow, and hover-only interactions.
• For best results, use explicit CSS variables for colors, spacing, and type scale.

Tooling

• scripts/html2ppt.py renders slide elements with Playwright and writes a .pptx.
• scripts/schema2ppt.py renders a JSON slide schema into native editable PowerPoint objects.
• scripts/deck_editor.py runs a lightweight local editor with preview, validation, save, and export actions.
• scripts/searxng_research.py queries a SearxNG instance and can download image leads into local assets.
• See references/html-slide-contract.md for the recommended HTML structure and authoring pattern.
• See references/schema-slide-contract.md for the native editable schema path.
• See references/searxng-research-workflow.md for the research workflow.