Agent skill

PPTX Debug Workflow

Systematic debugging workflow for python-pptx presentation generation

Install PPTX Debug Workflow

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a claude-code

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

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow --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/HKUDS/OpenSpace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .claude/skills/pptx-debug-workflow && 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/

Paste into Claude Code

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .claude/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .agents/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .agents/skills/pptx-debug-workflow && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .agents/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .cursor/skills/pptx-debug-workflow && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .cursor/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/HKUDS/OpenSpace.git --path benchmarks/gdpval/skills/pptx-debug-workflow

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .gemini/skills/pptx-debug-workflow && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .gemini/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .github/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .github/skills/pptx-debug-workflow && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .github/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install HKUDS/OpenSpace pptx-debug-workflow --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/HKUDS/OpenSpace.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/benchmarks/gdpval/skills/pptx-debug-workflow .opencode/skills/pptx-debug-workflow && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pptx-debug-workflow" agent skill from https://github.com/HKUDS/OpenSpace/tree/main/benchmarks/gdpval/skills/pptx-debug-workflow into .opencode/skills/pptx-debug-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pptx-debug-workflow", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pptx-debug-workflow
GitHub stars: 7.7k
Token cost: ~1.1k tokens
SKILL.md length: 265 words
Files: 2
Skills in repo: 199
Repo updated: Aug 12, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Systematic debugging workflow for python-pptx presentation generation

Works in 6 steps: Verify Installation → Test Minimal PPTX Creation → Write Full Script to File → …
Tasks that involve PowerPoint presentations
SKILL.md covers Step 1: Verify Installation, Step 2: Test Minimal PPTX…, Step 3: Write Full Script to… and Step 4: Execute and Capture…, plus 4 more sections
Calls pip and python

What it does

PPTX Debug Workflow is an agent skill from HKUDS/OpenSpace. Systematic debugging workflow for python-pptx presentation generation

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Documents & Office, covering PowerPoint presentations and Debugging. It works with Microsoft PowerPoint and python-pptx. The repository describes itself as: "OpenSpace: The Skill Management Layer for AI Agents" -- https://open-space.cloud/. The licence is MIT.

When your agent uses it

Tasks that involve PowerPoint presentations
Tasks that involve Debugging

Example prompts

“/pptx-debug-workflow”

Requirements

Python 3

Workflow steps

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

Verify Installation
Test Minimal PPTX Creation
Write Full Script to File
Execute and Capture Full Traceback
Fix API Errors Iteratively
Validate Output

What it can do on your machine

Read from SKILL.md and the folder at commit 3827781. 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
Shell commands in SKILL.md call:
- pip
- python
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

PPTX Debug Workflow loads about 1.1k tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 265 words of instructions outside code blocks.

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

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 HKUDS/OpenSpace at commit 3827781, republished under its MIT licence (© HKUDS). 265 words, ~1,121 tokens.

Download SKILL.mdSave it as .claude/skills/pptx-debug-workflow/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: pptx-debug-workflow
description: Systematic debugging workflow for python-pptx presentation generation

PPTX Debugging Workflow

A systematic approach to creating and debugging PowerPoint presentations using the python-pptx library. This workflow ensures reliable presentation generation through iterative verification and error resolution.

Step 1: Verify Installation

Before writing any code, verify that python-pptx is installed:

bash

pip show python-pptx

If not installed:

bash

pip install python-pptx

Step 2: Test Minimal PPTX Creation

Create and run a minimal test script to verify the library works:

python

from pptx import Presentation

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[0])
slide.shapes.title.text = "Test Slide"
prs.save("test.pptx")
print("Test presentation created successfully")

Run this first to confirm basic functionality before building complex presentations.

Step 3: Write Full Script to File

Always write your presentation script to a .py file instead of using heredoc or inline execution. This enables:

Better error messages with line numbers
Easier iteration and debugging
Preserved state between error fixes

Example structure:

python

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.shapes import MSO_SHAPE
from pptx.enum.chart import XL_CHART_TYPE, XL_LEGEND_POSITION
from pptx.chart.data import CategoryChartData

def create_presentation():
    prs = Presentation()
    # Build slides here
    prs.save("output.pptx")
    print("Presentation saved successfully")

if __name__ == "__main__":
    create_presentation()

Step 4: Execute and Capture Full Traceback

