Kai Html Export

Convert HTML files to PowerPoint slides by detecting slides or capture full-page screenshots as PNG using your system Chrome browser.

Security Scan

The skill's code, dependencies, and runtime instructions line up with its stated purpose (converting HTML to PPTX/PNG) and do not request unrelated credentials or system-wide access.

Purpose & Capability

Name/description ask for HTML→PPTX/PNG conversion and the package only requires Python and browser automation libraries (playwright, python-pptx, BeautifulSoup/lxml) which are appropriate for screenshots, DOM extraction, and assembling PPTX files.

Instruction Scope

SKILL.md and scripts operate on local HTML files (file:// URLs), inject CSS, evaluate JS in page context to extract layout, and take screenshots. This is expected for the task, but it does execute page JS and will load external resources referenced by the HTML (network fetches) — so do not run untrusted HTML, since rendering executes page scripts and requests.

Install Mechanism

There is no arbitrary remote binary download in the repo. Dependencies are standard Python packages (playwright, python-pptx, beautifulsoup4, lxml) and Playwright may optionally download a Chromium runtime if no system browser is available — all typical and traceable installs.

Credentials

The skill requests no environment variables or credentials. The listed dependencies and browser usage are proportional to the described conversion and screenshot functionality.

Persistence & Privilege

Skill is not always-enabled, and does not request elevated privileges or modify other skills or global agent settings. It runs as user-invocable code on demand.

Assessment

This skill appears coherent with its purpose and contains readable Python scripts for screenshotting and PPTX assembly. Before installing or running: (1) Be aware the scripts render HTML in a headless or system Chrome browser and execute page JavaScript — avoid feeding untrusted HTML (it can run scripts and fetch external resources). (2) Playwright may download Chromium if no system browser is found; dependencies are installed via pip. (3) No credentials or secrets are requested by the skill. If you have sensitive network or local files reachable from the HTML, review the HTML and the scripts' use of file:// and page.evaluate first.

Export any HTML file to PPTX or PNG using a headless browser. No Node.js required — uses your existing system Chrome.

Commands

Command	What it does
/kai-html-export [file.html]	Export HTML presentation to PPTX (auto-detects slides)
/kai-html-export --pptx [file.html]	Explicit PPTX export
/kai-html-export --png [file.html]	Full-page screenshot to PNG
/kai-html-export --png --scale 2 [file.html]	2× resolution screenshot

If no file is specified, use the most recently modified .html file in the current directory.

Export to PPTX

Run the bundled script:

python3 <skill-path>/scripts/export-pptx.py <file.html> [output.pptx] [--mode image|native] [--width 1440] [--height 900]

Export Modes

--mode image (default):

• Pixel-perfect screenshots of each slide
• Visual fidelity: ⭐⭐⭐⭐⭐
• Editability: ❌ None (text is rasterized)
• Best for: archiving, sharing final presentations

--mode native (new):

• Editable text, shapes, and tables
• Visual fidelity: ⭐⭐⭐ (simplified gradients, no shadows)
• Editability: ✅ Full text editing
• Best for: collaborative editing, content reuse

Supported in native mode:

• Text (h1-h6, p): font size, color, bold, alignment
• Lists (ul, ol): bullet points
• Tables: editable cells
• Shapes (div with solid background): rectangles
• Images: native insertion

Not supported in native mode (fall back to image):

• CSS gradients → solid color approximation
• Box shadows → omitted
• Custom web fonts → system fonts
• SVG graphics → rasterize to PNG

Export to PNG

Run the bundled script:

python3 <skill-path>/scripts/screenshot.py <file.html> [output.png] [--width 1440] [--scale 2]

• Captures the full page at the specified width
• --scale 2 produces a 2× retina-quality image
• Useful for sharing reports or single-page HTML as images

Dependencies

Package	Purpose	Install
playwright	Headless browser screenshots	pip install playwright
python-pptx	Assemble screenshots into PPTX	pip install python-pptx

No browser download needed if Chrome, Edge, or Brave is already installed.

Works with any HTML

Designed to work with output from:

• kai-slide-creator — HTML presentations with .slide elements
• kai-report-creator — Single-page HTML reports
• Any self-contained HTML file