Agent skill

PPT Master

by hugohe3 in hugohe3/ppt-master

Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

MITAuto-check passedDocuments & Office

Install PPT Master

skills CLI
$ npx skills add hugohe3/ppt-master --skill ppt-master -a claude-code

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

GitHub CLI
$ gh skill install hugohe3/ppt-master ppt-master --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/hugohe3/ppt-master.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ppt-master .claude/skills/ppt-master && 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-master
GitHub stars
58k
Used in
1 other repo
Token cost
~2.5k tokens
SKILL.md length
1,157 words
Files
13,172 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows.

  • Works in 5 steps: Read this file. → Run python3… → Read workflows/routing.md through the… → …
  • Turning a document or topic into an editable slide deck
  • SKILL.md covers Mandatory Load Order, Authored Expression Range, Vocabulary and Phase Frame, plus 3 more sections
  • Calls python3

What it does

PPT Master is a presentation workflow that produces native PPTX files rather than pictures of slides. Its SKILL.md works as a router: the agent reads it, runs an attribution check script, reads the routing guide and then loads exactly one workflow, such as generating a deck, converting an image to PPTX, beautifying an existing file, creating a template or editing a native PPTX.

Generated pages can use text treatments such as pull quotes and hero numbers, 187 Office shape presets, connectors and freeform geometry, and images placed as full-bleed or cropped fields. The repository also describes narration from speaker notes, data-backed charts and reusable brand, style and layout workspaces. Any failure of the integrity check stops the skill.

When your agent uses it

  • Turning a document or topic into an editable slide deck
  • Restyling an existing PPTX without rebuilding it by hand
  • Filling a company .pptx template with new content
  • Adding narration to a finished presentation

Example prompts

  • “Turn this market report into a 12-slide PPTX deck.”
  • “Beautify the attached pitch deck but keep our brand colors.”
  • “Build a reusable template from our corporate slide master.”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read this file.
  2. Run python3 "${SKILL_DIR}/scripts/attribution_guard.py". Any non-zero result
  3. Read workflows/routing.md through the concrete
  4. Select exactly one top-level route and its active profile from the routing
  5. Read only the resulting runtime authority and its explicitly triggered

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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 Master loads about 2.5k tokens when it runs, and up to ~770k if it reads all its reference files. Until then it costs about 136 tokens; SKILL.md has 1,157 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~136
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~770k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from hugohe3/ppt-master at commit b4efe3d, republished under its MIT licence (© hugohe3). 1,157 words, ~2,490 tokens.

