Communitygithub.com

sharonzhang98/editorial-pptx-deck

Skill do Cursor Agent: crie decks PPTX corporativos com estilo editorial minimalista a partir de slides HTML.

O que é editorial-pptx-deck?

Este skill permite que um agente Cursor (ou ferramenta similar) construa apresentações corporativas com um estilo editorial minimalista e as exporte como arquivos PPTX totalmente editáveis. Ele funciona convertendo slides HTML, escritos com templates e um sistema de tokens CSS pré-definidos, em objetos nativos do PowerPoint (caixas de texto editáveis) usando scripts Node.js. O fluxo inclui scaffolding do projeto, planejamento da narrativa com mapeamento para tipos de template, escrita manual de cada slide HTML a partir de templates fornecidos, verificação de overflow, exportação exclusiva para PPTX e limpeza dos arquivos fonte. O design é restrito: apenas uma cor de destaque (vermelho), tipografia serifada para títulos e sans-serif para o corpo, imagens via `<img>` e um layout fixo de 1280×720 px. O skill suporta as plataformas Cursor e similares que executem Node.js com as dependências `pptxgenjs`, `playwright` e `sharp`. A saída final é unicamente o arquivo `.pptx`.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add sharonzhang98/editorial-pptx-deck

Perguntar na sua IA favorita

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

Prévia

Do README da skill

editorial-pptx-deck preview

Documentação

Editorial PPTX Deck

Produza uma apresentação de slides polida e de estilo editorial minimalista e exporte-a para um PPTX editável. O entregável final é apenas o .pptx — os slides HTML são apenas a fonte de construção, e visualizadores PDF/HTML não são produzidos.

Como funciona

Os slides são criados como HTML restrito (um arquivo por slide), e o scripts/html2pptx.js traduz cada elemento DOM em um objeto nativo do PowerPoint (caixas de texto reais, editáveis com duplo clique). O corpo é fixado em 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE).

Fluxo de construção

Copie esta lista de verificação e acompanhe o progresso:

- [ ] 1. Scaffold do projeto (shared/ assets/ slides/ output/)
- [ ] 2. Planejar a narrativa → mapear cada slide a um tipo de template
- [ ] 3. Escrever slides/NN-nome.html a partir dos templates (editar apenas texto)
- [ ] 4. check_overflow → corrigir qualquer slide que não tenha exatamente 1280x720
- [ ] 5. Exportar PPTX (apenas)
- [ ] 6. Limpar fonte de construção (manter apenas o .pptx)

1. Scaffold. No diretório de trabalho do projeto, crie shared/, assets/, slides/, output/. Copie shared/tokens.css deste skill para o diretório shared/ do projeto. Copie apenas as fotos que você usará de assets/ deste skill para o diretório assets/ do projeto. Instale as dependências uma vez:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. Planejar. Transforme o conteúdo de origem em uma lista de slides. Cada slide é um dos tipos de template. Um deck típico = capa → (divisor → 1–3 slides de conteúdo) × seções → encerramento. Mantenha o texto conciso; este estilo é arejado.

3. Escrever slides. Copie o template mais próximo de templates/ para slides/NN-nome.html e substitua o texto. Regras:

  • Mantenha <link rel="stylesheet" href="../shared/tokens.css">.
  • Títulos usam a serifada; todo o resto usa sans-serif (já configurado nos tokens).
  • Apenas um destaque vermelho. Use o painel escuro (--ink-panel) com moderação para contraste, com o dourado #C9A24B como seu único destaque.
  • Fotos são inseridas via <img> (nunca background-image). Veja a biblioteca de fotos.

4. Verificar ajuste. Slides que transbordam são cortados no PPTX:

node scripts/check_overflow.mjs --slides slides

Corrija qualquer item marcado como OVERFLOW (encurte o texto ou ajuste posições) até que todos reportem 1280x720.

5. Exportar PPTX apenas.

node scripts/export_deck_pptx.mjs --slides slides --out output/NomeDoDeck.pptx

Os slides são ordenados por nome de arquivo (01-…, 02-…). Não execute nenhuma exportação para PDF/HTML — o PPTX é o único entregável.

6. Limpar. Apague os HTMLs em slides/ e quaisquer arquivos temporários, de modo que apenas output/NomeDoDeck.pptx permaneça (além de shared/ e assets/ reutilizáveis, se o usuário quiser iterar).

Sistema de design

Definido em shared/tokens.css. Não invente novas cores.

TokenHEXUso
--ink#1A1A1ATítulos e corpo principal
--soft#555555Corpo secundário
--muted#8C8C8CRótulos, notas, números de página
--red#C8102EO único destaque: barra, antetítulo, palavras-chave, sublinhados
--red-deep#A00C24Ênfase negativa em tabelas
--red-pale#FBE9ECChips de conexão (ex.: círculos "→")
--box#F4F3F1Cartões claros / linhas zebradas
--line#E4E2DESeparadores finos
--ink-panel#1C1C1CPainéis de contraste escuros
gold#C9A24BDestaque apenas em painéis escuros
background#FFFFFFPágina
  • Tipografia: Georgia serifada para h*/títulos; Arial/Helvetica sans-serif para todo o resto.
  • Assinatura: barra vertical vermelha fina à esquerda do título + pequeno antetítulo vermelho com espaçamento entre letras acima; número de página centralizado e pequeno na parte inferior.
  • Troca de marca: para se adequar a outra empresa, altere --red (e opcionalmente --ink-panel/gold) em tokens.css — nada mais.

Biblioteca de fotos

As fotos estão em assets/ deste skill. Imagens em retrato preenchem aproximadamente 40% direito do painel do divisor/capa (object-fit:cover); imagens em paisagem são adequadas para capas com sangria total.

ArquivoOrientaçãoMelhor para
sail.pngretrato 589×1024painel direito do divisor/capa (padrão)
lighthouse-cliff.pngretrato 627×1024painel direito do divisor/capa
staircase.pngalta 312×1024faixa de divisor calma/abstrata
mast.pngestreita 208×1024faixa de divisor estreita
hiker-clouds.pngestreita 225×1024faixa de divisor estreita
lighthouse-sunset.pngpaisagem 1024×721capa com sangria total / faixa superior
sailboat-deck.pngpaisagem 1024×721capa com sangria total / faixa superior

Troque uma foto alterando <img src="../assets/….png">. Mantenha uma foto (ou um motivo) consistente em todos os divisores para coesão. Os usuários também podem colocar suas próprias imagens em assets/.

Catálogo de templates

Em templates/ (cada um é um slide completo, seguro contra overflow, de 1280×720):

ArquivoTipo
01-cover.htmlCapa dividida: título serifado à esquerda, foto retrato à direita
02-divider.htmlDivisor de seção: antetítulo + título serifado + barra vermelha, foto retrato à direita
03-three-column.htmlAntetítulo/título + linha central + 3 colunas + faixa de resultado
04-mapping.htmlDuas colunas "o que eles querem → o que fazemos" com chips de conexão
05-compare-table.htmlTabela de comparação de 3 colunas, linhas zebradas
06-dark-contrast.htmlDois painéis (claro vs escuro) + linha de rodapé serifada
07-pipeline.htmlPipeline horizontal numerado de etapas + barra de saída escura
08-closing.htmlArgumento de encerramento: linhas serifadas numeradas + foto retrato à direita

Restrições rígidas

A conversão HTML→PPTX falha ou renderiza incorretamente se estas regras forem quebradas. Detalhes completos + correções em reference.md:

  1. Texto apenas dentro de <p>/<h1>–<h6> (nunca texto solto em um <div>).
  2. Sem gradientes CSS.
  3. background/border/box-shadow apenas em <div>, nunca em tags de texto.
  4. Sem background-image; use <img>.
  5. Tags inline (span/em/strong) não podem ter margens.
  6. Corpo permanece 1280×720; nada pode transbordar.

Habilidades Relacionadas