Agent skill

Ppt Generation

by HezaoHezao in HezaoHezao/poirot

Generate PPTX presentations from slide plan + content. An agent skill from HezaoHezao/poirot.

MITAuto-check passedDocuments & Office

Install Ppt Generation

skills CLI
$ npx skills add HezaoHezao/poirot --skill ppt-generation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HezaoHezao/poirot ppt-generation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HezaoHezao/poirot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/poirot/backend/agents/skill/builtin_skills/productivity/ppt-generation .claude/skills/ppt-generation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ppt-generation
GitHub stars
249
Token cost
~1.3k tokens
SKILL.md length
319 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Generate PPTX presentations from slide plan + content. An agent skill from HezaoHezao/poirot.

  • Works in 5 steps: Understand Requirements → Research (if needed) → Create Presentation Plan → …
  • Tasks that involve Slides and decks
  • SKILL.md covers Overview, When to Use, Presentation Styles and Workflow, plus 2 more sections
  • Calls pip and python3

What it does

Ppt Generation is an agent skill from HezaoHezao/poirot. Generate PPTX presentations from slide plan + content.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Slides and decks and PowerPoint presentations. It works with Microsoft PowerPoint. The repository describes itself as: Poirot is a deep research agent kernel built for those who care about how agents are architected. The licence is MIT.

When your agent uses it

  • Tasks that involve Slides and decks
  • Tasks that involve PowerPoint presentations

Example prompts

  • “/ppt-generation”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): bash, write_file, read_file, present_files

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Understand Requirements
  2. Research (if needed)
  3. Create Presentation Plan
  4. Generate PPTX
  5. Present

What it can do on your machine

Read from SKILL.md and the folder at commit 86bf279. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • bash
    • write_file
    • read_file
    • present_files

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ppt Generation loads about 1.3k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HezaoHezao/poirot at commit 86bf279, republished under its MIT licence (© HezaoHezao). 319 words, ~1,329 tokens.

Download SKILL.mdSave it as .claude/skills/ppt-generation/SKILL.md (or your agent's skills folder).
name
ppt-generation
description
Generate PPTX presentations from slide plan + content.
allowed-tools
bash, write_file, read_file, present_files
enabled
true
related-skills
deep-research, chart-visualization
license
MIT
author
Adapted from deer-flow (Bytedance, MIT)

PPT Generation

Overview

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.

When to Use

  • User requests to generate, create, or make presentations (PPT/PPTX)
  • User wants slides for a topic with structured content
  • User needs a visual presentation from research findings

Presentation Styles

StyleDescriptionBest For
dark-premiumBlack bg, luminous accents, luxury aestheticExecutive presentations
gradient-modernBold mesh gradients, contemporary typographyStartups, brand launches
minimal-swissGrid-based, bold negative space, timelessConsulting, architecture
keynoteApple-inspired, bold typography, dramatic imageryKeynotes, product reveals
editorialMagazine-quality layouts, sophisticated typographyAnnual reports, thought leadership

Workflow

Step 1: Understand Requirements
  • Topic/subject
  • Number of slides (default: 5-10)
  • Style: dark-premium / gradient-modern / minimal-swiss / keynote / editorial
  • Aspect ratio: 16:9 (standard) or 4:3
  • Content outline: key points per slide
Step 2: Research (if needed)

Use deep-research skill to gather content for the presentation.

Step 3: Create Presentation Plan
json
{
  "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": "..."}
  ]
}
Step 4: Generate PPTX
bash
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')
"
Step 5: Present
present_files([".poirot/outputs/presentation.pptx"])

Slide Types

TypeContentLayout
titleTitle + subtitleCentered, large font
contentTitle + bulletsLeft-aligned, 3-5 bullets
sectionSection title onlyCentered, accent color
chartTitle + chart imageChart from chart-visualization skill
quoteLarge quote + attributionCentered, italic
closingThank you + contactCentered

Pitfalls

  • Too much text per slide: max 5-6 bullets, max 2 lines each. Slides are visual aids, not documents.
  • Font sizes too small: title ≥36pt, body ≥24pt. If text doesn't fit, split into more slides.
  • Inconsistent style: all slides must use the same color palette, font sizes, and layout patterns.
  • No visual hierarchy: title > section headers > bullets > footnotes. Use size + weight + color to establish hierarchy.
  • python-pptx not installed: pip install python-pptx first.
  • Image slides: if you need chart images, generate them first with the chart-visualization skill, then embed as slide.shapes.add_picture().

© HezaoHezao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in poirot/backend/agents/skill/builtin_skills/productivity/ppt-generation of HezaoHezao/poirot.

Open the folder on GitHubat commit 86bf279

Compare with similar skills

Ppt Generation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ppt Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ppt Generation this skillHezaoHezao/poirot249—~1.3kAutomated safety check: PassMIT
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.8k—~4.3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Ppt Image FirstNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Gpt Image2 PptJuneYaooo/gpt-image2-ppt-skills1.3k—~8.9kAutomated safety check: NotesApache-2.0
Paper Deckzsyggg/paper-craft-skills1.3k—~1.4kAutomated safety check: PassNone

