Skip to content
Get packs

PPTX Importer Dev Guide

Guides an agent through developing the PPTX-to-JSON importer: slide parsing, OOXML fixes and debugging.

Source Download skill
Repository
THU-MAIC/OpenMAIC
Stars
42,460
Licence
MIT
Files
15 files

What it does

This skill is a developer guide for maintaining a PowerPoint (.pptx) to JSON converter inside the OpenMAIC repository. Once installed, the agent knows the package's layered architecture, the OOXML quirks that have caused past bugs, the rules for editing the shared output type protocol, and which files are high-risk to change. When you ask it to fix a slide-rendering bug, it can follow the documented workflow: unzip the deck, dump JSON before and after a change, and diff the results.

Great for

  • Contributors to the OpenMAIC PPTX importer who need to fix conversion bugs
  • Developers who want an agent to follow the project's layering rules and commit conventions

Skip it if

  • People who just want to make or edit a presentation: this skill is about the converter's source code, not slide creation
  • Teams outside this repository, since many instructions reference its specific files and scripts

Try asking

  • “Fix the bug where the logo on slide 2 shows five extra hollow circles”
  • “Debug why a circular photo renders as a square after conversion”
  • “Add a new optional field to the adapter types without breaking downstream users”
Step-by-step guide: how to use PPTX Importer Dev GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    importer.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip importer.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip importer.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at a specific .pptx file and ask for a before/after JSON diff so changes are verified.
  • Read the SKILL.md notes on layoutElements first; many decorations live there rather than in elements.
  • Review any change to adapter/types.ts carefully, since the file is a compatibility contract.

What's inside

  • DESIGN.md
  • index.html
  • package.json
  • README.md
  • rollup.config.js
  • scripts/extract-pptx-structure.js
  • scripts/transvert.js
  • scripts/transvert.ts
  • SKILL.md
  • src/adapter/toPptxtojson.ts
  • src/adapter/types.ts
  • src/export/serializePresentation.ts
  • src/import-pipeline/index.ts
  • src/import-pipeline/mockContext.ts
  • src/import-pipeline/types.ts

Redistributed unmodified from THU-MAIC/OpenMAIC under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.