Pular para o conteúdo
UseIA
0
Skill

Skill PPTX (PowerPoint)

Crédito: anthropics no GitHub (anthropics/skills) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

179,8 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: pptx
description: "Use esta skill sempre que um arquivo .pptx ou .potx estiver envolvido de qualquer forma — como entrada, saída ou ambos. Isso inclui: criar apresentações de slides, pitch decks ou apresentações; ler, interpretar ou extrair texto de qualquer arquivo .pptx ou .potx (mesmo que o conteúdo extraído vá ser usado em outro lugar, como em um e-mail ou resumo); editar, modificar ou atualizar apresentações existentes; combinar ou dividir arquivos de slides; trabalhar com modelos (.potx), layouts, notas do apresentador ou comentários. Acione sempre que o usuário mencionar \"deck\", \"slides\", \"apresentação\" ou citar o nome de um arquivo .pptx ou .potx, seja qual for o uso que pretenda dar ao conteúdo depois. Se um arquivo .pptx ou .potx precisar ser aberto, criado ou tocado, use esta skill."
license: Proprietary. LICENSE.txt has complete terms
---

# Criação, edição e análise de PPTX

Um `.pptx` é um arquivo ZIP de arquivos XML. Escolha a abordagem conforme a tarefa:

| Tarefa | Abordagem |
|---|---|
| **Criar** uma apresentação nova | Escreva um script `pptxgenjs` — veja as pegadinhas abaixo |
| **Editar** uma apresentação existente ou construir a partir de um modelo | unzip → edite `ppt/slides/slideN.xml` → zip |
| **Ler** o conteúdo | `markitdown deck.pptx` (um bloco por slide sob marcadores `<!-- Slide number: N -->`); grade visual: `python scripts/thumbnail.py deck.pptx` |

## Scripts

Os caminhos são relativos ao diretório desta skill. Todo o resto é Python puro, `node` ou shell.

| Script | O que faz |
|---|---|
| `scripts/thumbnail.py deck.pptx [prefix]` | Grade rotulada de todos os slides, para escolher os layouts de um modelo. Apenas `.pptx`. Informe o `prefix` — o padrão é `thumbnails`, que sobrescreve as grades de qualquer outra apresentação processada no mesmo diretório |
| `scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]` | Duplica um slide (ou um `slideLayoutN.xml`) com toda a contabilidade do pacote. Também aceita um `.pptx` diretamente com `-o out.pptx` |
| `scripts/clean.py unpacked/` | Exclui slides, mídias e relações que não são mais referenciados. Execute **depois** que o `<p:sldIdLst>` estiver final |
| `scripts/office/validate.py deck.pptx [--original src.pptx]` | Verificações de esquema, relações, tipos de conteúdo, gráficos e slides; cada falha indica a sua correção. Passe `--original` em qualquer apresentação derivada de um modelo — ele usa o modelo como base das verificações de esquema, para que os erros de XSD do próprio modelo não pareçam seus |
| `scripts/office/soffice.py --headless --convert-to pdf deck.pptx` | Wrapper do LibreOffice — o `soffice` puro trava neste sandbox |

## Criando com o pptxgenjs — pegadinhas

O `pptxgenjs` já vem pré-instalado — não rode `npm install` antes; escreva o script e use `require('pptxgenjs')` diretamente. Somente se esse require falhar: `npm install pptxgenjs`. O modelo conhece a API; estas são as armadilhas:

