slides-polish

Polish PPTX and Beamer slides via per-page Codex review and targeted python-pptx fixes.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Lingjie-wang/autoRL --skill slides-polish-lingjie-wang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slides-polish
Source: https://github.com/Lingjie-wang/autoRL/tree/main/Auto-claude-code-research-in-sleep/skills/slides-polish
Command: npx skills add https://github.com/Lingjie-wang/autoRL --skill slides-polish-lingjie-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx.

What problem does it solve? Generated slide decks often look mostly fine but suffer from small fonts, text-frame overflow, italic style leaks, and layout drift compared to a reference deck. This Skill runs a per-page visual review against a reference PDF and applies surgical typography and layout fixes without touching content. ## Core Features & Use Cases - Per-Page Codex Review: Each slide is rendered to PNG and compared against a reference PDF in a fresh Codex thread, producing concrete python-pptx or LaTeX fix snippets. - Targeted Fixes: Font scaling from Beamer to PPTX sizes, text-frame resizing, callout-box styling, em-dash spacing, Chinese-font hints, and anonymity placeholder discipline. - Safety Guarantees: The original deck is never overwritten, speaker notes are preserved byte-for-byte, and no content, claims, or slide order is ever changed. - Use Case: After generating a conference talk deck with /paper-slides, run this Skill with the Beamer PDF as reference to bump PPTX fonts to projector-readable sizes and fix per-slide layout drift. ## Quick Start Ask the AI to polish your generated deck by running slides-polish on your PPTX file with the Beamer PDF as the visual reference.

Frequently Asked Questions about slides-polish

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I polish PPTX slides generated from a paper?

Run slides-polish on your PPTX file with a reference PDF specified via the reference flag. The skill renders each slide to PNG, runs per-page Codex review against the reference, and applies targeted font and layout fixes to a versioned working copy.

What tools are needed for per-page slide review?

You need python-pptx for edits, poppler (pdftoppm) or mupdf for PDF-to-PNG rendering, LibreOffice for PPTX-to-PDF conversion, and Codex MCP access. Beamer polishing additionally requires xelatex or pdflatex with latexmk.

Does slides-polish change slide content or speaker notes?

No. The skill only adjusts typography and layout; it never rewrites claims, numbers, citations, or figure content. Speaker notes are verified byte-for-byte against the pre-polish snapshot, and the original file is never overwritten.

Can I use slides-polish without a reference PDF?

No. A reference PDF is a hard requirement because it serves as the visual ground truth for every per-page comparison. If none is provided, the skill prompts you rather than silently defaulting to a style preset.

When should I not use slides-polish?

Skip it when slides are still in content drafting, when you need a complete redesign with different colors or templates, or when the deck has fewer than five slides. In those cases use /paper-slides or hand-edit instead.