pptx

Overview

O que a skill pptx faz

A skill pptx foi criada para qualquer fluxo de trabalho que envolva um arquivo .pptx do PowerPoint. Na orientação do repositório, ela é a opção padrão sempre que o usuário precisa abrir, criar, inspecionar, modificar, combinar, dividir ou de qualquer outra forma trabalhar com arquivos de apresentação. Por isso, é uma escolha prática para produção de decks, processamento de documentos de escritório e automação específica para PowerPoint.

Esta skill oferece suporte a várias tarefas reais:

• leitura e extração de conteúdo de apresentações
• geração de uma visão geral visual em miniaturas dos slides
• descompactação de um arquivo .pptx em partes XML editáveis
• edição de decks existentes com base em um template
• criação de slides ou apresentações completas do zero
• limpeza e empacotamento de uma apresentação descompactada de volta para um .pptx válido
• validação da estrutura do PowerPoint com as ferramentas voltadas para Office incluídas

Quem deve usar pptx

Use pptx se você trabalha com:

• apresentações corporativas e pitch decks
• atualizações internas de slides com base em um template existente
• extração de conteúdo de arquivos do PowerPoint
• fluxos automatizados de apresentação em um ambiente orientado a CLI
• edições em nível de XML em documentos do Office
• fluxos de IA ou agentes que precisam inspecionar ou reescrever o conteúdo dos slides

Ela é especialmente relevante para quem usa fluxos de agentes voltados ao ecossistema da Anthropic, já que o repositório faz parte de anthropics/skills e a skill foi escrita como um guia operacional reutilizável para tarefas com apresentações.

Problemas que esta skill ajuda a resolver

pptx é útil quando conversão de arquivos comum ou ferramentas básicas de exportação não bastam. Por exemplo, ela ajuda quando você precisa:

• entender o texto e a estrutura dentro de um deck
• visualizar rapidamente os layouts dos slides antes de editar
• reutilizar um template com identidade de marca em vez de começar do zero
• duplicar ou adicionar slides em uma apresentação descompactada
• editar diretamente o XML dos slides para fazer mudanças precisas
• remover arquivos órfãos após alterações estruturais
• reconstruir o pacote da apresentação de forma limpa depois das modificações

As evidências no repositório mostram um fluxo completo envolvendo markitdown, geração de miniaturas, descompactação, edição, limpeza e empacotamento. Por isso, esta skill deve ser entendida mais como um kit prático de fluxos de trabalho para PowerPoint do que como um único script.

O que está incluído no repositório

Os arquivos publicados indicam que a skill pptx inclui:

• SKILL.md para o fluxo de referência rápida
• editing.md para orientações de edição com base em template
• pptxgenjs.md para criar apresentações do zero com PptxGenJS
• scripts/thumbnail.py para grades de miniaturas dos slides
• scripts/add_slide.py para duplicar slides ou criar um slide a partir de um layout
• scripts/clean.py para remover arquivos sem referência de um deck descompactado
• scripts/office/unpack.py e scripts/office/pack.py para abrir e reconstruir pacotes do Office
• scripts/office/validate.py e scripts/office/validators/pptx.py para dar suporte a fluxos de validação

Quando pptx é uma boa escolha

Escolha pptx quando:

• a entrada ou saída for claramente um arquivo .pptx
• você precisar de mais do que um screenshot ou um fluxo apenas de exportação
• quiser inspecionar tanto o conteúdo quanto a estrutura
• precisar de edição com reconhecimento de template em vez de gerar slides genéricos
• quiser etapas orientadas por CLI para um fluxo repetível

Quando pptx pode não ser a melhor opção

Esta skill pode ser menos adequada quando:

• você só precisa visualizar manualmente uma apresentação no PowerPoint ou em outro app com interface gráfica
• precisa de um tutorial geral de suíte de escritório, e não de um processo específico para PowerPoint
• não quer trabalhar com empacotamento de arquivos, partes XML ou edição por script
• seu fluxo está totalmente fora de arquivos .pptx

Observações de instalação antes de começar

Instale a skill com:
npx skills add https://github.com/anthropics/skills --skill pptx

Antes de usar pptx, vale saber que o repositório faz referência a várias ferramentas ou bibliotecas externas nos exemplos, incluindo markitdown, PptxGenJS e suporte de conversão relacionado ao LibreOffice por meio de soffice no fluxo de miniaturas. A configuração exata do ambiente para essas ferramentas é separada da instalação da skill em si, então planeje tanto a instalação da skill quanto quaisquer dependências de runtime de apoio que o seu fluxo exigir.

Considerações sobre licença e uso