Similar skills

  • Image To Editable Ppt

    ningzimu/image-to-editable-ppt-skill

    Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.

    2.8k GitHub stars~4.3k tokensUpdated 23 days ago
    Documents & OfficeAuto-check passed
  • Slides

    fcakyon/claude-codex-settings

    Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.

    1.2k GitHub starsUsed in 1 repo~1.1k tokens
    Documents & OfficeAuto-check passed
  • Ppt Image First

    NyxTides/ppt-image-first

    Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

    1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Gpt Image2 Ppt

    JuneYaooo/gpt-image2-ppt-skills

    Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.

    1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes
  • Paper Deck

    zsyggg/paper-craft-skills

    将论文、技术文章或知识内容制作成高真实感的 AIGC 幻灯片。先做叙事结构和逐页视觉导演,再调用生图模型生成每一页 16:9 slide image,最后合成为 PPTX/PDF。适合论文汇报、组会、公开课、技术分享、商业化研究展示;当用户提到“论文PPT”“AI生成PPT”“不像AI的PPT”“高质感幻灯片”“逐页生图PPT”时使用。

    1.3k GitHub stars~1.4k tokensUpdated 4 mo ago
    Documents & OfficeAuto-check passed
  • HTML Slide To PPTX

    mucsbr/ppt-agent-workflow-san

    Convert structured single-slide or small deck HTML files into editable PPTX slides with native text boxes, shapes, chips, arrows, and panels.

    643 GitHub stars~1.1k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from HezaoHezao/poirot

All 23 skills in this repo
  • Requesting Code Review

    HezaoHezao/poirot

    Pre-commit review: security scan, quality gates, auto-fix. An agent skill from HezaoHezao/poirot.

    249 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed
  • Academic Paper Review

    HezaoHezao/poirot

    Structured peer-review of academic papers. An agent skill from HezaoHezao/poirot.

    249 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Blogwatcher

    HezaoHezao/poirot

    Monitor blogs and RSS/Atom feeds via blogwatcher-cli. An agent skill from HezaoHezao/poirot.

    249 GitHub stars~854 tokensUpdated 2 mo ago
    Auto-check passed
  • Bootstrap

    HezaoHezao/poirot

    Onboarding conversation to generate a user profile. An agent skill from HezaoHezao/poirot.

    249 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Chart Visualization

    HezaoHezao/poirot

    Generate charts: select type, extract data, render image. An agent skill from HezaoHezao/poirot.

    249 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Code Documentation

    HezaoHezao/poirot

    Generate docs: README, API reference, architecture, guides. An agent skill from HezaoHezao/poirot.

    249 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Ppt Generation

What does Ppt Generation do?

Generate PPTX presentations from slide plan + content. An agent skill from HezaoHezao/poirot. Ppt Generation is an agent skill from HezaoHezao/poirot. Generate PPTX presentations from slide plan + content.

When should I use Ppt Generation?

Ppt Generation fits situations like: tasks that involve Slides and decks; tasks that involve PowerPoint presentations.

How do I install Ppt Generation in Claude Code?

Run `npx skills add HezaoHezao/poirot --skill ppt-generation -a claude-code`. Or copy the skill folder (poirot/backend/agents/skill/builtin_skills/productivity/ppt-generation in HezaoHezao/poirot) into .claude/skills/ppt-generation in your project. Claude Code loads it when a task matches its description.

How do I install Ppt Generation in Codex?

Run `npx skills add HezaoHezao/poirot --skill ppt-generation -a codex`. Or copy the skill folder (poirot/backend/agents/skill/builtin_skills/productivity/ppt-generation in HezaoHezao/poirot) into .agents/skills/ppt-generation in your project. Codex loads it when a task matches its description.

Can I use Ppt Generation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HezaoHezao/poirot --skill ppt-generation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ppt-generation, .gemini/skills/ppt-generation, .github/skills/ppt-generation and .opencode/skills/ppt-generation in your project.

What does Ppt Generation need to run?

Going by SKILL.md and its folder, Ppt Generation needs the command-line tools its instructions call (pip and python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: bash, write_file, read_file, present_files.

Does Ppt Generation access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ppt Generation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ppt Generation use?

Ppt Generation is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ppt Generation use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ppt Generation?

Skills that share tags, products or a category with Ppt Generation: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k stars), Slides (fcakyon/claude-codex-settings, 1.2k stars), Ppt Image First (NyxTides/ppt-image-first, 1.2k stars) and Gpt Image2 Ppt (JuneYaooo/gpt-image2-ppt-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ppt Generation?

HezaoHezao (a GitHub user) maintains it in HezaoHezao/poirot, which has 249 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on July 28, 2026.

Source: HezaoHezao/poirot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.