Skip to content

mikeparcewski/wicked-prezzie

Repository files navigation

wicked-prezzie

From brief to board-ready deck, without switching tools.

Idea → Refine → Generate → Refine with your team → Ship it
          ↑                        |
          └────────────────────────┘

Brainstorm the narrative. Index your source docs. Structure with Pyramid Principle. Generate themed slides. Convert to native PowerPoint. Audit quality. Parse your team's feedback from Word comments. Translate to other languages. Iterate at any stage. A Claude Code and Gemini CLI plugin for the full presentation lifecycle — 40 skills, one loop.

Jump in where you are

Use wicked-prezzie:start for everything — it auto-detects what you need.

You have... Say...
A topic or brief "Build me a deck about our platform strategy"
Source documents (PDF, PPTX, DOCX) "Index the docs in ./source-materials/ and build a deck"
HTML slides from ChatGPT, Claude, or Gemini "Convert the slides in ./my-deck/ to PowerPoint"
A reviewed Word doc with team comments "Analyze the feedback in ./exec-summary-reviewed.docx"
A document or proposal to write "Write a structured response to the RFP in ./rfp.pdf"

The thing that surprises people: drop in a Word doc your team reviewed with inline comments. Get back a ranked breakdown of where reviewers agree, where they diverge, and which slides to fix first. Then regenerate only the slides that need to change.


Install

Claude Code

/plugin marketplace add mikeparcewski/wicked-prezzie
/plugin install wicked-prezzie

Or for local development:

git clone https://github.com/mikeparcewski/wicked-prezzie.git
claude --plugin-dir ./wicked-prezzie

Gemini CLI

gemini extensions install https://github.com/mikeparcewski/wicked-prezzie

See GEMINI.md for tool name mappings.

Prerequisites

pip install python-pptx beautifulsoup4 lxml Pillow pypdf python-docx

Or install everything from the project:

pip install .
  • Google Chrome — headless layout extraction
  • LibreOffice — PPTX rendering (brew install --cask libreoffice / apt install libreoffice)
  • poppler — PDF to PNG (brew install poppler / apt install poppler-utils)
  • Optional: mermaid-cli — diagram generation (npm install -g @mermaid-js/mermaid-cli)

Missing dependencies are auto-detected on first run.


The workflow

1. Start with an idea

You have a topic, a brief, a pile of documents, or just a rough notion of what you need to present.

"I need a board deck about our platform strategy. 15 minutes.
 They care about ROI, timeline, and risk."
"I have RFP documents in ./source-materials/ — index them so we
 can build a response deck."
"Run a brainstorm — I want dreamer-skeptic teams to explore
 different angles before we commit to a narrative."

Behind the scenes: source documents get indexed into a searchable knowledge base. Brainstorm teams generate competing perspectives. The Pyramid Principle structures your argument — lead with the conclusion, group by evidence, build a narrative arc.

2. Refine the plan

Before any slides exist, you shape the story. Review the outline, challenge the structure, reorder sections, sharpen the message.

"Move the risk section before the timeline — they'll want to
 hear about risks early."
"The opening is too generic. Make it specific to our Q1 results."
"Add a comparison slide: our approach vs. the two alternatives."

This is where most of the thinking happens. The outline is cheap to change — slides are not. Get the narrative right here.

3. Generate slides

Turn the refined outline into actual slides. Pick a theme, add images, choose your slide types.

"Generate the slides with the corporate-light theme"
"Add Unsplash photos for the market opportunity slides"
"Use our brand — learn it from ./brand-guide.pdf"
"Make it feel dark and techy with purple accents"

Eight slide types (title, content, stats, comparison, quote, section divider, CTA, blank), three built-in themes, or extract one from your existing brand assets.

Already have HTML slides? Skip straight here:

"Convert the slides in ./my-deck/ to PowerPoint"

4. Refine — on your own and with your team

This is where the real iteration happens, and it works at two levels.

Refine it yourself — check quality, fix issues, re-generate specific slides.

"Audit the deck"
"The card grid on slide 4 is overlapping — fix it"
"Re-convert just slides 3 and 7"
"The CTA slide needs a stronger closing — rework it"

The plugin runs quality validation lenses, renders the PPTX to PNG for visual comparison, and iterates on problem slides until they pass.

Refine it with your team — export the narrative as a Word document for group review. Everyone adds inline comments using normal Word functionality. Then bring the feedback back in.

"Analyze the feedback in ./exec-summary-reviewed.docx"

The plugin parses every comment, maps it to the document section, and tells you:

  • Where reviewers agree — aligned concerns are your highest-priority changes
  • Where reviewers diverge — these need a conversation before you can edit
  • What it means for the narrative — which sections are hot, which were skipped, whether the overall direction holds
"Generate the feedback report as a Word doc to share back"
"Address the aligned concerns, then regenerate those slides"

Each round tightens the narrative based on real input from your stakeholders. You can loop back to any earlier stage — change the outline, swap the theme, re-run the brainstorm.

5. Ship it

Export as PPTX, HTML presenter view, PDF, or Word handout. Versioned automatically.

"Export as both PPTX and HTML"
"Generate a PDF for printing"
"Create an attendee handout in Word"
"Translate the deck to Japanese"
"Render the final version to PNG so I can preview"

What you can do

32 user-facing skills grouped by what you're trying to accomplish. You don't need to remember skill names — just say what you want.

Deck strategy and planning

