Install
require('pptxgenjs')Para quem
Sempre que um arquivo .pptx ou .potx entrar em jogo — como entrada, saída ou ambos — use este guia pptx. Isso inclui fazer slides, pitch decks ou apresentações, e ler, analisar ou extrair texto. O resumo também coloca editar, mesclar, dividir, modelos, notas e comentários no mesmo escopo. O gatilho: é preciso abrir, criar ou alterar esse tipo de arquivo.
O caminho se escolhe por tarefa, não por uma única interface gráfica. O material não lista produtos de agente; não trate isso como exclusivo de um software. A página oficial do guia é
https://raw.githubusercontent.com/anthropics/skills/main/skills/pptx/SKILL.md
Primeira tentativa em 3 minutos
O primeiro caminho recomendado é o que o material deixa escrito: pptxgenjs já vem pré-instalado, então não execute npm install primeiro. Escreva um script e execute:
require('pptxgenjs')
Pré-requisito: o ambiente atual consegue executar este require. Sinal de sucesso: a importação funciona e não relata módulo ausente. Isto é uma checagem somente leitura; ainda não grave uma apresentação em disco. Só se o require falhar você pode usar o fallback da mesma página, npm install pptxgenjs. Não trate a instalação de fallback como o primeiro passo padrão.
Se a importação funcionar e você confirmar que quer um arquivo novo, então escreva um script que gere um .pptx. Antes de gravar em disco, confirme o nome de saída e se sobrescreveria um arquivo existente. O resumo diz que a leitura pode usar markitdown ou thumbnail.py, mas o trecho não escreve uma chamada completa de markitdown; thumbnail.py tem risco de sobrescrita (veja os casos abaixo), então não rode miniaturas primeiro.
Casos de uso
Caso 1: criar uma nova apresentação. O caminho é pptxgenjs: escreva um script e require('pptxgenjs') direto, sem npm install primeiro. O material descreve .pptx como um ZIP de arquivos XML e pede para escolher o método por tarefa: criar com pptxgenjs, editar descompactando / mudando o XML dos slides / reempacotando, ler via markitdown ou thumbnail.py do resumo. Este caso cobre só a criação. O critério de conclusão: o script consegue o require e, após você confirmar o caminho de saída, produz um .pptx. O trecho não dá uma API concreta de slides; não invente nomes de funções de layout que não aparecem.
Caso 2: antes de gerar uma grade de miniaturas de um arquivo existente, evitar sobrescrita. O material diz que você deve passar um prefix; o padrão é thumbnails e sobrescreve grades de outras apresentações no mesmo diretório. O resumo exige que o segundo argumento seja nomeado conforme o arquivo. O comando tem efeitos colaterais: escolha um prefix que não colida, confirme que não há grade com esse nome no diretório e então execute. O critério de conclusão: você preparou um prefix distinto para esta saída, não reutilizou o thumbnails padrão.
Limites de uso
.pptx é um ZIP de XML; escolha o método por tarefa: criar com o pptxgenjs pré-instalado; editar o XML; na leitura, não instale um pacote primeiro por padrão. Só se o require falhar: npm install pptxgenjs. O prefix padrão de miniaturas sobrescreve outras grades no mesmo diretório.
Não escreva um caminho de repositório que não aparece como comando de instalação. Se capacidades do resumo como markitdown, mesclar ou dividir não tiverem comando completo, escreva só que «o material as nomeia; os passos não estão desenvolvidos». Além destes gatilhos, da ordem do require e dos efeitos do prefix já escritos, este guia não cobre o resto.