¿Qué hace Presentación Animada Premium?
Actúa como un director de arte y un ingeniero de producción de PPTX. Tubería predeterminada permanente:
NUEVA PRESENTACIÓN -> NUEVA DIRECCIÓN DE ARTE -> NUEVO PERFIL DE DISEÑO -> DISEÑOS ADECUADOS AL CONTENIDO -> ANIMACIONES ESPECÍFICAS DEL DISEÑO -> VERIFICACIÓN DE NOVEDAD -> INSPECCIÓN VISUAL -> PPTX VALIDADO
SISTEMA DE DISEÑO != PLANTILLA. Cada deck tiene su propio perfil de diseño: genes para paleta, tipo, tratamientos de texto, kit de contenedor (tarjeta), geometría, cromo, fondo, arte, estilo de diagrama/gráfico, estrategia de composición, vocabulario de movimiento. Un perfil se genera a partir del tema y del historial de decks anteriores: nunca se copia del último trabajo ni se elige de un menú corto. Las diez direcciones nombradas son solo a priori que ponderan los genes. Cambiar colores no cuenta como un nuevo diseño: la verificación de novedad compara geometría, contenedores, portada, ubicación del título, diseños y animación, no solo la paleta.
0. Tipos de presentación (determinar a partir de la solicitud; no preguntar)
El skill es de propósito general. Inferir el tipo a partir del tema, la audiencia y el propósito; el análisis del tema del Director ya reconoce estos dominios y audiencias, por lo que no se necesita ninguna opción de motor. Adaptar estructura, terminología, diseños y narración al tipo:
- Académico / universitario / escolar / investigación / científico:
references/academic-guidelines.mdse aplica en su totalidad (fidelidad a la fuente, citas, referencias, limitaciones). - Negocios / corporativo / marketing / ventas / producto / pitch de startup: narración centrada en resultados (decisión, KPI, hoja de ruta, pitch, lanzamiento); sin estructura académica, sin diapositiva de referencias obligatoria ni citas; las afirmaciones deben provenir de datos proporcionados por el usuario.
- Técnico / ingeniería: arquitectura, proceso, resultados y diseños con muchos diagramas.
- Educativo / formación / inducción: explicación progresiva, ejemplos, resumen; reglas de citación académica solo si el material es académico.
- Creativo / personal / general: narrativo y visual, ligero en estructura; usar solo los roles que el contenido necesite. Usar solo los roles que un deck necesita (la lista de roles en el paso 4 es un menú, no un esqueleto obligatorio).
1. Flujo de trabajo (hacer todos los pasos; nunca detenerse después del primer PPTX)
- Entorno -
scripts/inspect_environment.ps1una vez por sesión (PowerPoint COM, librerías Python, fuentes). - Brief - tema, audiencia, propósito, duración, idioma. Preguntar solo si faltan el tema o el material fuente. Nunca preguntar sobre el estilo: el Director lo deriva.
- Fuente - PDFs/notas/datos proporcionados por el usuario son la única fuente de hechos; nunca inventar números, citas o referencias. Las figuras ilustrativas se etiquetan como "Ilustrativo". Los decks académicos y de investigación siguen adicionalmente
references/academic-guidelines.md(citas, diapositiva de referencias, páginas fuente); no imponer eso en decks de negocios, marketing u otros no académicos. - Historia + archivo de contenido -
content.json: metadatos + una entrada por diapositiva con un rol (portada, agenda, sección, concepto, definición, comparación, proceso, cronología, arquitectura, estadísticas, gráfico, tabla, caso_de_estudio, metodología, resultados, discusión, cita, conclusión, referencias, cierre, figura) y sus datos (esquemas:references/slide-layouts.md). Títulos de acción, una idea por diapositiva, <= 45 palabras de cuerpo. - Mirar el plan -
python scripts/director.py --content content.json --explainimprime el análisis del tema, el perfil de diseño generado y el plan por diapositiva (diseño, marco, contenedor, fondo). Anular solo si hay una preferencia de usuario explícita (--direction <id>sesga los a priori). - Construir -
scripts/build_deck.ps1(tubería completa) oscripts/make_deck.py. Genera el perfil, planifica los diseños (búsqueda de haz), construye el PPTX, ejecuta la auditoría de composición (repetición dentro del deck) y la verificación de novedad (similitud con decks anteriores); en caso de fallo, regenera con los genes/diseños problemáticos prohibidos (hasta--rounds/--novelty-rounds). Escribedeck.profile.json,deck.plan.json,deck.audit.json,deck.novelty.json,deck.anim.json. - Animar -
scripts/apply_animations.ps1 -Path deck.pptx -Spec deck.anim.json: pasos explícitos por forma del vocabulario de movimiento del perfil; escrito a través de COM cuando los efectos son seguros para COM, de lo contrario OOXML, luego leído de vuelta. - Validar + renderizar -
scripts/validate_presentation.ps1 -Path deck_final.pptx -Render -ExpectAnimations. - Mirar las diapositivas - abrir la hoja de contactos, luego cada diapositiva densa a tamaño completo. Corregir en
content.jsony reconstruir; nunca parchear manualmente el PPTX. Matar unPOWERPNTsobrante antes de volver a renderizar (copias obsoletas en memoria). - Entregar - PPTX final + informe honesto (
references/quality-checklist.md): nombre del perfil y por qué, números de novedad y qué se comparó, recuentos de animación leídos del archivo guardado, qué no fue posible.
2. Mapa de referencia (leer bajo demanda)
| Necesidad | Archivo |
|---|---|
| Cómo el Director analiza, planifica, audita, recompone | references/design-director.md |
| Genes del perfil de diseño, cómo se generan, arquetipos como a priori | references/design-profile.md |
| Verificación de novedad entre decks: métricas, umbrales, registro, límites honestos | references/novelty-check.md |
| Los 10 arquetipos (a priori) | references/visual-directions.md |
| Lo que permanece constante (cuadrícula, escala tipográfica, contraste, RTL) | references/design-system.md |
| 85 variantes de diseño, marcos, contenedores, esquemas de datos | references/slide-layouts.md |
| Vocabulario de movimiento, secuenciación, transiciones, COM vs OOXML | references/animation-system.md |
| Reglas de contenido académico / de investigación | references/academic-guidelines.md |
| Puertas de QA, plantilla de informe final | references/quality-checklist.md |
3. Scripts (ruta absoluta del skill; compatible con PowerShell 5.1, Python 3 con python-pptx, lxml, Pillow)
| Script | Propósito |
|---|---|
design_profile.py | Genera el perfil de diseño del proyecto (genes) a partir del análisis del tema, a priori de arquetipos, semilla e historial; from_template() para reutilización explícita de plantilla |
colorgen.py | Generador de paletas (modo/matiz/esquema/saturación) con reparación de contraste; fuzzed con lint |
director.py | Análisis del tema, planificación de diseños (búsqueda de haz, restricciones de diversidad suaves + duras), asignación de marco/contenedor/fondo por diapositiva, recompose() |
layouts.py, layouts_ext.py | Registro de composiciones REG[rol][variante] (85 constructores: clase de composición, etiquetas, marcos permitidos) |
pptx_kit.py | Motor: primitivas, 6 marcos, 12 estilos de contenedor, 6 modos de fondo, nodos/enlaces de diagrama, estilo de gráfico, imágenes, espejo RTL, especificación de animación |
art.py | Arte procedural, basado en contenido (15 tipos); sin fotos de stock |
motion.py | Generador de lenguaje de movimiento: temperamento, vocabulario de entrada, secuenciación por rol, transiciones, easing |
animation_tool.py | Escribe transiciones/efectos reales (13 efectos, 15 transiciones) a través de COM o OOXML, lee de vuelta |
composition_audit.py | Repetición dentro de un deck, medida en la geometría renderizada |
novelty.py | Huellas digitales de archivos PPTX y compara decks; registro de diseños anteriores; CLI `fingerprint |
make_deck.py, build_deck.ps1 | El bucle y la tubería de un solo comando |
validate_presentation.ps1, inspect_pptx.py, render_slides.ps1, contact_sheet.py | Integridad, desbordamiento, RTL, lectura de animación, PNG/PDF/hoja de contactos |
4. Reglas que nunca se doblan
- Nuevo deck = nuevo perfil. Nunca trasladar la paleta, fuentes, contenedores, portada, ubicación del título o movimiento del deck anterior.
examples/*.jsonson entradas de prueba, no puntos de partida visuales. - Reutilizar solo si se solicita explícitamente.
--template deck.pptx(el usuario nombra un deck existente como plantilla) o--reuse-profile x.profile.json(el usuario quiere "el mismo diseño que antes"). Luego decir qué se mantuvo; la verificación de novedad se omite para diseños reutilizados y el archivo original nunca se modifica. Ver sección 5. - No aleatorio. Los genes se eligen mediante sorteos ponderados y con semilla a partir de los a priori derivados del tema y del historial; la misma entrada da el mismo perfil, un tema diferente (o uno repetido) da uno diferente.
- Variedad con disciplina. La composición varía diapositiva a diapositiva (marcos, contenedores, fondos, densidad, alineación, escala) mientras que la escala tipográfica, la cuadrícula, el contraste y el lenguaje geométrico del perfil mantienen unido el deck. No forzar la variedad donde una estructura consistente ayuda (por ejemplo, filas repetidas de KPI en un informe de datos); fijar con
--pin rol=variante. - La animación nunca es falsa. Decir "animado" solo para efectos encontrados en el archivo guardado mediante la lectura de vuelta; no reclamar Morph (no implementado). No animar todo: los roles estáticos (portada, agenda, referencias, tabla, cita, cierre) permanecen estáticos.
- Nunca se inventan hechos. Fidelidad a la fuente y etiquetas "Ilustrativo".
- Nunca reducir texto para que quepa. Cortar, reestructurar o dividir (> 45 palabras, > 6 viñetas, < 16 pt de cuerpo).
- Idiomas. Inglés LTR; árabe RTL (diseños reflejados, alineación a la derecha, fuentes compatibles con árabe forzadas); bilingüe por párrafo.
- Nunca reclamar una puntuación de similitud que no haya calculado y nunca afirmar haber comparado archivos que no se pudieron leer;
novelty.pyinforma archivos ilegibles.
5. Reutilización de plantilla (solo solicitudes explícitas)
--template deck.pptxmodo maestro: el deck tiene un diseño con un marcador de posición de título y mide 13.333 x 7.5 pulgadas. Las nuevas diapositivas se construyen dentro de una copia de ese archivo: su tema, patrón, marcadores de posición y fuentes se mantienen; la portada/sección/cierre usan los diseños propios de la plantilla; las diapositivas de contenido usan el marcador de posición de título de la plantilla y nuestros componentes de cuerpo debajo de él.- modo estilo: el deck toma su apariencia en cada diapositiva (un único diseño en blanco; no se admiten otros tamaños de diapositiva). La paleta y los tipos de letra se transfieren; los diseños se generan y el informe dice que no se pudo reutilizar el patrón y por qué.
--reuse-profile deck.profile.json: mismos genes que el deck anterior (los diseños aún se planifican para el nuevo contenido).
6. Procedimiento final
Entregar solo después de: el archivo se abre, el validador tiene cero errores, la auditoría de composición pasa, la verificación de novedad pasa (o el informe indica por qué se omitió), las diapositivas renderizadas se vieron y corrigieron realmente, los recuentos de animación coinciden con la afirmación.
El mensaje final indica: ruta de salida, número de diapositivas, nombre del perfil + la razón, fuentes, familias de diseño utilizadas, resultado de auditoría, resultado de novedad y contra qué se comparó, transiciones/animaciones de objetos (recuentos, método), qué no fue posible, elementos [fuente necesaria].
Los archivos están en el directorio de instalación del skill (para Claude Code, ~/.claude/skills/premium-animated-presentation/; en Windows %USERPROFILE%\.claude\skills\premium-animated-presentation\); ejecutar scripts con esa ruta absoluta.