Skill What it does Say...
wicked-prezzie:start Universal entry point — auto-detects intent and routes accordingly "build me a deck" / "convert these slides"
wicked-prezzie:workflow Template-driven orchestrator with 6 workflow templates "build a full deck about X"
wicked-prezzie:brainstorm Dreamer-skeptic brainstorm — generates and pressure-tests deck architecture "brainstorm deck ideas" / "run a brainstorm"
wicked-prezzie:story-arc Lightweight narrative advisor — recommends structure from six proven patterns "suggest a narrative arc" / "what story shape fits"
wicked-prezzie:checkpoint Synthesize a session into a durable checkpoint with decisions + next steps "checkpoint this" / "where were we"

Content grounding

Skill What it does Say...
wicked-prezzie:learn Index source docs (PDF, PPTX, DOCX, HTML, images) into searchable chunks "index this document" / "learn from this"
wicked-prezzie:search Context-aware search across indexed sources — adapts strategy to deck type "search for market size data" / "find evidence"
wicked-prezzie:ask Four-stage Q&A with specialist personas over indexed documents "what do the sources say about X"
wicked-prezzie:add-doc Add a document to the project source library with importance tagging "add this PDF as a key source"
wicked-prezzie:add-notes Save freeform notes, decisions, or session context to the project "note that we decided to cut the risk section"

Content generation

Skill What it does Say...
wicked-prezzie:outline Plan presentation structure using the Pyramid Principle "outline a deck" / "make a presentation about X"
wicked-prezzie:generate Generate themed HTML slides from an outline with optional images "generate the slides" / "build from the outline"
wicked-prezzie:diagram Generate SVG diagrams and visualizations from text descriptions "draw an architecture diagram" / "visualize the flow"
wicked-prezzie:notes Write or upgrade speaker notes — three fields per slide "add speaker notes" / "write talking points"
wicked-prezzie:exec-summary Generate 8-section executive summary with optional Word export "write an exec summary"
wicked-prezzie:structured-response Config-driven document generator with multi-agent review "write a structured response to the RFP"

Design and theme

Skill What it does Say...
wicked-prezzie:theme Set colors, fonts, spacing; extract brand from assets; share via profiles "set colors" / "apply a theme" / "dark theme"
wicked-prezzie:config View and set project settings (viewport, fonts, quality thresholds) "change settings" / "configure viewport"

Conversion to PowerPoint

Skill What it does Say...
wicked-prezzie:convert End-to-end HTML to PPTX with iterative visual verification (default path) "convert these slides" / "make a PowerPoint"
wicked-prezzie:quick-convert Quick HTML to PPTX without the full QA loop "just convert" / "skip validation"

Quality and iteration

Skill What it does Say...
wicked-prezzie:validate Structural QA — bounds, overflow, empty slides, content lint "audit my deck" / "validate the deck"
wicked-prezzie:validation-lenses Pluggable quality lenses — 4 universal + template-specific "run quality lenses" / "check clarity and flow"
wicked-prezzie:compare Side-by-side visual diff of HTML source vs PPTX output "does it look right" / "check fidelity"
wicked-prezzie:analytics Quantitative deck analytics — readability, visual density, slide scoring "analyze the deck" / "readability metrics"

Output and presentation

Skill What it does Say...
wicked-prezzie:presenter-html Self-contained HTML presenter view with embedded slides and tabbed notes "build presenter view" / "presenter mode"
wicked-prezzie:presenter-pdf Clean slides-only PDF via Chrome headless "export as PDF" / "PDF for printing"
wicked-prezzie:handout Attendee takeaway document — slides to readable prose in markdown/PDF/Word "create a handout" / "make an attendee doc"
wicked-prezzie:translate Locale-aware deck translation preserving layout and formatting "translate to Spanish" / "localize the deck"

Collaboration

Skill What it does Say...
wicked-prezzie:collaborate Multi-person file-based review with inline annotations and per-slide verdicts "start a review" / "collect feedback"
wicked-prezzie:feedback Parse Word comment annotations; synthesize reviewer alignment and divergence "analyze feedback" / "parse comments"

Library and versioning

Skill What it does Say...
wicked-prezzie:deck-library Index completed decks, search past work, extract reusable slides "save to library" / "search past decks"
wicked-prezzie:deck-diff Visual and structural comparison of deck versions "compare versions" / "what changed"

Workflow templates

Six templates for different presentation contexts. The start skill auto-detects the best fit, or you can specify one explicitly.

Template Phases Audience Pass Threshold
general 6 General 75
executive-briefing 7 C-suite 85
training-workshop 6 Learners 75
conference-talk 5 Conference 75
competitive-analysis 7 Strategy 75
project-status 4 Stakeholders 70

Themes

Three built-in. Create your own. Extract from existing PPTX, PDF, or brand guides. Share via .pptprofile files.

Theme Background Primary Accent
midnight-purple #0A0A0F #A100FF amber
corporate-light white #1E3A5F teal
warm-dark #1A1A2E #FF6B6B gold
"Learn my brand from ./assets/brand-guide.pdf"
"Describe a vibe — clean, minimal, executive"
"Export my theme to share with the team"

Known tradeoffs

  • Gradients become solid blended colors (PPTX gradient support is limited)
  • Animations are stripped (static snapshot of the final state)
  • Font metrics differ between CSS and Calibri (compensated, not perfect)
  • Small decorative SVGs under 30px are skipped

Documentation

  • Pipeline architecture — Stage-by-stage technical breakdown with Mermaid diagram
  • Examples — Deeper scenarios: source-grounded decks, migration, theming, quality, feedback loops
  • How it works — Technical deep-dive: extraction, building, triage, indexing
  • Gemini CLI — Tool name mapping for Gemini users

License

MIT

About

HTML slide decks → editable PowerPoint conversion toolkit

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors