Communitygithub.com

sharonzhang98/editorial-pptx-deck

Habilidad para el Agente Cursor: construye presentaciones PPTX empresariales editables, de estilo editorial-minimalista, a partir de diapositivas HTML.

¿Qué es editorial-pptx-deck?

Esta habilidad para Cursor Agent permite transformar contenido narrativo en una presentación PPTX profesional con un estilo editorial-minimalista, utilizando HTML como fuente de construcción pero generando como único entregable un archivo .pptx editable (no PDF ni HTML). El flujo de trabajo sigue seis pasos: estructura del proyecto, planificación de la narrativa, escritura de diapositivas como archivos HTML individuales (basados en plantillas prediseñadas), verificación de desbordamiento (overflow), exportación a PPTX y limpieza final. La habilidad incluye un sistema de diseño completo con tokens CSS predefinidos, una galería de fotografías de stock, y una completa biblioteca de plantillas de diapositivas (cubierta, divisores, tres columnas, tabla comparativa, panel oscuro, pipeline, cierre, etc.). Está diseñada específicamente para Cursor Agent y se basa en tecnologías como pptxgenjs, Playwright y Sharp. Las restricciones clave incluyen: mantener dimensiones exactas de 1280×720 px, usar únicamente etiquetas HTML semánticas para el texto, evitar CSS gradients y background-image, y seguir estrictamente las reglas del sistema de diseño (una paleta de colores limitada, tipografía serif para títulos y sans-serif para el cuerpo, y un único acento rojo). El resultado es una presentación completamente editable en PowerPoint, con cuadros de texto reales, no imágenes.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

editorial-pptx-deck preview

Documentación

Editorial PPTX Deck

Produce una presentación de diapositivas pulida, de estilo editorial-minimalista, y expórtala a un PPTX editable. El entregable final es únicamente el .pptx — las diapositivas HTML son solo la fuente de construcción, y no se producen visualizadores PDF/HTML.

Cómo funciona

Las diapositivas se crean como HTML restringido (un archivo por diapositiva), luego scripts/html2pptx.js traduce cada elemento DOM en un objeto nativo de PowerPoint (cuadros de texto reales, editables con doble clic). El cuerpo se fija en 1280px × 720px = 960pt × 540pt (LAYOUT_WIDE).

Flujo de trabajo de construcción

Copia esta lista de verificación y realiza un seguimiento del progreso:

- [ ] 1. Inicializar proyecto (shared/ assets/ slides/ output/)
- [ ] 2. Planificar la narrativa → asignar cada diapositiva a un tipo de plantilla
- [ ] 3. Escribir slides/NN-nombre.html a partir de las plantillas (solo editar texto)
- [ ] 4. check_overflow → corregir cualquier diapositiva que no mida exactamente 1280x720
- [ ] 5. Exportar PPTX (solo)
- [ ] 6. Limpiar la fuente de construcción (conservar solo el .pptx)

1. Inicializar proyecto. En el proyecto de trabajo, crea shared/, assets/, slides/, output/. Copia shared/tokens.css de esta habilidad al shared/ del proyecto. Copia solo las fotos que usarás de la carpeta assets/ de esta habilidad al assets/ del proyecto. Instala las dependencias una vez:

npm i pptxgenjs playwright sharp && npx playwright install chromium

2. Planificar. Convierte el contenido original en una lista de diapositivas. Cada diapositiva es uno de los tipos de plantilla. Una presentación típica = portada → (divisor → 1–3 diapositivas de contenido) × secciones → cierre. Mantén el texto conciso; este estilo es aireado.

3. Escribir diapositivas. Copia la plantilla más cercana de templates/ a slides/NN-nombre.html y reemplaza el texto. Reglas:

  • Mantén <link rel="stylesheet" href="../shared/tokens.css">.
  • Los títulos usan la serif; todo lo demás usa sans-serif (ya configurado en tokens).
  • Solo un acento rojo. Usa el panel oscuro (--ink-panel) con moderación para contraste, con el dorado #C9A24B como su único acento.
  • Las fotos se insertan mediante <img> (nunca background-image en CSS). Consulta la biblioteca de fotos.

4. Verificar ajuste. Las diapositivas que se desbordan se recortan en PPTX:

