CommunityImagengithub.com

poster-skills

Crea diapositivas HTML pulidas a partir de plantillas PPT. Ideal para trabajo web-PPT en TRAE: extracción maestra, diseños cqw/cqh, control visual, diapositivas responsivas o exportación 8K.

¿Qué es poster-skills?

Esta habilidad permite transformar plantillas PPT universitarias, institucionales o empresariales en diapositivas HTML editables, escalables proporcionalmente y exportables en alta definición. Sigue un flujo completo que incluye: descomposición de la plantilla en una capa maestra con restricciones fijas (banner, logo, colores, fuentes, cuadrícula); generación página por página aplicando diseños basados en contenido (usando unidades `cqw/cqh` para escalado responsivo); inspección visual automatizada mediante capturas de pantalla en modo headless del navegador (Edge); y exportación a PNG de alta resolución, incluyendo 8K (7680×4320) mediante factor de escala de dispositivo 4×. Es especialmente útil para entornos TRAE donde se requiere crear, modificar y auditar presentaciones web con consistencia visual y sin pérdida de calidad al escalar. La habilidad prioriza la localización de assets (imágenes, fuentes, SVG inline) y establece criterios estrictos de aprobación: sin barras de desplazamiento, sin elementos superpuestos, sin imágenes rotas, y con la maestra invariante en todas las páginas. También incluye indicaciones reutilizables para generar nuevas páginas, reparar problemas visuales o ajustar texto, así como una tabla de problemas comunes y sus soluciones.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CanFlyhang/poster-skills/tree/HEAD

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Flujo de trabajo para diapositivas web PPT en TRAE

Convierte plantillas PPT de universidades, instituciones o empresas en diapositivas HTML editables, escalables proporcionalmente y exportables en alta definición. Se forma un ciclo completo mediante "restricciones maestras + diseño página por página + inspección por captura + exportación con navegador sin cabeza".

Escenarios de uso

  • Crear diapositivas web PPT a partir de plantillas PPT, capturas de referencia o HTML maestros existentes.
  • Unificar el banner, logo, colores, fuentes y cuadrícula de toda la presentación.
  • Usar TRAE para generar, modificar, reparar superposiciones o ajustar texto página por página.
  • Exportar lotes de diapositivas HTML como PNG de alta definición, incluyendo imágenes 8K de 7680×4320.

Si el usuario solicita un .pptx editable a nivel de objetos, debe usarse una herramienta PPTX; no se deben hacer pasar imágenes HTML por PowerPoint editable.

Confirmación antes de comenzar

Prioriza leer los materiales existentes del usuario, no solicites información que ya esté disponible en el espacio de trabajo.

  1. Base de la plantilla: PPT, imagen de referencia, página HTML maestra o guía de marca.
  2. Contenido de las páginas: esquema, títulos de cada página, puntos clave, datos, imágenes y referencias.
  3. Especificaciones fijas: relación de aspecto, color principal, fuentes, logo, encabezado/pie de página y elementos que deben conservarse.
  4. Formato de entrega: archivo fuente HTML, assets locales, vista previa, imagen 8K o punto de entrada de exportación.

Cuando falte información no crítica, usa valores predeterminados razonables: 16:9, fuentes del sistema, assets locales, inspección a 1920×1080. Solo pregunta si la falta de contenido bloquea la creación.

Principios fundamentales

  1. Primero descomponer la maestra, luego escribir las páginas: no adivinar el estilo mientras se genera.
  2. Los elementos de la maestra son invariables: banner, logo, color principal, posición del título y cuadrícula del área de contenido no deben desplazarse página a página.
  3. Dimensiones relativas del diseño: usa cqw/cqh para posición, ancho, alto, tamaño de fuente y espaciado; no mezcles con px fijos para controlar el diseño.
  4. Una estructura de expresión principal por página: las páginas adyacentes deben evitar repeticiones sin sentido como "imagen a la izquierda, texto a la derecha", excepto en casos especiales como páginas de comparación.
  5. Assets localizados: no dependas de servicios de imágenes temporales; las fotos reales deben tener una fuente clara; para imágenes conceptuales, prioriza SVG inline.
  6. Inspección por captura de cada página: que el código no tenga errores no significa que la imagen sea correcta; debes ver el resultado renderizado.
  7. Modificaciones mínimas: al reparar problemas en una sola página, no reorganices otros módulos ni modifiques toda la maestra sin necesidad.

Flujo de trabajo estándar

Paso 1: Descomponer la plantilla y establecer invariantes

Extrae y registra de la plantilla de referencia:

CategoríaContenido a confirmar
BannerFondo, posición del logo, posición del título, líneas decorativas, altura fija
ColoresColor principal, colores secundarios, color del texto, escala de grises, reglas de uso del color de énfasis
FuentesFuente del título, fuente del texto, jerarquía de tamaños, peso de fuente
CuadrículaMárgenes laterales izquierdo/derecho, inicio del área de contenido, espaciado entre columnas, posición del pie de página
VariablesTítulo de cada página, subtítulo, estructura del texto, imágenes y gráficos

