mpuig/agent-slides
4 skills558 installs36 starsGitHub
Install
npx skills add https://github.com/mpuig/agent-slidesSkills in this repo
1Slides Critiqueslides-critique is a presentation storytelling skill in the mpuig/agent-slides toolkit for reviewing output.pptx decks against Pyramid Principle, SCQA, and action-title criteria. The skill requires Python 3.12+ and uv, reads deck content via uvx agent-slides slides inspect, cross-references slides.json plans and design-profile.json palettes, and scores seven dimensions: action titles, narrative flow, isomorphism, visual hierarchy, content density, layout variety, and parallel structure. Developers reach for slides-critique after slides-build when a deck is technically valid but unconvincing, or when slide titles read as topic labels instead of claims. The workflow produces a critique report with positives, a scorecard, provocative questions, auto-applied text fixes via slides edit, and structural fixes via critique-fixes.json, then re-runs slides qa.151installs2Slides Polishslides-polish is a presentation QA skill from mpuig/agent-slides that performs the finishing pass on agent-generated PowerPoint decks without rewriting slide content or fixing technical lint handled by slides-audit and slides-critique. It requires Python 3.12+, uv, an output.pptx deck, and design-profile.json for palette and font constraints, with optional slides.json for plan context. The seven-step process assesses existing polish scope, inspects the deck via uvx agent-slides slides inspect, checks structural completeness (title, disclaimer, end slides, section dividers for decks over eight content slides), adds missing speaker notes and 9–10pt source lines on data slides, sets document metadata, enforces no more than four distinct font sizes, applies fixes through polish-fixes.json, and runs slides qa to produce qa.json. It delivers a structured polish report acknowledging what was already good plus changes made. Reach for slides-polish when a deck is content-complete and needs professional completeness before sending to executives or presenting live.144installs3Slides Extractslides-extract is an mpuig/agent-slides skill—one of seven slides skills—that extracts structured contracts from PowerPoint templates before automated deck building. It requires Python 3.12+ and uv, runs `uvx --from agent-slides slides extract <template.pptx> --output-dir`, and produces template_layout.json, content_layout.json, archetypes.json, resolved_manifest.json, slides_manifest.json, slide_analysis.json, slide_screenshots/, icons/, and a clean base_template.pptx with zero content slides. A comprehension gate verifies four theme questions—accent hex colors, archetype count, split-panel layouts, and per-zone text colors—before writing design-profile.json with fields like primary_color_hex, text_color_light, and optional icon_pack_dir. Preflight via `slides preflight` must report ok:true before handing off to /slides-build or /slides-full. Trigger when a user provides a corporate .pptx, says "extract layouts," or prepares a template for the first build. Reach for slides-extract whenever pixel-perfect slide automation depends on machine-readable layout contracts rather than manually guessing individual slide placeholders.133installs4Slides Buildslides-build is one of 7 composable skills in mpuig/agent-slides for generating professional PowerPoint decks via a purpose-built CLI and Python API wrapping python-pptx. Install with npx skills add https://github.com/mpuig/agent-slides; skills call uvx --from agent-slides slides under the hood and require Python 3.12+ and uv. The /slides-build workflow requires prior /slides-extract output including resolved_manifest.json, base_template.pptx, and design-profile.json. It generates slides.json with a storytelling plan and declarative ops, runs slides preflight, dry-run render, full render to output.pptx, and QA lint checking 25 ranked common mistakes. Font contracts lock action titles at 24pt bold and KPI numbers at 28-36pt. The parent repo has 6 GitHub stars and documents a full pipeline from extract through audit, critique, and polish. Developers reach for slides-build when an agent must turn a strategy brief into a validated .pptx without manual slide formatting.130installs