- **Defina `pres.layout` antes de adicionar slides.** O canvas padrão é `LAYOUT_16x9` = **10" × 5,625"**, e não 13,3" de largura. Coordenadas além da borda são gravadas, não limitadas — a forma simplesmente não fica no slide. (`LAYOUT_WIDE` é 13,3" × 7,5".)
- **Cores hexadecimais: nunca `#`, nunca 8 dígitos.** `color: "FF0000"`. Tanto `"#FF0000"` quanto o alfa embutido no hex (`"00000020"`) **corrompem o arquivo**. Para translucidez: `transparency: 0-100` em preenchimentos e imagens, `opacity: 0.0-1.0` em sombras — cada um é ignorado em silêncio no outro.
- **O pptxgenjs modifica os objetos de opções no lugar** (converte valores para EMU no primeiro uso). Nunca compartilhe um mesmo objeto de `shadow`/opções entre duas chamadas `add*` — crie um objeto novo a cada vez.
- **O `offset` da sombra deve ser ≥ 0** — um offset negativo corrompe o arquivo. Para projetar uma sombra para cima, use `angle: 270` com um offset positivo.
- **O `letterSpacing` é ignorado em silêncio** — a opção real é `charSpacing`.
- **Listas:** `bullet: true` em cada item, nunca um `•` literal (renderiza marcadores duplos). Defina `breakLine: true` em todos os itens do array, exceto no último. Espace os parágrafos com marcadores usando `paraSpaceAfter`, e não `lineSpacing` (lacunas enormes).
- **Um `new pptxgen()` por arquivo de saída** — nunca reutilize uma instância.
- **`rectRadius` só funciona em `ROUNDED_RECTANGLE`**, não em `RECTANGLE`.
- **Preenchimentos em gradiente não são suportados** — use uma imagem em gradiente como fundo.
- **As caixas de texto têm preenchimento interno embutido** — defina `margin: 0` sempre que o texto precisar se alinhar a uma forma, linha ou ícone no mesmo x.
- **As notas do apresentador vão em `slide.addNotes("...")`** (texto simples, uma vez por slide), nunca em uma caixa de texto no slide.
- **Mantenha os gráficos nativos.** Use `addChart()` para tudo o que o PowerPoint consegue representar em gráfico (passe um array de `{type, data, options}` para combinações). Para recursos nativos do PowerPoint que a biblioteca não expõe (linhas de tendência, barras de erro), calcule você mesmo a série extra ou pós-processe o OOXML gerado — não recorra a uma imagem renderizada. Apenas tipos de gráfico para os quais o PowerPoint não tem forma nativa (Sankey, rede, chord) entram como imagens.
- **Os gráficos padrão saem sem acabamento** — sem título, sem rótulos de dados, com paleta datada. Defina `showTitle` + `title`, `showValue: true` + `dataLabelPosition`, `chartColors: [...]` a partir da sua paleta e deixe a moldura discreta (`catAxisLabelColor`/`valAxisLabelColor`, `valGridLine: { color, size }`, `catGridLine: { style: "none" }`, `showLegend: false` para uma série única).
- **Em um gráfico de barras ou colunas empilhadas, o `dataLabelPosition` deve ser `ctr`, `inEnd` ou `inBase`.** O `outEnd` **corrompe o arquivo**.
- **Uma série de combinação que use `secondaryValAxis`/`secondaryCatAxis` precisa de `valAxes` e `catAxes` nas opções do gráfico, duas entradas cada.** Sem elas, o pptxgenjs grava *ids* de eixos que nunca declara, e o PowerPoint **descarta esse gráfico** e informa que o arquivo está corrompido. Fornecer só o `valAxes` não basta.
- **Depois do `writeFile()`, rode `python scripts/office/validate.py deck.pptx`.** Ele relata as duas falhas de gráfico acima e os defeitos de XML de slide que o PowerPoint recusa, e indica a correção de cada um. Corrija-os no seu gerador, não editando à mão o XML empacotado.
- **Nunca reordene os filhos de `<p:presentation>`.** O pptxgenjs grava `<p:notesMasterIdLst>` logo depois de `<p:sldIdLst>` e aponta os dois masters para uma mesma parte de tema. O PowerPoint lê isso sem problemas — mova o elemento e a mesma apresentação deixa de abrir.
- **Ícones:** renderize o `react-icons` em SVG (`ReactDOMServer.renderToStaticMarkup`), rasterize com o `sharp` a ≥256px e insira via `addImage({ data: "image/png;base64," + buf.toString("base64") })` — o prefixo `image/png;base64,` é obrigatório (`react-icons`, `react`, `react-dom` e `sharp` já vêm pré-instalados — `npm install react-icons react react-dom sharp` apenas se algum require falhar).

