PPTX

PPTX Skill

Quick Reference

Reading Content

# Text extraction
python -m markitdown presentation.pptx

# Visual overview
python scripts/thumbnail.py presentation.pptx

# Raw XML
python scripts/office/unpack.py presentation.pptx unpacked/

Editing Workflow

Read editing.md for full details.

1. Analyze template with thumbnail.py
2. Unpack → manipulate slides → edit content → clean → pack

Creating from Scratch

Read pptxgenjs.md for full details.

Use when no template or reference presentation is available.

Design Ideas

Não crie slides entediantes. Bullets simples em fundo branco não impressionam ninguém. Considere ideias desta lista para cada slide.

Before Starting

• Pick a bold, content-informed color palette: A paleta deve se sentir projetada PARA ESTE tópico. Se você pudesse trocar suas cores em uma apresentação completamente diferente e ainda funcionasse, você não fez escolhas específicas o suficiente.
• Dominance over equality: Uma cor deve dominar (60-70% de peso visual), com 1-2 tons de apoio e um accent agudo. Nunca dê a todas as cores peso igual.
• Dark/light contrast: Fundos escuros para slides de título + conclusão, fundos claros para conteúdo (estrutura de "sanduíche"). Ou se comprometa com escuro em toda a apresentação para uma sensação premium.
• Commit to a visual motif: Escolha UM elemento distintivo e repita-o — molduras de imagem arredondadas, ícones em círculos coloridos, bordas grossas de um lado. Mantenha-o em todos os slides.

Color Palettes

Escolha cores que combinem com seu tópico — não use padrão genérico azul. Use estas paletas como inspiração:

For Each Slide

Every slide needs a visual element — image, chart, icon, or shape. Text-only slides are forgettable.

Layout options:

• Two-column (text left, illustration on right)
• Icon + text rows (icon in colored circle, bold header, description below)
• 2x2 or 2x3 grid (image on one side, grid of content blocks on other)
• Half-bleed image (full left or right side) with content overlay

Data display:

• Large stat callouts (big numbers 60-72pt with small labels below)
• Comparison columns (before/after, pros/cons, side-by-side options)
• Timeline or process flow (numbered steps, arrows)

Visual polish:

• Icons in small colored circles next to section headers
• Italic accent text for key stats or taglines

Typography

Choose an interesting font pairing — don't default to Arial. Pick a header font with personality and pair it with a clean body font.

Spacing

• 0.5" minimum margins
• 0.3-0.5" between content blocks
• Leave breathing room—don't fill every inch

Avoid (Common Mistakes)

• Não repita o mesmo layout — varie colunas, cards e callouts entre slides
• Não centralize corpo de texto — alinhe à esquerda parágrafos e listas; centralize apenas títulos
• Não economize em contraste de tamanho — títulos precisam de 36pt+ para se destacar de 14-16pt de corpo
• Não use azul como padrão — escolha cores que reflitam o tópico específico
• Não misture espaçamento aleatoriamente — escolha gaps de 0.3" ou 0.5" e use consistentemente
• Não estile um slide e deixe o resto simples — se comprometa completamente ou mantenha simplicidade em toda a apresentação
• Não crie slides apenas com texto — adicione imagens, ícones, gráficos ou elementos visuais; evite título simples + bullets
• Não esqueça padding em caixas de texto — ao alinhar linhas ou formas com bordas de texto, defina margin: 0 na caixa de texto ou compense a forma para levar em conta o padding
• Não use elementos com baixo contraste — ícones E texto precisam de contraste forte contra o fundo; evite texto claro em fundos claros ou texto escuro em fundos escuros
• NUNCA use linhas de accent sob títulos — estas são marca registrada de slides gerados por IA; use espaço em branco ou cor de fundo em vez disso

QA (Required)

Assuma que há problemas. Seu trabalho é encontrá-los.

Sua primeira renderização quase nunca está correta. Aborde QA como uma caça a bugs, não como etapa de confirmação. Se você encontrou zero problemas na primeira inspeção, você não estava procurando com atenção suficiente.

Content QA

python -m markitdown output.pptx

Verifique conteúdo faltando, erros de digitação, ordem errada.

When using templates, check for leftover placeholder text:

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

Se grep retornar resultados, corrija-os antes de declarar sucesso.

Visual QA

⚠️ USE SUBAGENTS — even for 2-3 slides. You've been staring at the code and will see what you expect, not what's there. Subagents have fresh eyes.

Convert slides to images (see Converting to Images), then use this prompt:

Visually inspect these slides. Assume there are issues — find them.

Look for:
- Overlapping elements (text through shapes, lines through words, stacked elements)
- Text overflow or cut off at edges/box boundaries
- Decorative lines positioned for single-line text but title wrapped to two lines
- Source citations or footers colliding with content above
- Elements too close (< 0.3" gaps) or cards/sections nearly touching
- Uneven gaps (large empty area in one place, cramped in another)
- Insufficient margin from slide edges (< 0.5")
- Columns or similar elements not aligned consistently
- Low-contrast text (e.g., light gray text on cream-colored background)
- Low-contrast icons (e.g., dark icons on dark backgrounds without a contrasting circle)
- Text boxes too narrow causing excessive wrapping
- Leftover placeholder content

For each slide, list issues or areas of concern, even if minor.

Read and analyze these images:
1. /path/to/slide-01.jpg (Expected: [brief description])
2. /path/to/slide-02.jpg (Expected: [brief description])

Report ALL issues found, including minor ones.

Verification Loop

1. Generate slides → Convert to images → Inspect
2. List issues found (if none found, look again more critically)
3. Fix issues
4. Re-verify affected slides — one fix often creates another problem
5. Repeat until a full pass reveals no new issues

Do not declare success until you've completed at least one fix-and-verify cycle.

Converting to Images

Convert presentations to individual slide images for visual inspection:

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

This creates slide-01.jpg, slide-02.jpg, etc.

To re-render specific slides after fixes:

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

Dependencies

• pip install "markitdown[pptx]" - text extraction
• pip install Pillow - thumbnail grids
• npm install -g pptxgenjs - creating from scratch
• LibreOffice (soffice) - PDF conversion (auto-configured for sandboxed environments via scripts/office/soffice.py)
• Poppler (pdftoppm) - PDF to images