pptlint 0.3.1

Open-source PPT/PPTX preflight checks for AI-generated PowerPoint files.

PPTLint

Check an AI-generated PowerPoint before you send or present it.

简体中文 · Live example · Before/after report

AI tools can make a PowerPoint quickly. They can also leave behind missing files, clipped text, overlapping text boxes, unreadable type, flattened slides, speaker notes, comments, and personal information.

PPTLint checks the .pptx on your computer and answers three questions:

• Ready to send — no high-confidence delivery problem was found.
• Check before sending — open the named slides and confirm the highlighted items.
• Fix before sending — fix the listed problem before sending the file.

PPTLint does not upload the presentation, call an AI model, or change the source file.

Ask your coding agent

Copy this into Codex, Claude Code, or another coding agent:

Install PPTLint and check whether this AI-generated PowerPoint is ready to send.
Show me the slides I must fix first and the exact PowerPoint steps for each one.

Run it yourself

Until the first PyPI release is verified, run the release wheel:

uvx --from https://github.com/kdnsna/pptlint/releases/download/v0.3.1/pptlint-0.3.1-py3-none-any.whl \
  pptlint check output.pptx --profile ai-generated

PPTLint writes two files:

• pptlint-report.html — an offline report for people;
• pptlint-report.json — the same result for agents and automation.

The first screen shows whether the file is ready and the three most important actions. The numerical score is secondary and is intended only for comparing the same presentation before and after changes.

See real examples

• Ready example
• Problem example
• Real editable PowerPoint improvement: 49 → 100
• Before PPTX and after PPTX
• Open method for checking five AI PowerPoint projects

Check changes

Keep the original file, check a separate edited copy, and compare the two reports:

pptlint check before.pptx --output before
pptlint check after.pptx --output after
pptlint compare before.json after.json --output comparison

The comparison separates problems that were fixed, problems that remain, and problems introduced by the edit.

Use it in GitHub Actions

- uses: kdnsna/pptlint@v0
  with:
    path: output.pptx
    profile: ai-generated
    renderer: wireframe

The reports are uploaded even when the check fails.

What PPTLint checks

User concern	Checks
Will it open correctly?	PPTX package, relationships, content types, media, slide list, real rendering
Will it fail on screen?	Off-slide text, substantial text overlap, explicit clipping risk, small type, low contrast, unusual page size
Can someone edit it later?	Full-slide images and native text, table, chart, shape coverage
Is it safe to send?	Notes, comments, hidden slides, author information, external files and links

Low-confidence hints never block delivery. PPTLint does not judge whether a presentation is beautiful, persuasive, or factually correct.

Stable interfaces

• Current report: pptlint-report/v2
• Previous report: decklint-report/v1
• Comparison format: decklint-comparison/v1
• Exit code 0: completed; 1: changes required; 2: file or runtime error.

The previous decklint command remains available through v0.4. Existing v1 reports can still be compared.

Development

uv venv --python 3.13
uv pip install -e '.[dev]'
PYTHONPATH=src .venv/bin/python -m pytest
.venv/bin/ruff check src tests tools

PPTLint is local, read-only, model-free, telemetry-free, and MIT licensed.