Agent skill

PPTX Chart Forensics

by aiden0z in 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…

Apache-2.0Auto-check passedDocuments & Office

Install PPTX Chart Forensics

skills CLI
$ npx skills add aiden0z/pptx-renderer --skill pptx-chart-forensics -a claude-code

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

GitHub CLI
$ gh skill install aiden0z/pptx-renderer pptx-chart-forensics --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/aiden0z/pptx-renderer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pptx-chart-forensics .claude/skills/pptx-chart-forensics && 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
pptx-chart-forensics
GitHub stars
127
Token cost
~970 tokens
SKILL.md length
321 words
Files
2
Skills in repo
3
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • Works in 5 steps: Run the focused unit test that failed… → Run the nearby chart unit test files. → Re-run target oracle case and compare… → …
  • Fixing PPTX renderer chart mismatches
  • SKILL.md covers Overview, First Moves, Inspect Chart XML and Diagnosis Checklist, plus 4 more sections
  • Calls python3, npx and curl

What it does

PPTX Chart Forensics is an agent skill from aiden0z/pptx-renderer. Use when diagnosing or fixing PPTX renderer chart mismatches, chart oracle failures, ECharts option drift, OOXML chart XML parsing gaps, axis or legend discrepancies, plotArea issues, or python-pptx chart cases in this repository.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Documents & Office, covering PowerPoint presentations. It works with Microsoft PowerPoint and python-pptx. The repository describes itself as: High-fidelity, browser-native PPTX renderer in TypeScript. Parses OOXML into HTML/SVG DOM with rich text, shapes, images, tables, 2D charts, SmartArt, equations, effects, and… The licence is Apache-2.0.

When your agent uses it

  • Fixing PPTX renderer chart mismatches
  • Chart oracle failures
  • ECharts option drift
  • OOXML chart XML parsing gaps

Example prompts

  • “/pptx-chart-forensics”

Requirements

  • Python 3
  • Node.js

Workflow steps

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

  1. Run the focused unit test that failed first.
  2. Run the nearby chart unit test files.
  3. Re-run target oracle case and compare metrics.
  4. Check generated pdf, html, and diff PNGs.
  5. Run a small chart-family sweep.

What it can do on your machine

Read from SKILL.md and the folder at commit 0208050. 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:

    • python3
    • npx
    • curl
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use npx, curl and pnpm, 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 Chart Forensics loads about 970 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 321 words of instructions outside code blocks.

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

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 aiden0z/pptx-renderer at commit 0208050, republished under its Apache-2.0 licence (© aiden0z). 321 words, ~970 tokens.

Download SKILL.mdSave it as .claude/skills/pptx-chart-forensics/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pptx-chart-forensics
description
Use when diagnosing or fixing PPTX renderer chart mismatches, chart oracle failures, ECharts option drift, OOXML chart XML parsing gaps, axis or legend discrepancies, plotArea issues, or python-pptx chart cases in this repository.

PPTX Chart Forensics

Overview

Use this when a chart case fails. Derive fixes from OOXML before changing ECharts options.

First Moves

For a known chart case, run a single-case probe first:

bash
cd test/e2e
curl -sS -X POST http://127.0.0.1:8080/api/evaluate/CASE \
  > reports/oracle-failures/CASE-chart-probe-$(date +%Y%m%d-%H%M%S).json

Use ?source=windows for Windows cases.

Use a broader sweep only for family impact:

bash
cd test/e2e
.venv/bin/python3 scripts/run_all_shapes_eval.py \
  --cases-dir oracle/cases-full \
  --pypptx-cases-dir oracle/cases-pypptx \
  --out reports/oracle-failures/chart-probe-$(date +%Y%m%d-%H%M%S).json

Record metrics and report path.

Inspect Chart XML

Extract chart XML before editing:

bash
python3 - <<'PY'
from zipfile import ZipFile
case = 'CASE'
source = 'cases'  # use 'windows-cases' for --source windows
path = f'testdata/{source}/{case}/source.pptx'
with ZipFile(path) as z:
    for name in z.namelist():
        if name.startswith('ppt/charts/chart') and name.endswith('.xml'):
            print('---', name)
            print(z.read(name).decode('utf-8')[:12000])
PY

Use testdata/windows-cases when the run used --source windows.

Diagnosis Checklist

Check these before parameter tuning:

AreaQuestions
Plot areaMultiple types, combo, stock, 3D, doughnut, scatter, radar, or area?
SeriesExplicit spPr, marker, smooth, varyColors, order/index, labels, per-point colors?
AxescrossBetween, majorTickMark, tickLblPos, scaling, delete flags, number format, text props?
LegendManual layout, overlay, order, icon shape, custom line/fill?
DefaultsOffice default omitted from XML handling?
Unsupported3D/unsupported where bounded fallback is more honest?

Implementation Rules

  • Write or update a focused unit test first.
  • If no XML field explains the mismatch, say so before experimenting.
  • Prefer parser/model assertions for missing XML and renderer option assertions for ECharts.
  • Keep fixes scoped to chart modules unless evidence crosses boundaries.
  • Do not improve one chart while regressing another chart family.
  • Do not treat low fg_iou alone as proof; text, grid bounds, and anti-aliasing can dominate it.

Targeted tests:

bash
npx vitest run test/unit/renderer/ChartRenderer.test.ts
npx vitest run test/unit/renderer/chart/legendOverlay.test.ts
pnpm typecheck

Verification

After a chart fix:

  1. Run the focused unit test that failed first.
  2. Run the nearby chart unit test files.
  3. Re-run target oracle case and compare metrics.
  4. Check generated pdf, html, and diff PNGs.
  5. Run a small chart-family sweep.

Reporting Back

Report case id, XML facts, suspected gap, files, tests, metrics, unsupported behavior.

Common Mistakes

  • Do not tune ECharts margins/radii/colors before proving OOXML source.
  • Do not assume the filename names the actual chart type.
  • Do not ignore later chart nodes in plotArea; combo charts often hide there.
  • Do not mark 3D chart parity fixed without a real 3D strategy and oracle coverage.
  • Do not use a broad sweep as a substitute for single-case evidence.

© aiden0z, Apache-2.0. 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 1 other file in .agents/skills/pptx-chart-forensics of aiden0z/pptx-renderer.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 0208050

Compare with similar skills

PPTX Chart Forensics 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 Chart Forensics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PPTX Chart Forensics this skillaiden0z/pptx-renderer127—~970Automated safety check: PassApache-2.0
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Thesis Defense PPTX Builderzouchenzhen/thesis-defense-pptx-skill266—~2.4kAutomated safety check: PassApache-2.0
Powerpoint SlidesNoi1r/powerpoint-skill123—~12kAutomated safety check: NotesMIT
PPTX HTML Fidelity Auditsanqiufong/slides-from-anything1321 repos~3.5kAutomated safety check: PassApache-2.0
PPTXguyi-a/pi-ling106—~2.3kAutomated safety check: PassProprietary

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

    guyi-a/pi-ling

    PowerPoint 幻灯片(.pptx / .potx)的所有操作:从零生成(pptxgenjs Node 库)、基于模板编辑(unpack XML → 改 → clean → pack)、格式转化(pptx → PDF / 图片、.ppt → .pptx)、读取分析。触发场景:用户说"做份 PPT" / "生成幻灯片" / "演讲 slide" / "培训材料" / "项目汇报" /…

    106 GitHub stars~2.3k tokensUpdated 22 days ago
    Documents & OfficeAuto-check passed
  • Slide Making Skill

    haojing8312/WorkClaw

    Implement single-slide PowerPoint pages with PptxGenJS. An agent skill from haojing8312/WorkClaw.

    141 GitHub starsUsed in 1 repo~1.8k tokens
    Documents & OfficeAuto-check passed

More from aiden0z/pptx-renderer

  • 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…

    127 GitHub stars~981 tokensUpdated 15 days ago
    Auto-check passed
  • PPTX Render Review

    aiden0z/pptx-renderer

    A skill your agent uses when reviewing PPTX renderer visual fidelity, triaging failed or needs-review oracle cases, inspecting PDF/PNG versus HTML screenshots, checking renderer bugfix side effects…

    127 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed

Questions about PPTX Chart Forensics

What does PPTX Chart Forensics do?

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…. PPTX Chart Forensics is an agent skill from aiden0z/pptx-renderer. Use when diagnosing or fixing PPTX renderer chart mismatches, chart oracle failures, ECharts option drift, OOXML chart XML parsing gaps, axis or legend discrepancies, plotArea issues, or python-pptx chart cases in this repository.

When should I use PPTX Chart Forensics?

PPTX Chart Forensics fits situations like: fixing PPTX renderer chart mismatches; chart oracle failures; ECharts option drift; OOXML chart XML parsing gaps.

How do I install PPTX Chart Forensics in Claude Code?

Run `npx skills add aiden0z/pptx-renderer --skill pptx-chart-forensics -a claude-code`. Or copy the skill folder (.agents/skills/pptx-chart-forensics in aiden0z/pptx-renderer) into .claude/skills/pptx-chart-forensics in your project. Claude Code loads it when a task matches its description.

How do I install PPTX Chart Forensics in Codex?

Run `npx skills add aiden0z/pptx-renderer --skill pptx-chart-forensics -a codex`. Or copy the skill folder (.agents/skills/pptx-chart-forensics in aiden0z/pptx-renderer) into .agents/skills/pptx-chart-forensics in your project. Codex loads it when a task matches its description.

Can I use PPTX Chart Forensics 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 aiden0z/pptx-renderer --skill pptx-chart-forensics -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-chart-forensics, .gemini/skills/pptx-chart-forensics, .github/skills/pptx-chart-forensics and .opencode/skills/pptx-chart-forensics in your project.

What does PPTX Chart Forensics need to run?

Going by SKILL.md and its folder, PPTX Chart Forensics needs the command-line tools its instructions call (python3, npx, curl and pnpm). Our summary lists: Python 3; Node.js.

Does PPTX Chart Forensics access the network?

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

Is PPTX Chart Forensics 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 Chart Forensics use?

PPTX Chart Forensics is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PPTX Chart Forensics use?

About 970 tokens (SKILL.md is roughly 3.9k 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 Chart Forensics?

Skills that share tags, products or a category with PPTX Chart Forensics: 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 Chart Forensics?

aiden0z (a GitHub user) maintains it in aiden0z/pptx-renderer, which has 127 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 23, 2026.

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