Slide studio

Slide Studio

Construir una experiencia educativa para exposición en vivo, no un documento académico comprimido en slides. Mantener el .pptx editable como fuente canónica.

Contrato

• Tratar el PPT base como evidencia de contenido, no como referencia visual, salvo instrucción expresa.
• Conservar información, imágenes, cifras, citas y significado. Permitir reordenar, dividir, fusionar y cambiar la cantidad de slides.
• No inventar afirmaciones, fuentes, datos, personas ni resultados.
• Aplicar correcciones ortográficas, gramaticales y de naturalidad con registro. Requerir aprobación para cambios de argumento, significado o tono.
• Priorizar calidad sobre precio al investigar plantillas. No comprar ni activar servicios pagos sin aprobación.
• Entregar un PPTX 16:9 editable, animado y funcional sin internet. Considerar el PDF opcional y secundario.

1. Inicializar

Resolver como raíz la carpeta indicada por el usuario o el directorio actual. Ejecutar:

python "<skill-dir>\scripts\init_slide_project.py" "<raíz>"
powershell -ExecutionPolicy Bypass -File "<skill-dir>\scripts\check_powerpoint.ps1" -Json

Crear únicamente:

_inputs/
outputs/
.slide-studio/
  state.json
  revisions/
  archive/

No mover ni reclasificar físicamente los materiales de _inputs/. Mantener inventario y decisiones en state.json. Detenerse si PowerPoint de escritorio no está disponible, porque no se pueden garantizar las animaciones.

2. Resolver el modo de entrada

Leer workflow.md.

Con PPT base

Tratar el archivo y sus materiales como condición suficiente. Inspeccionar todas las slides, notas, relaciones, objetos, imágenes, tablas, gráficos, fuentes y animaciones existentes. No pedir información que pueda inferirse responsablemente.

Sin PPT base

Preguntar progresivamente por tema, audiencia, duración, objetivo de aprendizaje y fuentes. Si algún dato no está disponible, continuar con una inferencia declarada. Auditar fuentes y aprobar contenido, referencias y estructura narrativa antes de investigar plantillas o diseñar.

3. Auditar contenido

Crear dentro de state.json un ledger que asigne cada elemento original a preservado, corregido, reubicado, reconstruido, reemplazo-propuesto o exclusión-propuesta. Ninguna exclusión puede ser silenciosa.

• Leer text-audit.md y aplicar su auditoría para detectar y corregir patrones artificiales sin alterar significado ni aplanar el registro académico.
• Registrar texto original, texto propuesto, razón y nivel mecánico o material.
• Aplicar correcciones mecánicas automáticamente. Incluir las materiales en el corte de aprobación.
• Verificar afirmaciones mediante fuentes académicas primarias u oficiales actuales. Señalar incertidumbre, contradicciones y referencias faltantes; nunca completar una cita inventándola.
• Mantener bloques [Sources] en las notas para afirmaciones e imágenes externas.
• Reconstruir gráficos como elementos editables cuando sea viable y conservar cada cifra exactamente.

4. Elegir dirección visual

Abrir un bloque de decisión independiente. Buscar en la web tres plantillas premium orientadas a charlas, clases o cursos académicos. Exigir:

• PPTX nativo editable o exportación verificada sin pérdidas;
• suficiente variedad de layouts para el contenido real;
• legibilidad en proyección, jerarquía educativa y estética no genérica;
• sistema coherente de transiciones y revelados al clic;
• licencia y precio identificados.

Mostrar previews, procedencia, compatibilidad, limitaciones y recomendación. No producir el deck hasta que el usuario elija, combine, delegue o rechace. Si una compra es necesaria, detenerse para autorización y obtención legítima del archivo.

Combinar en un único corte: auditoría de contenido, cambios materiales y selección de plantilla.

5. Resolver imágenes

Aplicar esta jerarquía:

1. Extraer el original incrustado.
2. Buscar la misma imagen mediante búsqueda inversa, metadatos y fuente original.
3. Sustituir automáticamente solo una coincidencia exacta, de mayor calidad y con uso permitido; registrar origen.
4. Pedir aprobación para imágenes parecidas, pagas o de licencia incierta.
5. Limpiar, reencuadrar o reescalar moderadamente.
6. Reducir protagonismo o cambiar composición si la calidad sigue siendo insuficiente.

Buscar SVG para logos. Reconstruir capturas, gráficos o texto fotografiado cuando corresponda. No usar generación para alterar evidencia, personas, productos, documentos o resultados. Usar imagegen únicamente para recursos ilustrativos nuevos y claramente no probatorios.

6. Construir el deck completo

Usar obligatoriamente el skill Presentations y su implementación con @oai/artifact-tool. Leer sus reglas y recursos requeridos antes de construir. Cuando la plantilla elegida sea un PPTX, usar su modo de seguimiento de plantilla. No usar el PPT precario como fuente visual salvo que el usuario lo solicite.

Crear directamente la presentación completa después del corte de aprobación; no crear un mini-PPTX. Guardar cada iteración en .slide-studio/revisions/<id>/.

Diseñar para enseñanza en vivo:

• una función narrativa y un mensaje principal por slide;
• aperturas, transiciones conceptuales y cierre deliberados;
• densidad compatible con exposición oral;
• variedad de composiciones sin perder sistema;
• notas existentes preservadas, y solo modificadas cuando contradigan el resultado o el usuario lo pida;
• fuentes incrustables o reemplazables por equivalentes seguros.

7. Añadir y validar movimiento nativo

Leer motion.md. Añadir movimiento después de generar el PPTX editable:

powershell -ExecutionPolicy Bypass -File "<skill-dir>\scripts\apply_motion.ps1" `
  -Deck "<revisión.pptx>" -Manifest "<motion.json>"

powershell -ExecutionPolicy Bypass -File "<skill-dir>\scripts\inspect_motion.ps1" `
  -Deck "<revisión.pptx>" -Output "<motion-audit.json>"

Usar transiciones sobrias para cambios de sección y revelados al clic para pasos, preguntas, respuestas, comparaciones y diagramas progresivos. No animar todo ni usar efectos por ornamento. Validar la secuencia en PowerPoint de escritorio; un PDF o render estático no valida movimiento.

8. Validar, promover e iterar

Leer qa.md. Renderizar e inspeccionar todas las slides completas y reconciliar el ledger de contenido. No entregar con desbordamientos, solapamientos, baja resolución evitable, fuentes rotas, datos alterados, fuentes falsas o animaciones sin verificar.

Promover la revisión aprobada:

python "<skill-dir>\scripts\promote_revision.py" "<raíz>" "<revisión.pptx>" `
  --pdf "<opcional.pdf>" --comparison "<opcional.pdf>" --changes "<cambios.txt>"

Mantener en outputs/ solo nombres estables:

• presentacion-final.pptx
• presentacion-final.pdf, si se solicita
• comparativa.pdf
• cambios.txt

Mover entregables anteriores a .slide-studio/archive/. Iterar sobre una nueva revisión y promover únicamente el artefacto exacto que haya pasado las validaciones.

Skills y herramientas

• Usar Presentations como motor obligatorio de PPTX.
• Usar la auditoría interna de text-audit.md como corrector controlado.
• Usar búsqueda web y navegador real para plantillas, licencias, imágenes y fuentes.
• Usar imagegen solo bajo las restricciones de imágenes anteriores.
• No usar python-pptx.