Run the script with full error output:

bash

python your_script.py 2>&1 | tee debug_output.log

This captures the complete Python traceback including:

Error type and message
Line numbers where errors occurred
Stack trace for debugging

Step 5: Fix API Errors Iteratively

Common python-pptx API patterns to remember:

Chart Legend Positioning

Use XL_LEGEND_POSITION (NOT XL_CHART_TYPE) for legend positioning:

python

from pptx.enum.chart import XL_LEGEND_POSITION

chart.chart.has_legend = True
chart.chart.legend.position = XL_LEGEND_POSITION.RIGHT

Table Cell Access

Access table cells through row iteration pattern:

python

table = slide.shapes.add_table(rows=5, cols=4, left=Inches(1), top=Inches(2), width=Inches(6), height=Inches(3)).table

# Correct pattern - iterate through rows, then cells
for row_idx, row in enumerate(table.rows):
    for cell_idx, cell in enumerate(row.cells):
        cell.text = f"Row {row_idx}, Cell {cell_idx}"

# Or direct access
table.rows[0].cells[0].text = "Header"

Chart Data Format

For pie charts, use category-based data:

python

chart_data = CategoryChartData()
chart_data.categories = ['Category A', 'Category B', 'Category C']
chart_data.add_series('Series 1', (30, 45, 25))

x, y, cx, cy = Inches(2), Inches(2), Inches(6), Inches(4.5)
slide.shapes.add_chart(XL_CHART_TYPE.PIE, x, y, cx, cy, chart_data)

Step 6: Validate Output

After successful execution:

Verify the .pptx file was created
Open in PowerPoint or compatible viewer
Check that all slides, tables, and charts render correctly

Common Troubleshooting

Issue	Solution
Module not found	`pip install python-pptx`
AttributeError on chart	Check `XL_LEGEND_POSITION` vs `XL_CHART_TYPE`
Table cell access fails	Use `table.rows[row].cells[cell]` pattern
Chart doesn't display	Verify chart_data format matches chart type
Import errors	Check enum imports from `pptx.enum.*`

Quick Reference Script Template

python

from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.chart import XL_CHART_TYPE, XL_LEGEND_POSITION
from pptx.chart.data import CategoryChartData

def main():
    prs = Presentation()
    
    # Add title slide
    slide = prs.slides.add_slide(prs.slide_layouts[0])
    slide.shapes.title.text = "Title"
    
    # Add content slide with table
    slide = prs.slides.add_slide(prs.slide_layouts[1])
    table = slide.shapes.add_table(3, 3, Inches(1), Inches(2), Inches(8), Inches(2)).table
    for row in table.rows:
        for cell in row.cells:
            cell.text = "Data"
    
    prs.save("presentation.pptx")
    print("Done!")

if __name__ == "__main__":
    main()

Files

SKILL.md and 1 other file in benchmarks/gdpval/skills/pptx-debug-workflow of HKUDS/OpenSpace.

SKILL.md
.skill_id

Open the folder on GitHubat commit 3827781

Compare with similar skills

PPTX Debug Workflow 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.

PPTX Debug Workflow compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
PPTX Debug Workflow this skillHKUDS/OpenSpace	7.7k	—	~1.1k	Automated safety check: Pass	MIT	1 mo ago
Slidesfcakyon/claude-codex-settings	1.2k	1 repos	~1.1k	Automated safety check: Pass	MIT	yesterday
Thesis Defense PPTX Builderzouchenzhen/thesis-defense-pptx-skill	266	—	~2.4k	Automated safety check: Pass	Apache-2.0	4 mo ago
Powerpoint SlidesNoi1r/powerpoint-skill	123	—	~12k	Automated safety check: Notes	MIT	6 mo ago
PPTX HTML Fidelity Auditsanqiufong/slides-from-anything	132	1 repos	~3.5k	Automated safety check: Pass	Apache-2.0	yesterday
PPTX Chart Forensicsaiden0z/pptx-renderer	126	—	~970	Automated safety check: Pass	Apache-2.0	14 days ago