Download SKILL.mdSave it as .claude/skills/ppt-master/SKILL.md (or your agent's skills folder). This skill also uses 13171 other files; get the full folder from GitHub.
name
ppt-master
description
AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable Brand/Style/Layout/Deck workspaces, filling native PPTX templates, and enhancing finished PPTX files. Use when the user asks to create, generate, reconstruct, regenerate, beautify, redesign, template, fill, or enhance a presentation, PPT, PPTX, slide deck, or courseware — including adding narration or animation to one — requests a presentation-authored narrated/self-running video, or mentions ppt-master.
metadata.version
6.7.0
metadata.copyright
Copyright (c) 2025-2026 Hugo He
metadata.license
MIT
metadata.official_repository
https://github.com/hugohe3/ppt-master
metadata.sponsors
SPONSORS.md, SPONSORS_CN.md

PPT Master Skill

PPT Master is a routed presentation workflow. This entry owns global execution discipline and route selection only; each selected route owns its procedure.

Mandatory Load Order

Hard rule — paths before commands: Retain the host-provided absolute directory containing this file as SKILL_DIR. Per tool call, expand ${SKILL_DIR} and replace any skills/ppt-master/ prefix with it. Never cd, use CWD, or assume a repo checkout. If unavailable, ask; never search or guess.

  1. Read this file.
  2. Run python3 "${SKILL_DIR}/scripts/attribution_guard.py". Any non-zero result stops the Skill immediately; do not inspect, repair, or bypass the integrity gate.
  3. Read workflows/routing.md through the concrete absolute path ${SKILL_DIR}/workflows/routing.md.
  4. Select exactly one top-level route and its active profile from the routing authority.
  5. Read only the resulting runtime authority and its explicitly triggered supporting documents.
Selected route / profileRuntime authority
Generate PPTX — Image to PPTXworkflows/profiles/image-to-pptx.md; Codex-supported, always Quick
Generate PPTX — Beautifyworkflows/profiles/beautify-pptx.md; explicit Quick intent selects Quick, otherwise Default
Generate PPTX — ordinary Defaultworkflows/generate-pptx.md
Generate PPTX — ordinary explicit Quickworkflows/profiles/quick-generate.md
Create Templateworkflows/create-template.md
Edit Native PPTXworkflows/edit-native-pptx.md

Hard rule — selected authority only: Do not load another top-level route's procedure after routing. Image to PPTX and Beautify are mutually exclusive; Image to PPTX activates Quick, while Beautify selects from explicit Quick intent. Never load both runtimes. Supporting documents refine one route; they never compete with it.


Authored Expression Range

Reference — not a constraint: what a generated page can carry. Text — inline emphasis runs, lead-in, kicker, pull quote, hero number, takeaway line. Geometry — 187 Office presets, Boolean merge, connectors, freeform, page-field and outline-carrier composition. Image — full-bleed field, editorial crop, shaped picture, registered layers, scrim and spotlight, cross-page continuity. Paint — gradients, channel alpha, native shadow and glow, halftone, faceted form. Recurrence — one cross-page motif varied by page role. Each form's syntax lives in the selected runtime authority's construction references.


Vocabulary

One meaning per term across every loaded file. Where a word is used in more than one sense, the sense is named here and the files say which one.

TermMeaning
Reference (label)A starting sketch the executing role adjusts or replaces freely, with no upstream repair or stated reason; (binding) after a field label removes that freedom
RelationshipsThe §IX line naming a page's semantic units and their source-stated order / link / parent / membership / contrast / overlap, or none
Topology decisionThe per-page yes/no on whether geometry must carry the page's Relationships (topology=yes / topology=no); unrelated to pptx_structure.mode
pptx_structure.modeflat (every object Slide-local) or structured (declared Master/Layout/slot metadata); a packaging route, never information structure
CompositionThe §IX Composition line: a Reference for a page's macro composition, hierarchy, and focus
Image patternThe §VIII column carrying one image-composition suggestion in ordinary words (optionally citing #P/#M ids)
LayoutA PowerPoint Layout under a Master, or the Layout template kind; never a page-composition sketch
DeviceAn everyday page carrier — card, band, icon-and-label, KPI tile, divider, quote block — recalled in the Executor's device menu
CarrierWhat a page unit sits in: a device, an image, or native geometry; the family names are carrier and field, direction and sequence, grouping and ownership, emphasis and annotation. data-pptx-carrier is a structured-slot attribute, not this term. The carrier receipt is the checker's per-page inventory of what was actually drawn
Page jobWhat one page must do for the reader; the input every carrier, contour, and effect decision is judged against
Page fieldOne large surface, outline, aperture, or off-canvas contour that organizes zones instead of a card per unit
Contour / preset / atomA contour is a shape's silhouette; a preset is one of the 187 Office prst contours drawn through preset_shape_svg.py; an atom is one object that compiles to one DrawingML shape
Geometry signatureThe retained line page job → composition move → contour / edge language kept per page and compared before the next page
Texture (of a block)Whether a §IX block is prose, bullets, keywords, or labels; distinct from visual texture (grain, halftone)
AnchorTwo senses: a lock anchor (a deck-wide color, type, or spacing value) and the page_rhythm tag anchor for structural pages
Sheet / slice / plateA sheet is one generated image holding several elements on a chroma key; a slice is one element cut from it; a plate is a registered full-canvas layer of several non-overlapping objects
Module lineThe P<NN> modules: … line written before each page naming the triggered modules it uses
ModeNamed by qualifier: communication mode (how the deck argues), reading mode (consumption_mode), generation_mode (continuous / split), pptx_structure.mode, replication_mode (how a template was created)
Show full SKILL.md (414 more words)Show less

Phase Frame

Every route is one Plan → Do·Check·Act cycle: Plan ends when every authoring input exists as a file or retained decision; Do authors pages, Check runs the route's gates, Act repairs at the owning layer (discipline 7), and the cycle ends at export. Step numbers stay as written.

PhaseDefaultQuickEdit NativeCreate Template
PlanSteps 1–5§2§1–4Steps 1–3
Do·Check·ActSteps 6–7§3–4§5–7Steps 4–8

Global Execution Discipline

  1. Serial execution — Follow the selected authority's steps in order. A completed non-blocking step may continue directly to the next eligible step.
  2. Blocking means stop — At every ⛔ BLOCKING gate, wait for explicit user confirmation. Do not decide on the user's behalf.
  3. No cross-phase bundling — Do not combine work across an unclosed gate. Once the route's final user gate closes, later non-blocking steps may continue automatically.
  4. Gate before entry — Verify every listed prerequisite before entering a step.
  5. No speculative execution — Do not prepare later-phase artifacts before their owning step.
  6. Deterministic routing — Do not add a route-choice question when routing.md resolves the request. If a route prerequisite is missing, state it and stop that route.
  7. Act at the owning layer — On failure, repair at the shallowest layer that owns the fault: the page for a page-local issue, the Plan artifact for a roster/spec/resource fault, the owning source artifact for a tool failure; then resume from the route's declared pointer. Do not silently downgrade a required artifact.

Global Communication Rules

  • Match the user's language and source language unless the user explicitly overrides it.
  • Localize user-facing option labels and explanations. Keep exact enum IDs or field names when needed for precision.
  • Keep design_spec.md section headings and field names in the template's original English; content values may use the user's language.
  • Before switching roles, read the corresponding role reference and output:
markdown
## [Role Switch: <Role Name>]
📖 Reading role definition: references/<filename>.md
📋 Current task: <brief description>

Repository Compatibility

  • This package is a workflow/skill, not a generic application scaffold. Do not create .worktrees/, tests/, branch workflows, or generic engineering structure by default.
  • Keep required workflow, reference, script, and template documentation inside this Skill directory.
  • Repository-level documents may point into the package; package runtime files must not depend on repository-level instructions.
  • On Windows, if a documented python3 ... command is unavailable, rerun the same command with python.
  • Sponsor information is optional reference material. Read the matching SPONSORS.md or SPONSORS_CN.md only when the user explicitly requests a model, AI image model, API/provider, or hosted-service recommendation. Never surface sponsor or model recommendations proactively during normal generation, troubleshooting, or quality review.

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

Files

SKILL.md and 13,171 other files (scripts, references) in skills/ppt-master of hugohe3/ppt-master.

  • SKILL.md
  • .env.example
  • LICENSE
  • SPONSORS.md
  • SPONSORS_CN.md
  • references/ai-image-comparison/README.md
  • references/ai-image-comparison/palette/_manifest.json
  • references/ai-image-comparison/palette/_manifest.md
  • references/ai-image-comparison/palette/_subject.md
  • references/ai-image-comparison/palette/cool-corporate.webp
  • references/ai-image-comparison/palette/dark-cinematic.webp
  • references/ai-image-comparison/palette/duotone.webp
  • references/ai-image-comparison/palette/earthy-dusty.webp
  • references/ai-image-comparison/palette/editorial-classic.webp
  • references/ai-image-comparison/palette/frost-ice.webp
  • references/ai-image-comparison/palette/jewel-tone.webp
  • references/ai-image-comparison/palette/macaron.webp
  • references/ai-image-comparison/palette/mono-ink.webp
  • … and 13,154 more

Open the folder on GitHubat commit b4efe3d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in hugohe3/ppt-master, which our catalogue first saw on October 7, 2026.

Compare with similar skills

PPT Master 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 Master compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PPT Master this skillhugohe3/ppt-master58k1 repos~2.5kAutomated safety check: PassMIT
Image to Editable PPTXYuan1z0825/nature-skills47k—~2.5kAutomated safety check: PassMIT
Open Kimi Pptjinwyp/open-ppt-skill1592 repos~5.1kAutomated safety check: PassMIT
McKinsey-Style PPT Designlikaku/Mck-ppt-design-skill297—~2.1kAutomated safety check: PassApache-2.0
AI Image PowerPoint Generatorbytedance/deer-flow84k4 repos~7.1kAutomated safety check: PassMIT
PPTX Deck EditorEveryInc/hands-on-deck219—~2.9kAutomated safety check: PassMIT

Similar skills

  • Image to Editable PPTX

    Yuan1z0825/nature-skills

    Rebuilds slide images, screenshots, scanned PDFs or image-only PPTX files as PowerPoint with editable objects, using a local CLI with per-page manifests and QA.

    47k GitHub stars~2.5k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Open Kimi Ppt

    jinwyp/open-ppt-skill

    Create, edit, replicate, read, and export presentations. An agent skill from jinwyp/open-ppt-skill.

    159 GitHub starsUsed in 2 repos~5.1k tokens
    Documents & OfficeAuto-check passed
  • McKinsey-Style PPT Design

    likaku/Mck-ppt-design-skill

    Builds consultant-style PowerPoint decks from scratch with the MckEngine python-pptx wrapper, through a five-stage flow with scripted quality gates.

    297 GitHub stars~2.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Creates a PowerPoint deck by planning the slide structure, generating one AI image per slide in a chosen visual style, and assembling the images into a PPTX file.

    84k GitHub starsUsed in 4 repos~7.1k tokens
    Documents & OfficeAuto-check passed
  • PPTX Deck Editor

    EveryInc/hands-on-deck

    Reads, edits, creates, merges and visually verifies .pptx decks through one script, deck.py, which applies atomic JSON patches.

    219 GitHub stars~2.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • PowerPoint Reader and Builder

    TokenRhythm/opensquilla

    Reads, edits in place, or creates PowerPoint .pptx decks, picking one of three paths based on what tools and files are available.

    7.1k GitHub stars~3.8k tokensUpdated today
    Documents & OfficeAuto-check: notes

Questions about PPT Master

What does PPT Master do?

Generates editable PowerPoint decks, rebuilds slides from images, fills .pptx templates and polishes existing presentations through routed workflows. PPT Master is a presentation workflow that produces native PPTX files rather than pictures of slides.md works as a router: the agent reads it, runs an attribution check script, reads the routing guide and then loads exactly one workflow, such as generating a deck, converting an image to PPTX, beautifying an existing file, creating a template or editing a native PPTX.

When should I use PPT Master?

PPT Master fits situations like: turning a document or topic into an editable slide deck; restyling an existing PPTX without rebuilding it by hand; filling a company .pptx template with new content; adding narration to a finished presentation.

How do I install PPT Master in Claude Code?

Run `npx skills add hugohe3/ppt-master --skill ppt-master -a claude-code`. Or copy the skill folder (skills/ppt-master in hugohe3/ppt-master) into .claude/skills/ppt-master in your project. Claude Code loads it when a task matches its description.

How do I install PPT Master in Codex?

Run `npx skills add hugohe3/ppt-master --skill ppt-master -a codex`. Or copy the skill folder (skills/ppt-master in hugohe3/ppt-master) into .agents/skills/ppt-master in your project. Codex loads it when a task matches its description.

Can I use PPT Master 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 hugohe3/ppt-master --skill ppt-master -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-master, .gemini/skills/ppt-master, .github/skills/ppt-master and .opencode/skills/ppt-master in your project.

What does PPT Master need to run?

Going by SKILL.md and its folder, PPT Master needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does PPT Master access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PPT Master 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does PPT Master use?

PPT Master is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PPT Master use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 767k tokens, read only when the agent opens those files.

What are the alternatives to PPT Master?

Skills that share tags, products or a category with PPT Master: Image to Editable PPTX (Yuan1z0825/nature-skills, 47k stars), Open Kimi Ppt (jinwyp/open-ppt-skill, 159 stars), McKinsey-Style PPT Design (likaku/Mck-ppt-design-skill, 297 stars) and AI Image PowerPoint Generator (bytedance/deer-flow, 84k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PPT Master?

hugohe3 (a GitHub user) maintains it in hugohe3/ppt-master, which has 58,425 GitHub stars. The repository was last updated on October 8, 2026.

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