arifszn/slide-wright

¿Qué hace slide-wright?

Convierte un tema o notas aproximadas en una presentación de nivel ejecutivo: diapositivas que parecen hechas por un equipo sólido de estrategia o producto, entregadas como un único archivo HTML autónomo que se ejecuta en cualquier navegador.

La regla que define esta habilidad

Propón el aspecto antes de construir la presentación. En la primera pasada nunca produces una presentación terminada. Generas un tema, construyes una vista previa de dos diapositivas con él y te detienes hasta que el usuario apruebe la dirección. Solo entonces construyes el resto.

Una propuesta a la vez, no un menú. Si el usuario dice que no, descarta la dirección e intenta una claramente diferente. Cada tema se inventa para la presentación que tienes delante; no hay una biblioteca de ajustes predefinidos.

Nueva presentación: lee references/new-deck.md primero. Contiene los pasos 1-4 (definir la presentación, proponer un aspecto, obtener la aprobación, construir) y la puerta de aprobación exacta.

El motor (mantenlo interno)

Las presentaciones se renderizan con reveal.js cargado desde un CDN, pero eso es un detalle de implementación que el usuario nunca ve. Habla de diapositivas, temas y diseño; el nombre de la biblioteca solo aparece dentro de las etiquetas <link> y <script> generadas. references/deck-template.md tiene la configuración exacta.

Editar una presentación que ya existe

Si el usuario señala una presentación HTML existente, verifica si está construida sobre reveal.js (busca las etiquetas <link>/<script> de reveal.js desde un CDN). Si lo está — ya sea que esta habilidad la haya construido o no — no empieces de nuevo: léela, conserva su tema y haz el cambio directamente. El aspecto ya está aprobado, así que omite la propuesta y la puerta de aprobación. Después de editar, ejecuta node <skill-dir>/scripts/check-deck.mjs <deck.html> y corrige cada línea que imprima (references/new-deck.md tiene los detalles).

No se necesitan archivos de referencia para una edición, a menos que añadas un nuevo tipo de contenido visual (lee references/exhibits.md) o código o animación (lee references/code-slides.md o references/motion-recipes.md).

Si la presentación es HTML pero no está basada en reveal.js (motor diferente, diapositivas simples, etc.), está fuera del camino de edición de esta habilidad — dícelo en lugar de forzar una reescritura en un motor diferente. Todo lo demás aquí es para construir una nueva presentación.

Paso 5 — Entrega

1. Abre la presentación terminada.
2. Di dónde se encuentra, el nombre del tema y el número de diapositivas.
3. Indica al usuario cómo navegar: flechas del teclado, espacio o deslizar para moverse; F para pantalla completa, Esc u O para la vista general de diapositivas, S para la vista de presentador con notas; añade ?print-pdf a la URL e imprime para guardar un PDF (references/export-pdf.md tiene los pasos); los colores del tema están en las variables de :root, las fuentes en la etiqueta <link>.
4. Ofrece los siguientes pasos obvios: revisar el contenido, cambiar el tema, exportar a PDF, exportar a PowerPoint (references/export-pptx.md), o desplegar en una URL en vivo para compartirlo. Si quieren desplegarlo, lee references/deploy.md y deja que elijan el host (Surge, Vercel o Netlify) — no asumas uno.

Archivos de referencia

Léelos a medida que los alcances, no todos a la vez:

• references/new-deck.md — Pasos 1-4 para una nueva presentación: definir la presentación, proponer un aspecto, obtener la aprobación, construir
• references/design-aesthetics.md — qué hace que una presentación luzca diseñada (Paso 2)
• references/theme-generation.md — el procedimiento para inventar un tema (Paso 2)
• references/deck-template.md — el esqueleto HTML, diseño y configuración del motor (Pasos 2 y 4)
• references/exhibits.md — elegir y construir el contenido visual en cada diapositiva (Pasos 2 y 4)
• references/code-slides.md — diapositivas de código y su contrato de marcado (Paso 4)
• references/motion-recipes.md — animación, cuando el usuario la solicite (Paso 4)
• references/media.md — imágenes y video en diapositivas (Paso 4)
• references/export-pdf.md — guardar una presentación como PDF (Paso 5)
• references/export-pptx.md — exportar una presentación a PowerPoint con texto editable (Paso 5)
• references/deploy.md — publicar la presentación en una URL en vivo (Paso 5)