Prioriza el uso de fuentes del sistema para evitar que fuentes externas fallen en diferentes ordenadores. Cuando sea necesario replicar una imagen de referencia, convierte en restricciones estrictas "posición, tamaño, fuente, combinación de colores coinciden con la referencia", no solo "estilo similar".

Paso 2: Construir la base técnica 16:9

Todas las páginas comparten la misma lógica de contenedor:

/* Contenedor de diapositiva: mantiene 16:9 y habilita unidades de consulta de contenedor. */
.slide {
  width: min(100vw, calc(100vh * 16 / 9));
  aspect-ratio: 16 / 9;
  position: relative;
  overflow: hidden;
  container-type: size;
}

/* Elementos de la página: posicionados relativamente al contenedor, mantienen proporción al escalar la ventana. */
.title {
  position: absolute;
  top: 6.5cqh;
  left: 4cqw;
  font-size: 2.5cqw;
}

container-type: size es clave para que cqw/cqh funcionen. En un lienzo de 1920×1080, 1cqw = 19.2px, 1cqh = 10.8px. Al reducir la ventana, ampliar la proyección o exportar en alta resolución, la proporción del diseño se mantiene.

Paso 3: Crear la página maestra

Primero completa un número reducido de páginas base, luego genera el resto en lote:

  • Portada: título principal, presentador, unidad, fecha y elementos visuales de marca.
  • Página maestra de contenido: banner fijo, área de título, cuadrícula de contenido y pie de página.
  • Página de cierre: conclusiones, agradecimientos o referencias, según el contenido.

Una vez aprobada la maestra, úsala como base estructural y de estilo para las páginas siguientes. Antes de modificar una página existente, debes leer el archivo, no adivinar la estructura por el nombre del archivo.

Paso 4: Generar página por página, ajustando la estructura del contenido

Cada vez que generes una nueva página, especifica cinco puntos:

  1. En qué página maestra te basas y qué elementos permanecen invariables.
  2. Relación de aspecto, nombre de archivo y ubicación de guardado.
  3. Título de esta página, puntos clave, datos y conclusión.
  4. Diseño utilizado en esta página y diferencias con páginas anteriores.
  5. Fuente de las imágenes, requisitos de localización y restricciones de derechos de autor.

Puedes elegir el diseño según el contenido; no sacrifiques la expresión de la información por buscar novedad:

Tipo de contenidoEstructura recomendada
PortadaTítulo grande centrado, banner de marca, una imagen principal
Elementos paralelosMatriz de tarjetas de igual ancho, columnas comparativas
Procesos y etapasEscalera, línea de tiempo, banner progresivo
Relaciones de causa-efectoCadena, flechas de flujo, irradiación central
Concepto centralDiagrama central + anotaciones alrededor
Estructura y funcionamientoDiagrama de sección, esquema SVG + puntos clave
Datos y panelesGráficos, tarjetas de indicadores, panel doble
Información multidimensionalCuadrícula 2×2, matriz, tarjetas agrupadas
ConclusiónTesis central, eje vertical de cierre, pocos números clave
ReferenciasPortada de documento o captura de fuente + lista normativa
AgradecimientosTexto corto en fuente grande + imagen principal, evitar apilamiento de módulos

Paso 5: Seleccionar el método de imágenes

Elige según esta prioridad:

  1. Fotos reales: prioriza materiales proporcionados por el usuario o con licencia clara; para materiales públicos, verifica la licencia y registra la fuente.
  2. SVG inline: adecuado para conceptos que no se pueden fotografiar directamente, como redes cristalinas, defectos, secciones transversales, procesos, cadenas causales.
  3. Gráficos CSS: adecuados para decoraciones simples como escalones, barras de espectro, insignias, fondos de indicadores.

Todas las imágenes deben guardarse localmente y verificar las rutas de referencia. No uses imágenes de IA sin relación con el contenido para rellenar el diseño.

Paso 6: Inspección visual página por página

En Windows, puedes usar el modo headless de Edge para generar imágenes de inspección de 1920×1080. Ajusta según la ruta real del navegador y del archivo:

$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --screenshot="_chk.png" "file:///absolute/path/to/page.html"

Revisa página por página:

  • La página se muestra completa en 16:9, sin barras de desplazamiento inesperadas.
  • No hay elementos desbordados, recortados, superpuestos o con espaciado insuficiente entre módulos.
  • Todas las imágenes se cargan correctamente, sin marcadores de posición en blanco ni imágenes rotas.
  • La jerarquía de títulos, texto y notas al pie es clara, sin palabras huérfanas ni saltos de línea anómalos.
  • El banner, logo, colores y cuadrícula coinciden con la maestra.
  • Los datos, unidades, años, términos y referencias son coherentes.
  • Al reducir la ventana, la escala se mantiene proporcional; ningún elemento con píxeles fijos rompe el diseño.