Similar skills

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
Thesis Defense PPTX Builder
zouchenzhen/thesis-defense-pptx-skill
Builds an editable thesis defense PowerPoint from a thesis PDF or LaTeX project while preserving a supplied university or lab template, then runs a visual quality check.
266 GitHub stars~2.4k tokensUpdated 4 mo ago
Documents & OfficeAuto-check passed
Powerpoint Slides
Noi1r/powerpoint-skill
Create visually rich PowerPoint (.pptx) presentations from academic papers, research notes, or any content the user wants in slide format.
123 GitHub stars~12k tokensUpdated 6 mo ago
Documents & OfficeAuto-check: notes
PPTX HTML Fidelity Audit
sanqiufong/slides-from-anything
Audit a python-pptx export against its source HTML deck, identify layout/content drift (footer overflow, cropped content, missing italic/em, lost styling, off-rhythm spacing), and re-export with…
132 GitHub starsUsed in 1 repo~3.5k tokens
Documents & OfficeAuto-check passed
PPTX Chart Forensics
aiden0z/pptx-renderer
A skill your agent uses when diagnosing or fixing PPTX renderer chart mismatches, chart oracle failures, ECharts option drift, OOXML chart XML parsing gaps, axis or legend discrepancies, plotArea…
126 GitHub stars~970 tokensUpdated 14 days ago
Documents & OfficeAuto-check passed
PPTX Oracle Eval
aiden0z/pptx-renderer
A skill your agent uses when running, refreshing, comparing, or summarizing PPTX renderer oracle evaluations, including shape, SmartArt, chart, table, connector, fillstroke, python-pptx, cases…
126 GitHub stars~981 tokensUpdated 14 days ago
Documents & OfficeAuto-check passed

Questions about PPTX Debug Workflow

What does PPTX Debug Workflow do?

Systematic debugging workflow for python-pptx presentation generation. PPTX Debug Workflow is an agent skill from HKUDS/OpenSpace.

When should I use PPTX Debug Workflow?

PPTX Debug Workflow fits situations like: tasks that involve PowerPoint presentations; tasks that involve Debugging.

How do I install PPTX Debug Workflow in Claude Code?

Run `npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a claude-code`. Or copy the skill folder (benchmarks/gdpval/skills/pptx-debug-workflow in HKUDS/OpenSpace) into .claude/skills/pptx-debug-workflow in your project. Claude Code loads it when a task matches its description.

How do I install PPTX Debug Workflow in Codex?

Run `npx skills add HKUDS/OpenSpace --skill pptx-debug-workflow -a codex`. Or copy the skill folder (benchmarks/gdpval/skills/pptx-debug-workflow in HKUDS/OpenSpace) into .agents/skills/pptx-debug-workflow in your project. Codex loads it when a task matches its description.

Can I use PPTX Debug Workflow 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 HKUDS/OpenSpace --skill pptx-debug-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pptx-debug-workflow, .gemini/skills/pptx-debug-workflow, .github/skills/pptx-debug-workflow and .opencode/skills/pptx-debug-workflow in your project.

What does PPTX Debug Workflow need to run?

Going by SKILL.md and its folder, PPTX Debug Workflow needs the command-line tools its instructions call (pip and python). Our summary lists: Python 3.

Does PPTX Debug Workflow 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 PPTX Debug Workflow 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 PPTX Debug Workflow use?

PPTX Debug Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PPTX Debug Workflow use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 PPTX Debug Workflow?

Skills that share tags, products or a category with PPTX Debug Workflow: Slides (fcakyon/claude-codex-settings, 1.2k stars), Thesis Defense PPTX Builder (zouchenzhen/thesis-defense-pptx-skill, 266 stars), Powerpoint Slides (Noi1r/powerpoint-skill, 123 stars) and PPTX HTML Fidelity Audit (sanqiufong/slides-from-anything, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PPTX Debug Workflow?

HKUDS (a GitHub organization) maintains it in HKUDS/OpenSpace, which has 7,743 GitHub stars. The repository holds 199 skills in this directory. The repository was last updated on August 12, 2026.

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

Install PPTX Debug Workflow

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

PPTX Debugging Workflow

Step 1: Verify Installation

Step 2: Test Minimal PPTX Creation

Step 3: Write Full Script to File

Step 4: Execute and Capture Full Traceback

Step 5: Fix API Errors Iteratively

Chart Legend Positioning

Table Cell Access

Chart Data Format

Step 6: Validate Output

Common Troubleshooting

Quick Reference Script Template

Files

Compare with similar skills

Similar skills

More from HKUDS/OpenSpace

Related

Questions about PPTX Debug Workflow