## Editando apresentações e modelos existentes

Escolha os layouts primeiro: `python scripts/thumbnail.py template.pptx template-thumbs` grava uma grade rotulada de todos os slides e imprime o(s) arquivo(s) que criou — `template-thumbs.jpg`, dividido em `template-thumbs-N.jpg` a partir de 12 slides. **Sempre passe esse segundo argumento, com o nome da apresentação.** O padrão é `thumbnails`, então duas apresentações geradas em miniatura no mesmo diretório sobrescrevem em silêncio as grades uma da outra — as da primeira simplesmente somem (apenas para análise de modelos — o controle de qualidade visual exige as renderizações em resolução total de [Converting to Images](#converting-to-images); ele só aceita `.pptx`, então copie um `.potx` para um nome `.pptx` primeiro). Use-o com o `markitdown` para mapear cada seção de conteúdo em um slide do modelo e varie os layouts — não coloque todas as seções no mesmo slide de título e tópicos.

```bash
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml   # duplicate a slide (or slideLayoutN.xml); prints the new slide's path
# reorder / delete slides = edit <p:sldIdLst> in ppt/presentation.xml
python scripts/clean.py unpacked/                                     # after deletions: removes orphaned slides, media, rels
# edit slide content in ppt/slides/slideN.xml
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # zip from INSIDE the dir; rm first or deleted parts survive
python scripts/office/validate.py out.pptx --original deck.pptx
```

- **Faça todo o trabalho estrutural — adicionar, excluir, reordenar — antes de editar o conteúdo de qualquer slide.** O `add_slide.py` copia o arquivo de um slide literalmente, então duplicar depois de editar clona o conteúdo editado; e o `clean.py` exclui qualquer slide que não esteja no `<p:sldIdLst>`, inclusive um que você acabou de escrever.
- **Nunca copie um arquivo de slide à mão** — o `add_slide.py` faz todos os registros de que um novo slide precisa e informa o que criou (`Created ppt/slides/slide17.xml from slide2.xml`). Ele também funciona diretamente em um arquivo: `add_slide.py deck.pptx slide2.xml -o out.pptx` — **passe `-o`, ou ele reescreve a apresentação de entrada no lugar.** Um slide duplicado ainda *referencia* as partes de gráfico/SmartArt/objetos incorporados do original, em vez de cloná-las; portanto, editar o gráfico de um slide altera o do outro.
- **Se você usar o `python-pptx`**, há três coisas que ele não faz: duplicar um slide (seu único ponto de entrada é `add_slide(layout)`), preservar a formatação com `text_frame.text = "..."` (isso reduz o parágrafo a uma única run sem estilo — atribua `run.text` em vez disso) ou ler os SVG/EMF que a maioria das artes de modelos usa (`add_picture` gera `UnidentifiedImageError`).
- Arquivos `.ppt` legados devem ser convertidos primeiro: `python scripts/office/soffice.py --headless --convert-to pptx file.ppt`. Os modelos `.potx` são desempacotados e empacotados da mesma forma — mantenha a extensão `.potx` na saída.
- Para reutilizar um ícone ou imagem de um modelo, duplique um slide ou layout que já o contenha.

Ao preencher um modelo:

- Se você escrever uma transformação de XML por script, interprete com o `defusedxml.minidom` — passar o OOXML pelo `xml.etree.ElementTree` reescreve os prefixos de namespace e corrompe a apresentação.
- **Espaços do modelo ≠ itens da origem.** Se o modelo mostra 4 membros da equipe e você tem 3, exclua o grupo inteiro do 4º membro (imagem + caixas de texto), e não apenas o texto — depois confira se sobraram elementos visuais órfãos no controle de qualidade.
- Um `<a:p>` por item de lista — nunca concatene itens em um único parágrafo. Copie o `<a:pPr>` do irmão para preservar s

[…] Conteúdo completo no GitHub.

Funciona com:Claude

Para:Criar apresentações