node scripts/check_overflow.mjs --slides slides

Corrige cualquier elemento marcado como OVERFLOW (acorta texto o ajusta posiciones) hasta que todo indique 1280x720.

5. Exportar solo PPTX.

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

Las diapositivas se ordenan por nombre de archivo (01-…, 02-…). No ejecutes ninguna exportación PDF/HTML — PPTX es el único entregable.

6. Limpiar. Elimina el HTML de slides/ y cualquier archivo temporal para que solo quede output/NombreDeck.pptx (además de shared/ y assets/ reutilizables si el usuario quiere iterar).

Sistema de diseño

Definido en shared/tokens.css. No inventes nuevos colores.

TokenHEXUso
--ink#1A1A1ATítulos y cuerpo principal
--soft#555555Cuerpo secundario
--muted#8C8C8CEtiquetas, notas, números de página
--red#C8102EEl único acento: barra, anticipo, palabras clave, subrayados
--red-deep#A00C24Énfasis negativo en tablas
--red-pale#FBE9ECFichas de conexión (ej. círculos "→")
--box#F4F3F1Tarjetas claras / filas de cebra
--line#E4E2DESeparadores finos
--ink-panel#1C1C1CPaneles de contraste oscuro
gold#C9A24BAcento solo en paneles oscuros
background#FFFFFFPágina
  • Tipografía: Georgia serif para h*/títulos; Arial/Helvetica sans-serif para todo lo demás.
  • Firma: barra vertical roja delgada a la izquierda del título + pequeño anticipo rojo con espaciado de letras arriba; número de página pequeño centrado en la parte inferior.
  • Cambio de marca: para adaptarse a otra empresa, cambia --red (y opcionalmente --ink-panel/gold) en tokens.css — nada más.

Biblioteca de fotos

Las fotos se encuentran en la carpeta assets/ de esta habilidad. Las imágenes verticales llenan el ~40% derecho del panel divisor/portada (object-fit:cover); las imágenes apaisadas son adecuadas para portadas a sangre completa.

ArchivoOrientaciónMejor para
sail.pngvertical 589×1024divisor / panel derecho de portada (predeterminado)
lighthouse-cliff.pngvertical 627×1024divisor / panel derecho de portada
staircase.pngalta 312×1024tira divisora calmada/abstracta
mast.pngestrecha 208×1024tira divisora estrecha
hiker-clouds.pngestrecha 225×1024tira divisora estrecha
lighthouse-sunset.pngapaisada 1024×721portada a sangre / banda superior
sailboat-deck.pngapaisada 1024×721portada a sangre / banda superior

Cambia una foto modificando <img src="../assets/….png">. Mantén una foto consistente (o un mismo motivo) en todos los divisores para lograr cohesión. Los usuarios también pueden colocar sus propias imágenes en assets/.

Catálogo de plantillas

En templates/ (cada una es una diapositiva completa de 1280×720, segura contra desbordamientos):

ArchivoTipo
01-cover.htmlPortada dividida: título serif a la izquierda, foto vertical a la derecha
02-divider.htmlDivisor de sección: anticipo + título serif + barra roja, foto vertical a la derecha
03-three-column.htmlAnticipo/título + línea central + 3 columnas + franja de resultado
04-mapping.htmlDos columnas "lo que quieren → lo que hacemos" con fichas de conexión
05-compare-table.htmlTabla comparativa de 3 columnas, filas de cebra
06-dark-contrast.htmlDos paneles (claro vs oscuro) + línea de pie serif
07-pipeline.htmlPipeline horizontal numerado de pasos + barra de salida oscura
08-closing.htmlCierre: líneas serif numeradas + foto vertical a la derecha

Restricciones estrictas

La conversión HTML→PPTX falla o se renderiza incorrectamente si se infringen estas reglas. Detalles completos y soluciones en reference.md:

  1. El texto solo dentro de <p>/<h1>–<h6> (nunca texto suelto en un <div>).
  2. Sin degradados CSS.
  3. background/border/box-shadow solo en <div>, nunca en etiquetas de texto.
  4. No usar background-image; usar <img>.
  5. Las etiquetas en línea (span/em/strong) no pueden tener márgenes.
  6. El cuerpo se mantiene en 1280×720; nada puede desbordarse.

Skills relacionados