html-slide-to-pptx

Convert structured HTML slides into editable PPTX files with native text boxes and shapes.

636|68|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/mucsbr/ppt-agent-workflow-san --skill html-slide-to-pptx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: html-slide-to-pptx
Source: https://github.com/mucsbr/ppt-agent-workflow-san/tree/main/html-slide-to-pptx
Command: npx skills add https://github.com/mucsbr/ppt-agent-workflow-san --skill html-slide-to-pptx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cheerio, pptxgenjs, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Turning an HTML slide design into a PowerPoint file usually means pasting screenshots that cannot be edited. This Skill parses structured HTML slides into a semantic model and rebuilds them as native PowerPoint text boxes, shapes, chips, arrows, and panels, so every element stays editable.

Core Features & Use Cases

  • Preset-driven conversion: Maps known slide families (v9-architecture, ai-runtime-page) from HTML into native PPTX objects using cheerio for DOM extraction and pptxgenjs for rendering.
  • Automatic layout fitting: Computes font sizes and box heights per text block to reduce overflow, then runs a preflight QA script that flags spacing and overflow risks with severity levels.
  • Extensible preset system: When HTML does not match an existing slide family, you add a new preset covering DOM extraction, layout mapping, and QA rules instead of forcing arbitrary CSS through.
  • Use Case: You have an analyst-style architecture page designed in HTML and need an editable .pptx for a client deck. Run the converter with the matching preset, review the QA report, and iterate until spacing looks right.

Quick Start

Ask the agent to convert your HTML slide file into an editable PPTX using the matching preset, then run the preflight QA check on the dumped model.

Frequently Asked Questions about html-slide-to-pptx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an HTML slide to an editable PPTX file?

Run node scripts/html_to_pptx.js with your input HTML, output path, and a preset flag such as --preset=v9-architecture. The script parses the HTML into a semantic model and renders native PowerPoint shapes and text boxes via pptxgenjs.

What HTML slide structures does this converter support?

It currently supports two presets: v9-architecture for layered architecture pages with driver and judgement panels, and ai-runtime-page for runtime diagrams with module rows and chip rows. Other structures require adding a new preset first.

Does HTML to PPTX conversion require Chrome or LibreOffice?

No. The core conversion only needs Node.js 18+ with the cheerio and pptxgenjs npm dependencies installed. It does not use a browser renderer, Playwright, Python, or LibreOffice.

Why does my converted PPTX have text overflow or spacing issues?

Fixed-size boxes can overflow when source text is longer than expected. Run scripts/preflight_qa.js on the dumped model to get per-block overflow and spacing checks with severity ratings, then adjust the preset layout mapping.

Can I convert any arbitrary HTML page to PowerPoint with this?

No. It is a preset-driven converter, not a generic HTML/CSS renderer. If your HTML belongs to a new slide family, you must add a new preset covering DOM extraction, layout mapping, and QA rules before converting.