jst-well-dan/skill-box

Overview

This skill provides tools and workflows for creating, editing, and analyzing .pptx presentations. It supports full-slide generation from HTML, template-driven assembly, and low-level Office Open XML (OOXML) editing for comments, notes, layouts, and advanced styling. The focus is on predictable visual results, validation, and repeatable conversion steps.

How this skill works

For high-level creation, the skill converts structured HTML slides to PPTX with precise positioning, rasterizes complex visuals, and assembles a final presentation using a JavaScript conversion pipeline. For template use, it inventories template slides, maps content to safe layouts, and duplicates/replaces placeholders. For deep edits or analysis, it unpacks the PPTX ZIP, inspects and modifies OOXML files (slides, notes, comments, themes), validates changes, and repacks the archive.

When to use it

• Create a new presentation from structured content or an HTML slide deck
• Produce presentations that must match a specific template or brand system
• Extract text, comments, speaker notes, or theme details for analysis
• Make programmatic edits to layouts, animations, or master slides via OOXML
• Validate and visually inspect slide thumbnails before final delivery

Best practices

• State your design approach before generating slides and choose a 3–5 color palette that matches topic/brand
• Use only web-safe fonts (Arial, Helvetica, Times New Roman, Georgia, Courier New, Verdana, Tahoma, Trebuchet MS, Impact) for reliable rendering
• Prefer two-column or full-slide layouts for charts and tables; never vertically stack charts under text
• Rasterize gradients and complex icons to PNG before conversion to preserve layout fidelity
• After any OOXML edits, run validation immediately and fix errors before repacking

Example use cases

• Generate a 10-slide product pitch from a supplied outline and HTML templates with consistent branding
• Convert an existing template into a reusable inventory and map client content into matching layouts
• Extract all speaker notes and comments from a PPTX for content review or editing
• Programmatically replace images and update master slide colors across many files in bulk