Communitygithub.com

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

Use esta habilidade sempre que um arquivo .pptx ou .potx estiver envolvido — como entrada, saída ou ambos. Inclui: criação de decks de slides, pitch decks ou apresentações; leitura, extração de texto de arquivos .pptx/.potx; edição, modificação ou atualização de apresentações existentes; combinação ou divisão de arquivos de slides; trabalho com modelos (.potx), layouts, notas do apresentador ou comentários.

O que é Criação, edição e análise de PPTX?

Esta habilidade capacita agentes de IA (como Claude Code, Cursor ou Codex) a criar, editar e analisar apresentações do PowerPoint (.pptx) e modelos (.potx) de forma programática. Ela atua como uma ponte entre a intenção do usuário e as operações de arquivos, sendo acionada sempre que o usuário mencionar "deck", "slides", "apresentação" ou um nome de arquivo .pptx/.potx. A habilidade oferece três abordagens principais: criação de novos decks usando a biblioteca `pptxgenjs` (com dicas detalhadas sobre armadilhas comuns), edição de decks existentes ou construção a partir de modelos via descompactação, edição de XML e recompactação, e leitura de conteúdo usando a ferramenta `markitdown` ou scripts Python como `python scripts/thumbnail.py` para visualização em grade. Ela inclui scripts auxiliares para validação de esquema, limpeza de referências órfãs e conversão para PDF via LibreOffice. A habilidade também fornece diretrizes de design para evitar slides monótonos, incluindo sugestões de paletas de cores, tipografia segura e elementos visuais, garantindo que as apresentações sejam visualmente atraentes e funcionais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/pptx

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Criação, edição e análise de PPTX faz?

Um .pptx é um arquivo ZIP de arquivos XML. Escolha sua abordagem de acordo com a tarefa:

TarefaAbordagem
Criar um novo deckEscreva um script pptxgenjs — veja as armadilhas abaixo
Editar um deck existente ou construir a partir de um modelodescompacte → edite ppt/slides/slideN.xml → compactar
Ler conteúdomarkitdown deck.pptx (um bloco por slide sob os marcadores <!-- Slide number: N -->); grade visual: python scripts/thumbnail.py deck.pptx

Scripts

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

ScriptO que faz
scripts/thumbnail.py deck.pptx [prefixo]Grade legendada de cada slide, para escolher layouts de modelo. Apenas .pptx. Passe prefixo — o padrão é thumbnails, que sobrescreve as grades de qualquer outro deck no mesmo diretório
scripts/add_slide.py descompactado/ 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 descompactado/Exclui slides, mídias e rels não referenciados. Execute depois que <p:sldIdLst> estiver final
scripts/office/validate.py deck.pptx [--original src.pptx]Verificações de esquema, relacionamento, tipo de conteúdo, gráfico e slide; cada falha nomeia sua correção. Passe --original para qualquer deck derivado de modelo — ele define a linha de base das verificações de esquema contra o modelo, para que os próprios erros XSD do modelo não sejam lidos como seus
scripts/office/soffice.py --headless --convert-to pdf deck.pptxInvólucro do LibreOffice — soffice puro trava neste sandbox

Criando com pptxgenjs — armadilhas

pptxgenjs está pré-instalado — não execute npm install primeiro; escreva o script e use require('pptxgenjs') diretamente. Apenas se esse require falhar: npm install pptxgenjs. O modelo conhece a API; estes são os problemas comuns:

  • Defina pres.layout antes de adicionar slides. A tela padrão é LAYOUT_16x9 = 10" × 5.625", não 13.3" de largura. Coordenadas além da borda são escritas, não fixadas — a forma simplesmente não está no slide. (LAYOUT_WIDE é 13.3" × 7.5".)
  • Cores hexadecimais: nunca #, nunca 8 dígitos. color: "FF0000". Tanto "#FF0000" quanto alfa incorporado no hex ("00000020") corrompem o arquivo. Para translucidez: transparency: 0-100 em preenchimentos e imagens, opacity: 0.0-1.0 em sombras — cada um é silenciosamente ignorado no outro.
  • pptxgenjs modifica objetos de opções no lugar (converte valores para EMU no primeiro uso). Nunca compartilhe um objeto shadow/opções entre duas chamadas add* — construa um novo objeto 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.
  • letterSpacing é silenciosamente ignorado — a opção real é charSpacing.
  • Listas: bullet: true em cada item, nunca um • literal (renderiza marcadores duplicados). Defina breakLine: true em cada item do array, exceto o último. Espaçe parágrafos com marcadores com paraSpaceAfter, não lineSpacing (grandes lacunas).
  • Um new pptxgen() por arquivo de saída — nunca reutilize uma instância.
  • rectRadius funciona apenas em ROUNDED_RECTANGLE, não em RECTANGLE.
  • Preenchimentos gradiente não são suportados — use uma imagem gradiente como fundo.
  • As caixas de texto têm preenchimento interno embutido — defina margin: 0 sempre que o texto precisar se alinhar com uma forma, linha ou ícone no mesmo x.
  • 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 que o PowerPoint pode criar gráficos (passe um array de {type, data, options} para combos). Para recursos nativos do PowerPoint que a biblioteca não expõe (linhas de tendência, barras de erro), calcule a série extra você mesmo 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, corda) vão como imagens.
  • Gráficos padrão renderizam nus — sem título, sem rótulos de dados, paleta datada. Defina showTitle + title, showValue: true + dataLabelPosition, chartColors: [...] da sua paleta, e silencie o quadro (catAxisLabelColor/valAxisLabelColor, valGridLine: { color, size }, catGridLine: { style: "none" }, showLegend: false para uma única série).
  • Em um gráfico de barras ou colunas empilhadas, dataLabelPosition deve ser ctr, inEnd ou inBase. outEnd corrompe o arquivo.
  • Uma série combo usando secondaryValAxis/secondaryCatAxis precisa de ambos valAxes e catAxes nas opções do gráfico, duas entradas cada. Sem eles, pptxgenjs escreve ids de eixos que nunca declara, e o PowerPoint descarta esse gráfico e relata o arquivo como corrompido. Fornecer apenas valAxes não é suficiente.
  • Após writeFile(), execute 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 se recusa a abrir, e nomeia a correção para cada um. Corrija-os em seu gerador, não editando manualmente o XML compactado.
  • Nunca reordene os filhos de <p:presentation>. pptxgenjs escreve <p:notesMasterIdLst> logo após <p:sldIdLst> e aponta ambos os mestres para uma parte de tema. O PowerPoint lê isso feliz — mova o elemento e o mesmo deck se torna inabrível.
  • Ícones: renderize react-icons para SVG (ReactDOMServer.renderToStaticMarkup), rasterize com 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 estão pré-instalados — npm install react-icons react react-dom sharp apenas se um require falhar).

Editando decks e modelos existentes

Escolha os layouts primeiro: python scripts/thumbnail.py modelo.pptx modelo-thumbs escreve uma grade legendada de cada slide e imprime o(s) arquivo(s) que criou — modelo-thumbs.jpg, dividido em modelo-thumbs-N.jpg após 12 slides. Sempre passe esse segundo argumento, nomeado após o deck. O padrão é thumbnails, então dois decks com miniaturas no mesmo diretório sobrescrevem silenciosamente as grades um do outro — as do primeiro deck simplesmente desaparecem (análise de modelo apenas — a garantia de qualidade visual precisa das renderizações em resolução total de Convertendo para Imagens; aceita apenas .pptx, então copie um .potx para um nome .pptx primeiro). Use-o com markitdown para mapear cada seção de conteúdo para um slide de modelo, e varie os layouts — não coloque cada seção no mesmo slide de título e marcadores.

python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('descompactado')" deck.pptx
python scripts/add_slide.py descompactado/ slide2.xml --after slide2.xml   # duplica um slide (ou slideLayoutN.xml); imprime o caminho do novo slide
# reordenar / excluir slides = editar <p:sldIdLst> em ppt/presentation.xml
python scripts/clean.py descompactado/                                     # após exclusões: remove slides, mídias, rels órfãos
# editar conteúdo do slide em ppt/slides/slideN.xml
(cd descompactado && rm -f ../out.pptx && zip -Xr ../out.pptx .)           # compactar de DENTRO do diretório; rm primeiro ou partes excluídas sobrevivem
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. add_slide.py copia um arquivo de slide literalmente, então duplicar após a edição clona o conteúdo editado; e clean.py exclui qualquer slide ausente de <p:sldIdLst>, incluindo um que você acabou de escrever.
  • Nunca copie um arquivo de slide manualmente — add_slide.py faz todo o registro que um novo slide precisa e relata o que fez (Created ppt/slides/slide17.xml from slide2.xml). Também funciona diretamente em um arquivo: add_slide.py deck.pptx slide2.xml -o out.pptx — passe -o, ou ele reescreve o deck de entrada no lugar. Um slide duplicado ainda referencia as partes de gráfico/SmartArt/objeto incorporado da sua fonte em vez de cloná-las, então editar o gráfico de um slide altera o do outro.
  • Se você usar python-pptx, três coisas que ele não fará: duplicar um slide (seu único ponto de entrada é add_slide(layout)), preservar a formatação através de text_frame.text = "..." (isso colapsa o parágrafo para uma única execução sem estilo — atribua run.text em vez disso), ou ler o SVG/EMF que a maioria da arte de modelo usa (add_picture levanta UnidentifiedImageError).
  • O legado .ppt deve ser convertido primeiro: python scripts/office/soffice.py --headless --convert-to pptx file.ppt. Modelos .potx descompactam e compactam de forma idêntica — mantenha a extensão .potx na saída.
  • Para reutilizar um ícone ou imagem de modelo, duplique um slide ou layout que já o contenha.

Ao preencher um modelo:

  • Se você criar um script de transformação XML, analise com defusedxml.minidom — passar OOXML por xml.etree.ElementTree reescreve prefixos de namespace e corrompe o deck.
  • Slots do modelo ≠ itens de origem. Se o modelo mostra 4 membros da equipe e você tem 3, exclua todo o grupo do 4º membro (imagem + caixas de texto), não apenas seu texto — depois verifique visuais órfãos na garantia de qualidade.
  • Um <a:p> por item de lista — nunca concatene itens em um único parágrafo. Copie o <a:pPr> irmão para preservar o espaçamento, e coloque b="1" no <a:rPr> de títulos, cabeçalhos de seção e rótulos inline (Status:, Owner:).
  • Deixe os marcadores herdarem do layout; adicione apenas <a:buChar>, <a:buAutoNum> (numerado) ou <a:buNone> para substituir — nunca um • literal no texto.
  • Texto com espaços à esquerda ou à direita precisa de xml:space="preserve" em seu <a:t>.

Ideias de Design

Não crie slides chatos. Marcadores simples em fundo branco não impressionarão ninguém. Considere ideias desta lista para cada slide.

Antes de Começar

  • Escolha uma paleta de cores ousada e informada pelo conteúdo: A paleta deve parecer projetada para ESTE tópico. Se trocar suas cores em uma apresentação completamente diferente ainda "funcionasse", você não fez escolhas específicas o suficiente.
  • Domínio sobre igualdade: Uma cor deve dominar (60-70% de peso visual), com 1-2 tons de apoio e um acento nítido. Nunca dê a todas as cores peso igual.
  • Contraste escuro/claro: Fundos escuros para slides de título e conclusão, claros para conteúdo (estrutura "sanduíche"). Ou comprometa-se com escuro em toda a apresentação para uma sensação premium.
  • Comprometa-se com um motivo visual: Escolha UM elemento distinto e repita-o — molduras de imagem arredondadas, ícones em círculos coloridos. Carregue-o por todos os slides. Não use uma barra de cor ou faixa de acento como seu motivo (veja a lista de Evitar).

Paletas de Cores

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

