Index of every page on this site: llms.txt
All skills
illyism avatar

/pptx-rs-genppt

@e794948
by Ilias Ismillyism/pptx-rs5 stars
Run it yourself

Pair the local pure-Rust pptx-rs CLI with the remote GenPPT MCP server (https://genppt.com/mcp) to route between art-directed visual slides, hybrid editable PowerPoint decks with live Excel charts, and legacy .pptx redesigns. Use when a user wants both strong visual art direction and editable PowerPoint exports, or wants to import an existing .pptx and redesign it in GenPPT.

  • 1 file
  • 3.9 KB
  • Updated 2 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/illyism/pptx-rs/pptx-rs-genppt

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈98 tokens for metadata: the name and description. ≈884 when used: this file.

Description uses 4.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈394 characters, or 4.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Using pptx-rs with GenPPT MCP

Combine local pptx-rs compilation with the remote GenPPT MCP server (https://genppt.com/mcp) so each part of a deck uses the right engine.

When to use which

Need Use
Art-directed 16:9 decks, brand-heavy covers, illustrations, or 4:5 / 9:16 social carousels GenPPT MCP (genppt_create_slideshow or genppt_create_deck)
100% editable PowerPoint text boxes, tables, and live embedded Excel charts pptx-rs (compile + render)
Designer cover art paired with editable data slides and live Excel charts Hybrid: GenPPT art plate + pptx-rs native slides
Redesigning an existing .pptx without losing exact numbers or tables Hybrid: pptx-rs import -> GenPPT MCP

Connect GenPPT MCP

  1. Create an API key (gppt_...) at https://genppt.com/app/account.
  2. Add the remote server:
    • Claude Code:
      claude mcp add --transport http genppt https://genppt.com/mcp --header "Authorization: Bearer gppt_YOUR_KEY"
    • Cursor (mcp.json):
      {
        "mcpServers": {
          "genppt": {
            "url": "https://genppt.com/mcp",
            "headers": {
              "Authorization": "Bearer gppt_YOUR_KEY"
            }
          }
        }
      }

Full MCP tool instructions live at https://genppt.com/SKILL.md.

Workflow 1: Hybrid editable .pptx (GenPPT art + pptx-rs data)

Use this when the user wants editable text and live Excel charts in PowerPoint without settling for plain white slides.

  1. Call genppt_create_slideshow with 1 to 3 text-free visual slides (aspectRatio: "16:9"). Specify in each slide's visual and artDirection: text-free background plate or atmospheric hero illustration with clean negative space for overlaid typography, zero letters or numbers baked into the image.
  2. Poll genppt_get_deck(deckId, waitSeconds: 60) until phase is "ready", then download the finished plate image(s) from slideImageUrls into a local assets/ folder.
  3. Author deck.ir.json for pptx-rs:
    • Place the downloaded image on cover or section slides using a plate element with "scrim": "auto" so pptx-rs automatically computes a WCAG contrast gradient behind your text.
    • Layer editable text, shape, table, and live Excel chart elements on top (zIndex: 2+).
  4. Compile, validate, and preview:
    pptx-rs compile -i deck.ir.json -o deck.pptx --report report.json
    pptx-rs render -i deck.ir.json --out-dir previews --width 1280
  5. Inspect every PNG in previews/, fix any tight boxes or spacing in deck.ir.json, and recompile.

Workflow 2: Redesign an existing .pptx in GenPPT

Use this when a user hands you an ugly legacy PowerPoint file and wants a visual upgrade with every metric preserved verbatim.

  1. Extract structured content and embedded images with pptx-rs:
    pptx-rs import -i old-deck.pptx -o extracted.ir.json --assets-dir extracted-assets/
  2. Read extracted.ir.json to capture exact slide titles, numbers, chart series, tables, and speaker notes.
  3. Call genppt_create_slideshow with one structured { title, purpose, visual } entry per slide, putting every verified metric from extracted.ir.json into purpose and uploading/referencing any logos or product photos from extracted-assets/.
  4. Poll genppt_get_deck(deckId, waitSeconds: 60) until ready, inspect the rendered slides, and call genppt_export_deck(deckId, format: "pptx") (or "pdf").

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at e794948. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated 2 days ago

README badge

README badge for illyism/pptx-rs/pptx-rs-genppt