hezaohezao/ppt-generation
Generate PPTX presentations from slide plan + content.
npx skills add https://github.com/HezaoHezao/poirot --skill ppt-generation
Generate professional PowerPoint presentations. Plan the structure with a
consistent visual style, generate slide content, and compose into a PPTX file.
> Poirot note: The original deer-flow skill uses AI image-generation per
slide. Poirot may not have image-generation available. This version generates
text-based slides with python-pptx. Install: pip install python-pptx.
| Style | Description | Best For |
|-------|-------------|----------|
| dark-premium | Black bg, luminous accents, luxury aesthetic | Executive presentations |
| gradient-modern | Bold mesh gradients, contemporary typography | Startups, brand launches |
| minimal-swiss | Grid-based, bold negative space, timeless | Consulting, architecture |
| keynote | Apple-inspired, bold typography, dramatic imagery | Keynotes, product reveals |
| editorial | Magazine-quality layouts, sophisticated typography | Annual reports, thought leadership |
Use deep-research skill to gather content for the presentation.
{
"title": "Presentation Title",
"style": "dark-premium",
"slides": [
{"number": 1, "type": "title", "title": "...", "subtitle": "..."},
{"number": 2, "type": "content", "title": "...", "bullets": ["...", "..."]},
{"number": 3, "type": "chart", "title": "...", "data": {...}},
{"number": 4, "type": "section", "title": "..."},
{"number": 5, "type": "content", "title": "...", "bullets": ["...", "..."]},
{"number": 6, "type": "closing", "title": "Thank You", "subtitle": "..."}
]
}
python3 -c "
from pptx import Presentation
from pptx.util import Inches, Pt, Emu
from pptx.dml.color import RGBColor
from pptx.enum.text import PP_ALIGN
prs = Presentation()
prs.slide_width = Inches(13.333) # 16:9
prs.slide_height = Inches(7.5)
# Style: dark-premium
BG_COLOR = RGBColor(0x0A, 0x0A, 0x0A)
TEXT_COLOR = RGBColor(0xFF, 0xFF, 0xFF)
ACCENT_COLOR = RGBColor(0x00, 0xD9, 0xFF)
def add_slide(prs, layout_idx=6): # 6 = blank
slide = prs.slides.add_slide(prs.slide_layouts[layout_idx])
bg = slide.background
fill = bg.fill
fill.solid()
fill.fore_color.rgb = BG_COLOR
return slide
def add_text(slide, text, left, top, width, height, size=24, color=TEXT_COLOR, bold=False):
txBox = slide.shapes.add_textbox(Inches(left), Inches(top), Inches(width), Inches(height))
tf = txBox.text_frame
p = tf.paragraphs[0]
p.text = text
p.font.size = Pt(size)
p.font.color.rgb = color
p.font.bold = bold
return txBox
# Slide 1: Title
slide = add_slide(prs)
add_text(slide, 'Presentation Title', 1, 2, 11, 2, size=44, bold=True)
add_text(slide, 'Subtitle', 1, 4, 11, 1, size=24, color=ACCENT_COLOR)
# Slide 2: Content with bullets
slide = add_slide(prs)
add_text(slide, 'Key Points', 1, 0.5, 11, 1, size=36, bold=True)
for i, bullet in enumerate(['Point one', 'Point two', 'Point three']):
add_text(slide, f'• {bullet}', 1, 2 + i*0.8, 11, 0.7, size=24)
# Slide 3: Section divider
slide = add_slide(prs)
add_text(slide, 'Section Title', 1, 3, 11, 1.5, size=40, bold=True, color=ACCENT_COLOR)
# Save
prs.save('.poirot/outputs/presentation.pptx')
print('Saved to .poirot/outputs/presentation.pptx')
"
present_files([".poirot/outputs/presentation.pptx"])
| Type | Content | Layout |
|------|---------|--------|
| title | Title + subtitle | Centered, large font |
| content | Title + bullets | Left-aligned, 3-5 bullets |
| section | Section title only | Centered, accent color |
| chart | Title + chart image | Chart from chart-visualization skill |
| quote | Large quote + attribution | Centered, italic |
| closing | Thank you + contact | Centered |
visual aids, not documents.
split into more slides.
sizes, and layout patterns.
Use size + weight + color to establish hierarchy.
pip install python-pptx first.chart-visualization skill, then embed as slide.shapes.add_picture().
Take hezaohezao/ppt-generation from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.