cerebro-ppt-generator
Habilidad para generar presentaciones interactivas en HTML del proyecto. HTML custom autocontenido con stage 1280x720, trama de marca y navegación nativa por teclado y botones.
SKILL.md.claude/skills/cerebro-ppt-generator/SKILL.md
GitHubCuándo se usa
Úsalo cuando el usuario o analista funcional pida armar una presentación de flujos o reglas del negocio en HTML interactivo en entregables/presentaciones/.
🎯 Filosofía (UNA SOLA VÍA)
Las presentaciones son HTML custom autocontenido: un solo archivo .html con CSS y JS embebidos. Sin compiladores, sin dependencias externas (solo Google Fonts y el logo local). El .html ES el entregable final. No hay nada que compilar.
📋 Flujo de Trabajo (4 pasos obligatorios)
- Leer fuentes: Consultar los conceptos en el OKF (
cerebro-digital/) y los tokens/componentes encerebro-digital/diseno/diseno-sistema.md. - Copiar el template: Partir de
template-ppt.htmlde esta misma carpeta, que es la estructura canónica. No partir de cero ni inventar estilos nuevos. - Completar y guardar en borrador: Completar las slides con el contenido del negocio y guardar el
.htmlenborrador/presentaciones/— nunca directo enentregables/presentaciones/. Verificar que el stage es 1280x720 (16:9) y que la navegación funciona (flechas + botones). - Promover solo si lo piden: Copiar el
.htmldeborrador/presentaciones/aentregables/presentaciones/únicamente cuando el usuario lo pida explícitamente (ej: "metelo en funcional"). Nunca por iniciativa propia.
🎨 Estructura del HTML (canónica — ver template-ppt.html)
- Variables CSS en
:root:--azul-marca(⚠ placeholder: toma el valor de--brand-900dediseno/diseno-sistema.md),--azul-hover,--verde-exitoy--rojo-error(toman los tokens semánticos dediseno-sistema.md, nunca un hexadecimal a mano),--grafito(token dediseno-sistema.md),--gris,--gris-claro,--blanco,--grad-oscuro,--f. #stage: 1280x720px, centrado,border-radius: 12px, sombra profunda.- Slides
.scon tres variantes:.s--portada— oscura con gradiente, h1 + h2 + footer.docentes(autor y {{PRODUCTO}}·{{ORGANIZACION}})..s--claro— fondovar(--neutral-50), logo en.head..s--oscuro— cierre o sección oscura, sin logo.
- Animación:
.oncon@keyframes in(0.45scubic-bezier(.2,.7,.3,1)). - Trama: SVG de anillos concéntricos embebido en base64 con
stroke="currentColor"(tamaño y color por variante: 600px azul al 4% en claras, 750pxvar(--brand-300)al 6% en oscuras). - Navegación: botones
.nav-bar(‹ ›) + teclado (ArrowRight/ArrowLeft/espacio) vía funciónshowSlide.
📋 Reglas de Generación
- Logo de la organización (
../disenos/logo.png): SOLO en slides claras (.s--claro), dentro de.headcon unspancontextual. PROHIBIDO en portada (.s--portada) y cierre (.s--oscuro). - Portada:
.s--portadacon.eyebrow,h1(máx 18ch),h2de subtítulo y footer.docentescon autor/es y marca {{PRODUCTO}}·{{ORGANIZACION}}. - Layout simétrico:
.cards(tarjetas.card/.card.pprimarias) y.ruta(pasos.paso/.paso.activocon conectores) maquetados en fila conflex-direction: row. - Contenido secundario: usar
.body/.colcon listasul/li(bullets azules),.eyebrowcomo kicker y.leadcomo párrafo introductorio. - Trazabilidad: referenciar la fuente del OKF al final de cada slide con
[[archivo]]. - Estilos nuevos: agregar CSS solo si el diseño lo exige (ej: tablas, toasters); documentarlos para reutilización.
- Autocontenido: el
.htmldebe funcionar abriéndolo directo en el navegador. Verificar encoding UTF-8 sin BOM.
📂 Referencias
template-ppt.html— Plantilla canónica. Siempre partir de este archivo.cerebro-digital/diseno/diseno-sistema.md— Tokens y componentes (toasters, pills, modales, data grids, sintaxis de filtro).