O repositório inclui LICENSE.txt com termos proprietários da Anthropic. Revise esse arquivo antes de adotar a skill em um fluxo de produção, especialmente se você estiver avaliando restrições de reutilização, retenção ou redistribuição.

How to Use

Instale a skill pptx

Instale pptx com o comando padrão de skills:
npx skills add https://github.com/anthropics/skills --skill pptx

Depois da instalação, leia primeiro estes arquivos:

• SKILL.md
• editing.md
• pptxgenjs.md
• scripts/thumbnail.py
• scripts/add_slide.py
• scripts/clean.py

Esses arquivos correspondem de perto aos principais caminhos de uso expostos pelo repositório.

Comece pelo fluxo de referência rápida

A referência rápida do repositório divide o uso em três pontos de entrada práticos:

• ler ou analisar conteúdo
• editar ou criar a partir de um template
• criar do zero

Essa é a melhor forma de escolher seu caminho.

Se você já tem uma apresentação existente para inspecionar ou revisar, comece pela leitura e pelas miniaturas. Se você tem um deck com identidade visual para adaptar, siga o fluxo de edição. Se não houver template, use a rota com PptxGenJS documentada em pptxgenjs.md.

Ler e analisar um arquivo do PowerPoint

Para extração de conteúdo, o repositório aponta para:
python -m markitdown presentation.pptx

Isso é útil quando você quer inspecionar o texto dos slides, resumir um deck, revisar placeholders ou extrair conteúdo para outro fluxo.

Para uma visão geral visual, use:
python scripts/thumbnail.py presentation.pptx

De acordo com o cabeçalho do script, isso cria uma grade de miniaturas dos slides e rotula cada miniatura com o nome do arquivo XML, como slide1.xml. Isso é especialmente útil antes da edição, porque você consegue mapear rapidamente o visual dos slides às partes XML subjacentes.

Para acesso à estrutura bruta, descompacte o arquivo:
python scripts/office/unpack.py presentation.pptx unpacked/

Isso fornece o conteúdo do pacote necessário para alterações em nível de XML.

Edite uma apresentação existente a partir de um template

O repositório recomenda explicitamente um fluxo baseado em template em editing.md.

Uma sequência prática é:

1. Analisar o template de origem com thumbnail.py e markitdown.
2. Decidir quais layouts existentes devem corresponder ao seu novo conteúdo.
3. Descompactar o .pptx.
4. Fazer primeiro as alterações estruturais.
5. Editar o texto dentro dos arquivos XML dos slides.
6. Limpar o diretório descompactado.
7. Empacotar o diretório de volta em um arquivo .pptx.

A orientação em editing.md é especialmente útil porque alerta contra decks monótonos e incentiva layouts variados, como slides em múltiplas colunas, slides com imagem e texto, slides de citação, divisórias de seção e destaques de estatísticas. Isso faz de pptx mais do que uma ferramenta de baixo nível para arquivos: ela também ajuda na tomada de decisões melhores sobre o fluxo de criação de apresentações.

Adicione ou duplique slides em um deck descompactado

Use scripts/add_slide.py quando precisar criar um novo slide dentro de uma apresentação descompactada.

As evidências do repositório mostram dois modos compatíveis:

• duplicar um arquivo XML de slide existente, como slide2.xml
• criar um slide a partir de um arquivo de layout, como slideLayout2.xml

O script imprime o elemento <p:sldId> que você precisa adicionar a presentation.xml, um detalhe prático para a edição estrutural.

Isso é útil se você estiver reconstruindo um deck a partir de um template e quiser preservar a fidelidade do layout.

Faça a limpeza após alterações estruturais

Use:
python scripts/clean.py unpacked/

Com base na descrição do script, clean.py remove slides órfãos, relacionamentos, mídias sem referência e recursos relacionados, slides de notas, arquivos de tema e substituições de tipo de conteúdo para arquivos excluídos. Essa etapa é importante depois de excluir ou reorganizar slides, porque pacotes do PowerPoint podem acumular facilmente referências quebradas durante edições manuais.

Se você pretende manipular o XML diretamente, esta etapa de limpeza é um dos motivos mais fortes para usar pptx em vez de uma abordagem improvisada de editar ZIP.

Reconstrua o pacote da apresentação

Depois da edição e da limpeza, reempacote o deck com:
python scripts/office/pack.py unpacked/

O fluxo de edição do repositório coloca o empacotamento depois da limpeza, que é a ordem mais segura quando você fez alterações estruturais.

Crie uma apresentação do zero

Se você não tiver um template nem um deck de referência, o repositório aponta para pptxgenjs.md.

Esse guia usa PptxGenJS e mostra a estrutura básica para criar uma apresentação, definir valores de layout, adicionar slides, inserir texto e gravar o arquivo .pptx final. Os exemplos também cobrem detalhes de formatação, como charSpacing, arrays de rich text, tratamento de texto em várias linhas e dimensões de layout.

Esse caminho é o mais indicado quando:

• as restrições de branding são leves ou totalmente programáveis
• você está gerando decks a partir de dados estruturados
• quer geração de apresentações orientada a código em vez de edição por template

Padrões típicos de fluxo com pptx

Formas comuns de usar pptx incluem:

• extrair texto de apresentações de clientes ou internas para revisão
• produzir miniaturas para entender um deck antes de modificá-lo
• reutilizar uma apresentação com identidade visual como template para um novo público
• editar o XML dos slides em paralelo quando cada slide é uma tarefa separada
• gerar uma apresentação nova com PptxGenJS quando não existe template
• descompactar e validar a estrutura interna de documentos do Office em um fluxo via CLI

Arquivos e pastas que vale a pena conferir

Para avaliar a instalação e para o uso no dia a dia, estes caminhos do repositório são os mais úteis:

• SKILL.md
• editing.md
• pptxgenjs.md
• scripts/thumbnail.py
• scripts/add_slide.py
• scripts/clean.py
• scripts/office/unpack.py
• scripts/office/pack.py
• scripts/office/validate.py
• scripts/office/validators/pptx.py

Adequação prática para equipes e agentes

pptx se encaixa bem em sistemas de agentes ou fluxos de trabalho que precisam de um caminho repetível via CLI para arquivos do PowerPoint. A estrutura do repositório mostra uma separação clara entre visão geral, instruções de edição, instruções de geração e scripts auxiliares. Isso facilita a adoção em pipelines de apresentação semiautomatizados, em comparação com uma coleção única de scripts sem documentação.

FAQ

Para que serve principalmente a skill pptx?

A skill pptx serve para trabalhar com arquivos .pptx do PowerPoint em fluxos de leitura, edição, criação, descompactação e reconstrução. A orientação do repositório diz para usá-la sempre que um arquivo .pptx estiver envolvido como entrada, saída ou ambos.

Como faço para instalar pptx?

Instale com:
npx skills add https://github.com/anthropics/skills --skill pptx

Depois, revise primeiro SKILL.md, seguido de editing.md e pptxgenjs.md, dependendo de você estar editando um deck existente ou criando um novo.

O pptx consegue extrair texto de uma apresentação?

Sim. A referência rápida do repositório aponta para python -m markitdown presentation.pptx para leitura e análise de conteúdo.

O pptx consegue criar miniaturas dos slides?

Sim. scripts/thumbnail.py cria grades de miniaturas para análise visual rápida de uma apresentação do PowerPoint. A descrição do script informa que ele rotula as miniaturas com nomes de arquivos XML e mostra slides ocultos com um padrão de placeholder.

Posso editar um deck existente com pptx em vez de gerar um novo?

Sim. Esse é um dos principais fluxos compatíveis. editing.md descreve um processo baseado em template que inclui analisar o deck existente, descompactá-lo, alterar a estrutura, editar o XML dos slides, limpar partes sem referência e empacotá-lo novamente em um arquivo .pptx.

O pptx oferece suporte para criar apresentações do zero?

Sim. O repositório inclui pptxgenjs.md, que documenta um fluxo com PptxGenJS para montar uma apresentação programaticamente quando não há template nem deck de referência disponível.

O pptx serve apenas para extração de texto?

Não. A extração de texto é apenas uma parte da skill. As evidências do repositório também mostram suporte para miniaturas, descompactação, edição de XML, duplicação de slides, limpeza, reempacotamento e ferramentas relacionadas à validação.

Preciso trabalhar com XML para usar pptx?

Nem sempre, mas muitos dos fluxos de edição dependem de arquivos XML do Office descompactados. Se você estiver criando do zero via PptxGenJS, pode ficar quase sempre no JavaScript. Se estiver modificando com precisão um template com identidade visual, edições em nível de XML fazem parte do fluxo pretendido.

Quando devo escolher pptx em vez de uma ferramenta genérica de slides?

Escolha pptx quando o próprio arquivo do PowerPoint for o artefato de trabalho e você precisar de manipulação precisa de .pptx, reaproveitamento de templates, edições com reconhecimento de estrutura ou operações em nível de pacote. Se o seu trabalho for especificamente com PowerPoint, decks de slides e empacotamento de documentos do Office, esta skill é uma ótima opção.

Há alguma consideração sobre licenciamento?

Sim. O repositório inclui um LICENSE.txt proprietário com termos da Anthropic e restrições adicionais. Revise esse arquivo com atenção antes de usar pptx além do uso normal dentro do serviço.