Communitygithub.com

kimsh-1/deck-factory

Una línea de intención → un deck HTML de estilo editorial oscuro con calidad de presentación. Una skill para Claude Code.

¿Qué es deck-factory?

Deck Factory es una skill para Claude Code que transforma un brief o manuscrito en una presentación HTML de calidad profesional, con un estilo editorial oscuro y diseño de alto nivel. Está diseñada para ensamblar manualmente diapositivas (slides) como elementos `<section class="slide">` en 1920×1080, siguiendo un sistema de tokens y componentes validado con la producción de un deck premium de 12 páginas. La skill impone ocho reglas críticas (como el uso de un canvas near-black `#08090A`, una jerarquía tipográfica de tres niveles con números grandes, y un layout de 13 ranuras) que diferencian un resultado profesional de uno amateur. Además, proporciona un checklist de validación para garantizar que cada diapositiva cumpla con los estándares. Deck Factory no es un pipeline automático, sino un contrato de diseño que Claude ejecuta paso a paso, incluyendo la renderización a PNG mediante Chromium headless.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add kimsh-1/deck-factory

Preguntar en tu IA favorita

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

Documentación

deck-factory — Deck HTML editorial oscuro con calidad de presentación

Recibe un brief/manuscrito y construye diapositivas HTML que parecen presentaciones comerciales. Una diapositiva = un <section class="slide"> de 1920×1080. Se construye a mano pero con tokens/componentes validados.

Este es un método probado (se ha renderizado un deck premium de 12 páginas). No es un pipeline automático; la promesa de esta skill es que Claude ensambla las diapositivas siguiendo este contrato de diseño. Las 6 fases del pipeline automático (storyline→copy→compose→grade→export) son una hoja de ruta deseada que se trata solo en reference.md.

Estas 8 reglas diferencian lo profesional de lo amateur

  1. Canvas near-black #08090A — Prohibido el negro puro (#000). Las superficies suben en escalera (bg-1/2/3).
  2. no_box — Prohibidas las tarjetas grises rellenas. El fondo sigue la escalera de superficies; la separación se hace con hairline blanco alfa rgba(255,255,255,.07). Prohibidas sombras, focos y gradientes atmosféricos.
  3. Un acento por diapositiva — El color de señal se usa solo en un lugar: ceja, métrica o regla. El abuso de chips multicolor es lo más hortera.
  4. Jerarquía de tres niveles con números grandes — Etiqueta (11px mute) > Valor (140~172px, peso 600, tnum) > Contexto (una frase). En diapositivas de estadísticas, la altura de render del número ≥120px. Prohibidas las notas al pie de fuente.
  5. Cabecera/pie en 4 esquinas — Chip de marca arriba a la izquierda, parte/fecha arriba a la derecha, autor abajo a la izquierda, página abajo a la derecha (05 / 12). Común a todas las diapositivas.
  6. Esqueleto editorial — Ceja (mayúsculas, acento) → Título de acción que termina en punto ("Dos meses, 100 millones.") → 1 objeto dominante → Cola (1 línea de pista sobre hairline). Prohibidos los títulos con listas de sustantivos.
  7. Seguridad CJK — Sin word-break: keep-all; overflow-wrap: normal; line-break: strict;, el coreano se rompe por sílabas.
  8. Jerarquía por tamaño y tracking — Prohibido abusar del peso. ≤3 tamaños de fuente por diapositiva. Tracking negativo para display -0.03em.

Procedimiento para construir diapositivas

  1. Configuración — Copia assets/styles.css para usarlo. Cada diapositiva lleva <link rel="stylesheet" href="styles.css"> + fuente (fonts.css). Dentro de <section class="slide">, el orden es: .bg (fondo/imagen) → .deck-brand/.deck-meta/.deck-author/.deck-page (4 esquinas) → .frame (contenido).
  2. Cromo maestro — Coloca primero la cabecera/pie en 4 esquinas. Este es el esqueleto de cada diapositiva. Los ejemplos slide-01 (portada) y slide-05 (estadísticas) están en work/premium/slides/.
  3. Elegir layout — Solo con uno del vocabulario de 13 ranuras: cover · chapter · statement · bullets · two-col · cards-3 · data-split · image-full · image-split · flow · chart-bar · kpi-3 · closing. Prohibido inventar nuevos layouts.
  4. Rellenar el esqueleto — .eyebrow → .action-title (punto) → .subhead (opcional) → Objeto dominante → .tail (opcional). Una diapositiva = 1 objeto dominante (una frase/una comparación/una estadística/un diagrama).
  5. Números grandes — Si es una estadística: .stat-row > .stat (.k etiqueta / .v número + <small>unidad/.multmúltiplo / .c caption). 3 columnas repeat(3,1fr).
  6. Profundidad de imagen — Portada y capítulos: héroe a sangre completa + pantalla de texto con linear-gradient(90deg,#08090A,transparent 60%). Diapositivas de datos: héroe aislado en la ranura vertical derecha + resplandor de baja luz. Prohibido componer texto sobre la imagen generada con código (solo con prompt).
  7. Render — Captura cada slide-NN.html como PNG de 1920×1080 con Chromium headless. Consejos para WSL/incrustación de fuentes en reference.md.

Checklist de aprobación (todo debe ser SÍ para ser profesional)

  • Canvas #08090A near-black, 0 cajas grises rellenas
  • Diapositiva de estadísticas: números grandes ≥120px + jerarquía valor>etiqueta>contexto (sin notas al pie de fuente)
  • Cabecera/pie en 4 esquinas presente en todas las diapositivas
  • Esqueleto: ceja (acento) → título de acción (punto) → objeto dominante → cola
  • 1 acento por diapositiva, 0 chips multicolor
  • 0 textos rotos (restos de binding como 출처:조회)
  • Portada/datos con imagen héroe + pantalla/resplandor de profundidad
  • 0 saltos de línea rotos en coreano (keep-all)

Si algún elemento es NO, no es profesional: corrígelo y vuelve a intentarlo.

Más información (reference.md)

  • Tabla completa de tokens de color · Escala tipográfica (11~172px) · Pilas de fuentes
  • CSS por componente y cuándo usarlo: bigNumber · flow · bento · timeline · codeBlock · numberedStep · before/after mockup · semicircleGauge
  • Vocabulario detallado de 13 layouts
  • Cómo cambiar de perfil oscuro a claro/documento
  • Consejos para render con WSL/Chromium headless (problemas de incrustación de fuentes base64)
  • Principios de prompts para generación de imágenes (prohibido componer texto)
  • Hoja de ruta del pipeline deseado (storyline→export)

Skills relacionados