TemaPrimáriaSecundáriaAcento
Executivo Meia-Noite1E2761 (marinho)CADCFC (azul gelo)FFFFFF (branco)
Floresta e Musgo2C5F2D (floresta)97BC62 (musgo)F5F5F5 (creme)
Energia CoralF96167 (coral)F9E795 (dourado)2F3C7E (marinho)
Terracota QuenteB85042 (terracota)E7E8D1 (areia)A7BEAE (sálvia)
Gradiente Oceano065A82 (azul profundo)1C7293 (verde-azulado)21295C (meia-noite)
Minimalista Carvão36454F (carvão)F2F2F2 (off-white)212121 (preto)
Confiança Verde-Azulada028090 (verde-azulado)00A896 (espuma do mar)02C39A (menta)
Bagas e Creme6D2E46 (baga)A26769 (rosa empoeirado)ECE2D0 (creme)
Calma Sálvia84B59F (sálvia)69A297 (eucalipto)50808E (ardósia)
Cereja Ousada990011 (cereja)FCF6F5 (off-white)2F3C7E (marinho)

Para Cada Slide

Cada slide precisa de um elemento visual — imagem, gráfico, ícone ou forma. Slides apenas com texto são esquecíveis.

Opções de layout:

  • Duas colunas (texto à esquerda, ilustração à direita)
  • Linhas de ícone + texto (ícone em círculo colorido, cabeçalho em negrito, descrição abaixo)
  • Grade 2x2 ou 2x3 (imagem de um lado, grade de blocos de conteúdo do outro)
  • Imagem meio-sangria (lado esquerdo ou direito completo) com sobreposição de conteúdo

Exibição de dados:

  • Destaques de grandes estatísticas (números grandes 60-72pt com pequenos rótulos abaixo)
  • Colunas de comparação (antes/depois, prós/contras, opções lado a lado)
  • Linha do tempo ou fluxo de processo (passos numerados, setas)

Polimento visual:

  • Ícones em pequenos círculos coloridos ao lado de cabeçalhos de seção
  • Texto de acento em itálico para estatísticas-chave ou slogans

Tipografia

Os nomes de fontes que você escreve no .pptx são renderizados pelo PowerPoint do usuário, não por este ambiente. Sua garantia de qualidade visual renderiza via LibreOffice, que substitui fontes que não possui — e para algumas fontes, o substituto tem larguras diferentes, então sua prévia de garantia de qualidade pode mostrar estouro de texto (ou ajuste) que o deck real não terá. Para manter sua garantia de qualidade confiável:

  • Fontes seguras (renderizam com largura verdadeira na garantia de qualidade e vêm com o Office): Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. Use-as para texto do corpo e qualquer coisa onde o ajuste importe.
  • Cabeçalhos com personalidade com risco zero de garantia de qualidade: combine um cabeçalho serifado da lista segura (Cambria, Bookman Old Style, Century Schoolbook) com um corpo sem serifa da lista segura (Calibri ou Arial). Você obtém contraste visual sem abrir mão de verificações confiáveis de estouro.
  • Se o usuário pedir uma fonte fora da lista segura (por exemplo, Georgia ou Trebuchet MS): use-a onde o usuário pediu, mas dimensione esses contêineres com folga extra (~10%) e não confie na garantia de qualidade de ajuste de texto nesses elementos — a prévia dessa fonte é aproximada. Se o usuário não especificou, prefira fontes da lista segura para texto do corpo.
  • Fontes não confiáveis para garantia de qualidade (o substituto tem larguras diferentes — verificações de estouro podem estar erradas): Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. A substituição de Calibri Light varia por ambiente; trate como não confiável para garantia de qualidade. Bom para títulos/acentos com folga; não confie na garantia de qualidade de ajuste de texto nestas.
  • Nunca use Aptos como padrão — o padrão do Office pós-2023 não tem substituto métrico-compatível aqui e está ausente de instalações mais antigas do Office, então não é confiável em ambos os lados.
ElementoTamanho
Título do slide36-44pt negrito
Cabeçalho de seção20-24pt negrito
Texto do corpo14-16pt
Legendas10-12pt suave

…

[truncated for translation]

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

LiChangZheng10086/doyin_ai_video

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

Habilidades Relacionadas