Lo que hace esta skill
Trata una presentación como una construcción, no como un documento:
| Artefacto | Rol |
|---|---|
template.pptx | la cadena de herramientas — sus diapositivas son el catálogo de arquetipos. Siempre requerido. |
deck.mdx | la fuente — el único archivo que alguien edita |
assets/*.svg | arte generado, también fuente — solo contenido, sin diseño |
deck.pptx | el artefacto construido — se regenera completamente cada vez |
deck.pdf + vistas previas | lo que una persona realmente mira — el único lugar donde el diseño se ve |
Cada diapositiva de salida es un clon de una diapositiva de la plantilla con su contenido intercambiado, por lo que el diseño de la plantilla sobrevive byte por byte. Nada se diseña desde cero.
Motor: scripts/deck.py (invocar con una ruta absoluta).
Recolorar (cualquier pptx; para una presentación ya construida, recolorar template.pptx y reconstruir): scripts/ppt_keycolor_changer.py, procedimiento y preajustes en references/recolor.md — descubrir, mapear por luminosidad, confirmar, reemplazar, verificar.
Mandatos Permanentes
- Nunca construir sin una plantilla de referencia. No hay diseño de presentación incorporado ni respaldo. Si el usuario no te ha dado un
.pptx, detente y pide uno — no ensambles diapositivas de otra manera, no ofrezcas una presentación genérica, no fabriques una plantilla. El motor también lo rechaza, pero la petición te corresponde a ti, antes de cualquier trabajo. - El archivo fuente es
deck.mdx, nuncadeck.md. Se compila, no se lee. El motor rechaza cualquier otra extensión. - Catalogar antes de escribir. Nunca redactes
deck.mdxbasándote en una suposición sobre la plantilla. Ejecutacatalogy escribe contra los identificadores de ranura que imprime. - Nunca edites manualmente el pptx de salida. Se regenera en la siguiente construcción. Las correcciones van en
deck.mdx. - Ejecuta
checkantes debuildy muestra al usuario las advertencias. Las advertencias de desbordamiento son lo que separa el texto abarrotado de una diapositiva que nadie puede leer. - La visibilidad decide, no la pulcritud.
| transparentes correcto cuando el contenido de la imagen sigue siendo legible sobre la diapositiva;checkdice cuándo no lo sería, y un panel detrás de la imagen es la mejor respuesta allí. No recurras a la transparencia porque suene más limpio. - Nunca recortes contenido sin decirlo.
checkinforma el porcentaje; repítelo al usuario y ofrece| fit. Una imagen que pierde la mitad de sí misma es el mismo defecto que una fila de tabla que se cae de la diapositiva. - Nunca crees manualmente el arte de una ranura de imagen como binario. Escribe el SVG para que la presentación siga siendo reproducible a partir de texto. Un PNG que alguien pegó no se puede regenerar, recolorar ni revisar en un diff.
- Una presentación la leen personas, así que mírala. Cuando haya un renderizador disponible, termina con
render, no conbuild— la auditoría de diseño y las vistas previas de página son el único lugar donde aparecen las colisiones de texto. Si no hay renderizador disponible, dilo claramente en el informe en lugar de insinuar que se verificó el diseño. - Nunca inventes un arquetipo. Si ninguna diapositiva de la plantilla se ajusta al contenido, dilo y pregunta si se debe reformular el contenido o ampliar la plantilla — no hagas aproximaciones.
- Informa las advertencias que decidiste ignorar. Una advertencia de desbordamiento que decidiste que estaba bien sigue perteneciendo al informe final — el usuario es quien verá la diapositiva.
- Los gráficos son de solo lectura. Dilo explícitamente cuando el arquetipo elegido tenga uno; los números de la plantilla se envían a menos que el usuario edite el gráfico en PowerPoint.
Proceso
Paso 0 · Obtener la plantilla de referencia
Pide el .pptx antes de cualquier otra cosa si no tienes uno:
"레퍼런스 템플릿 pptx를 주세요. deck-builder는 템플릿 슬라이드를 복제하는 방식이라, 템플릿 없이는 만들 수 있는 슬라이드가 없습니다."
No continúes con una descripción de una plantilla, una presentación de aspecto similar o una promesa de proporcionarla más tarde.
Paso 1 · Catalogar la plantilla
python3 /abs/path/scripts/deck.py catalog \
--template "template.pptx" --output "deck.catalog.md"
Imprime cada arquetipo como @s1…@sN con sus ranuras, lo que la plantilla muestra actualmente y una estimación de capacidad. Léelo antes de cualquier otra cosa.
Paso 2 · Mapear el contenido a los arquetipos
Pregunta al usuario por el contenido si no lo tienes. Luego, antes de escribir cualquier md, muestra un plan de una línea por diapositiva:
1. @s1 Portada — Título + subtítulo
2. @s3 Resumen — 3 viñetas + una conclusión
3. @s7 Números — Tabla de 4 filas
Obtén la aprobación del plan. La elección incorrecta del arquetipo es el error costoso, no la redacción incorrecta.
Paso 3 · Escribir deck.mdx
---
template: template.pptx
template_hash: 5f84440a3521 # del catálogo — fija la presentación a la estructura de la plantilla
output: deck.pptx
---
## @s3
title: Resumen del trimestre
text1:
- p99 de respuesta **2,1s → 340ms**
- Tasa de fallos de despliegue 12% → 0,4%
table1:
| Métrica | Antes | Después |
| p99 | 2,1s | 340ms |
pic1: assets/arch.svg
notes: Menciona primero la fuente de los números
text5: !drop
Las imágenes toman un modo de ajuste — | fit mantiene la imagen completa, el predeterminado fill la recorta — y | transparent elimina el fondo de un PNG. Las ranuras que omitas mantienen el contenido de la plantilla.
La sintaxis completa — formas de ranura, !drop, notes:, énfasis en línea, niveles de esquema, y contra qué protege template_hash — está en references/mdx-syntax.md. Léelo antes de escribir la primera diapositiva.
Paso 3b · Generar el arte que la presentación necesita
Escribe el arte de una ranura de imagen como un .svg, en los colores de la plantilla y en el tamaño exacto en pt del marco — ambos impresos por catalog. Se convierte en fuente como el resto de la presentación y se rasteriza a PNG en el momento de la construcción.
Reglas, fundamentos y un ejemplo práctico: references/generated-art.md.
Paso 4 · Verificar
python3 /abs/path/scripts/deck.py check --deck deck.mdx
Los errores deben corregirse. Las advertencias son decisiones subjetivas — saca a la luz cada una, incluidas las que decidas ignorar.
| Qué mide | Contra qué |
|---|---|
| Una tabla o texto que se sale de la diapositiva | el borde de la diapositiva — un error, nombrando las filas perdidas |
| Una línea demasiado ancha para una ranura que la plantilla mantiene en una línea | el propio marco de esa ranura, en em, para que el Hangul no se cuente como latín |
| Una ranura que contiene mucho menos de lo que la plantilla pone allí | el volumen propio de la plantilla — el marco se dibujó para esa cantidad y la diapositiva abre un hueco |
| Texto que se extiende más abajo de lo que el diseño lo coloca | el recuento de líneas propio de la plantilla, y lo que se encuentra debajo |
| Pérdida de recorte, dpi efectivo, desviaciones de paleta, bordes de cuadros pegados | el marco, la pantalla y la paleta de la plantilla |
| Texto sobre una imagen | los píxeles realmente detrás de ella: 3:1 para texto grande, 4,5:1 para cuerpo |
Una imagen dibujada después de las palabras que cubre es un error — terminan detrás de la imagen.
Cada estimación aquí está calibrada contra el contenido propio de la plantilla en lugar de un absoluto, porque la mayoría de los marcos están dibujados para contener texto que ya se ajusta. Los márgenes de menos de una línea están más allá de lo que una estimación estática puede resolver: solo el Paso 6 resuelve esos.
Paso 5 · Construir
python3 /abs/path/scripts/deck.py build --deck deck.mdx [--output out.pptx] [--strict]
El mismo deck.mdx siempre produce un pptx byte-idéntico.
Paso 6 · Renderizar y mirar
python3 /abs/path/scripts/deck.py render --deck deck.mdx
Construye, convierte a través de LibreOffice, escribe vistas previas PNG de cada página y audita la geometría renderizada — overlap (dos marcos de texto chocan), bunched (las líneas dentro de un marco están más juntas de lo normal para ese marco, por lo que el texto ha superado su cuadro), off-slide (el renderizador lo cortó). Limpio significa limpio: la auditoría compara entre marcos y mide el interlineado contra la mediana de cada marco, por lo que las fuentes CJK cuyo cuadro em excede una línea al 100% no lo activan.
render primero dice cuáles de las tipografías de la plantilla no tiene el renderizador. Una fuente sustituida reajusta cada línea, por lo que hasta que esas estén instaladas, los saltos de línea de la vista previa son los del sustituto, no los de la presentación — la solución es instalar la fuente, no acortar las palabras. El pptx mismo siempre nombra las caras correctas.
Lee las vistas previas para el diseño, no para el espaciado. LibreOffice rellena la unión entre CJK y latín por defecto, por lo que 평균 42분 se renderiza como 평균 42 분 en la vista previa mientras que el pptx mantiene la cadena original. Verifica <a:t> en el archivo construido antes de tratar el espaciado como un defecto.
El renderizador es soffice en PATH o DECK_RENDER_DOCKER=<imagen>. Sin ninguno, render se niega en lugar de pretender que se verificó el diseño — dilo y recurre a build.
Plantilla de Salida
Informe después de una construcción:
Construcción completada — <ruta de salida>
Diapositivas: <N> · Plantilla: <nombre> · Imágenes: <M> insertadas
Inspección de renderizado — 0 superposiciones (o: El título de la página 3 se superpone con el cuerpo)
Arquetipos utilizados
@s1 ×1 Portada
@s3 ×4 Cuerpo
Revisión necesaria
· Diapositiva 3, title 58 caracteres (marco ~39 caracteres/línea) — se desborda a dos líneas
· Diapositiva 5, chart1 — Los valores del gráfico son los de la plantilla
Para la próxima modificación, solo edita deck.mdx y vuelve a ejecutar build. El pptx de salida se pierde si lo tocas manualmente.
Lo que hace Claude / Lo que haces tú
| Claude | Tú |
|---|---|
| Pide el pptx de referencia, se niega a continuar sin él | Proporcionas la plantilla — obligatoria — y el contenido en bruto |
Ejecuta catalog, lee el mapa de ranuras | Revisas la lista de arquetipos |
| Propone el plan de arquetipos por diapositiva | Apruebas o reorganizas el plan |
Escribe y revisa deck.mdx | Editas deck.mdx directamente cuando prefieras |
Ejecuta check, informa cada advertencia | Decides si una advertencia de desbordamiento es relevante |
Ejecuta render, mira las vistas previas, informa colisiones | Abres el pptx, editas gráficos si es necesario |
Limitaciones
Las seis que cambian lo que puedes prometer:
| Límite | Consecuencia |
|---|---|
| Sin nuevos diseños | Cada diapositiva es un clon. El contenido sin arquetipo necesita ampliar la plantilla en PowerPoint — dilo en lugar de aproximarte. |
| Una plantilla es obligatoria | Sin diseño incorporado, sin respaldo. |
| Los gráficos no se pueden escribir | build deja los números de la plantilla. Usa un SVG en una ranura de imagen. |
| Los marcos nunca se mueven | Escribe corto y el espacio permanece; check lo informa, solo la plantilla puede cerrarlo. |
| La verdad del diseño necesita un renderizador | check estima y no puede resolver márgenes de menos de una línea. Solo render ve lo que choca. |
| La legibilidad es solo PNG | El texto sobre un fondo JPEG o SVG no se puntúa; los colores de texto heredados se dejan intactos. |
Tabla completa, y qué paso detecta cada uno: references/limits.md.
Skills Relacionadas
write:plans(propósito del documento) — desarrolla el contenido antes de mapearlo a diapositivasthink:untangle-thoughts— convierte notas dispersas en la estructura diapositiva por diapositiva que necesita el Paso 2