Si encuentras un problema, primero localiza la causa raíz, modifica solo los estilos o elementos relevantes, y vuelve a tomar la captura para verificar. Al eliminar elementos como marcas de esquina o encabezados, verifica el HTML, CSS y título de página correspondientes para evitar residuos.

Paso 7: Exportar imágenes de alta definición

Usa una ventana de 1920×1080 con factor de escala de dispositivo 4× para exportar PNG de 7680×4320:

& $edge --headless=new --disable-gpu --hide-scrollbars `
  --virtual-time-budget=6000 --window-size=1920,1080 `
  --force-device-scale-factor=4 `
  --screenshot="export/page.png" "file:///absolute/path/to/page.html"

Este método hace que el navegador renderice texto, CSS y SVG a alta escala, no estira una imagen de baja resolución a 8K.

Para exportación por lotes, prioriza reutilizar scripts existentes del proyecto. Después de que el proceso termine, confirma que los archivos existan, tengan el tamaño correcto y se hayan escrito completamente; no te bases solo en el código de salida del comando para determinar el éxito.

Paso 8: Organizar los entregables

Se recomienda mantener una estructura de directorios clara y reutilizable:

project/
├── 001.html ... NNN.html
├── assets/
│   ├── images/
│   └── logos/
├── export/
└── html2img_8k.py        # Proporcionar si el proyecto ya lo tiene o el usuario lo solicita

Al entregar, enumera los archivos fuente, el directorio de assets, el directorio de exportación y la información que aún debe ser complementada por el usuario. No mezcles capturas temporales de inspección con los resultados formales.

Indicaciones reutilizables

Generar una nueva página

Genera [nombre del nuevo archivo de página] basado en [ruta de la página maestra]:
1. Mantén 16:9, banner, logo, fuentes, colores y cuadrícula sin cambios;
2. El título es [título], el contenido incluye [punto A] [punto B] [punto C];
3. Usa el [diseño especificado], diferenciándose de la estructura de las páginas adyacentes;
4. Usa cqw/cqh para posicionamiento, tamaño, tamaño de fuente y espaciado dentro de la página;
5. Localiza las imágenes e indica la fuente; después de completar, realiza una captura de inspección a 1920×1080.

Reparar problemas visuales

Localiza la causa raíz de [superposición/desbordamiento/imagen rota/salto de línea] en [módulo específico] en [ruta de la página];
repara solo el problema relevante, mantén otros módulos y la maestra sin cambios; después de la modificación, vuelve a tomar la captura para verificar.

Ajustar texto

Reemplaza [texto original] en [ruta de la página] con [nuevo texto];
mantén el diseño existente; verifica la visualización en una sola línea, palabras huérfanas, desbordamiento y espaciado entre módulos.

Problemas comunes

ProblemaPrioridad de revisión
cqw/cqh no funcionaVerificar si el contenedor tiene container-type: size y si el elemento está dentro de ese contenedor
La fuente cambia al cambiar de ordenadorSi se usa una fuente externa o no instalada; cambiar a una pila de fuentes del sistema
Imagen en blanco o 404Nombre de archivo, mayúsculas/minúsculas, ruta relativa, caracteres especiales y espacios de ancho cero
Nombre de archivo contiene espacio de ancho cero U+200BRenombrar el archivo o codificar el carácter como %E2%80%8B
Módulo invade el área del títuloVerificar el inicio del área de contenido, altura del módulo, cantidad de elevación de escalera si es excesiva
Párrafo con palabra huérfanaOptimizar primero el texto, luego ajustar el tamaño de fuente o el ancho del contenedor
El estilo de la página se desvía gradualmenteVerificar si se omitió la maestra y se improvisó; volver a verificar las invariantes
Imagen 8K borrosaVerificar si se usó factor de escala de dispositivo 4× para rerenderizar, no si se amplió una captura existente
Archivo exportado incompletoVerificar si se esperó a que la página renderice y el archivo se escriba completamente

Criterios de finalización

Solo se considera completado cuando se cumplen todas las siguientes condiciones:

  • La maestra y todas las páginas tienen un estilo coherente; la estructura de las páginas de contenido sirve a la expresión de la información.
  • Todas las páginas nuevas o modificadas han sido verificadas mediante renderizado real.
  • Las referencias a imágenes, fuentes, logos y scripts son utilizables; los assets están localizados.
  • El tamaño de las imágenes exportadas cumple los requisitos; la salida 8K es de 7680×4320.
  • El directorio de entrega es claro; los archivos temporales están separados de los resultados formales.

Skills relacionados