open-design-landing
Construye un sitio editorial de aterrizaje de una sola página (o una presentación de diapositivas — consulta el skill hermano open-design-landing-deck) en el sistema de diseño Atelier Zero: fondo de papel cálido, tipografías Inter Tight + Playfair Display, énfasis en cursiva serif, reglas punteadas, puntos terminales de color coral, animaciones de revelación al desplazarse y 16 placas de collage surrealistas.
Esta es la receta canónica de la página de marketing de Open Design — el ejemplo de salida es la misma página que ves en open-design.
El skill está completamente parametrizado. El agente completa un inputs.json tipado a partir del brief del usuario; el compositor convierte ese JSON + la hoja de estilos canónica styles.css en un artefacto desplegable.
inputs.json + styles.css 16 espacios de imagen
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autónomo)
<out>/assets/ (PNG o SVG)
Qué obtienes
Un único archivo HTML con todo lo siguiente:
- Barra superior editorial (volumen / número / tira de idioma), navegación sticky estilo Headroom con contador de estrellas de GitHub en vivo.
- 8 secciones numeradas en números romanos con fondo de textura de papel: héroe (con 3 anillos de estadísticas + índice de 4 pasos), acerca de, capacidades (4 tarjetas), laboratorios (5 tarjetas + píldoras de filtro + barra de progreso), método (4 pasos con miniaturas), trabajos seleccionados (loseta oscura + 2 tarjetas inclinadas), testimonio (cita destacada + 5 glifos de socios), llamada a la acción (cinta + píldora de correo electrónico).
- Pie de página con 4 columnas de enlaces + enorme palabra de cierre en cursiva serif.
- Animación de revelación al desplazarse en cada sección (IntersectionObserver, respeta
prefers-reduced-motion). - Totalmente responsive en los puntos de quiebre 1280 / 1080 / 880 / 560.
Contrato del flujo de trabajo
Ejecuta estos cuatro pasos en orden. El agente debe completar cada paso antes de pasar al siguiente, y es preferible hacer una pregunta enfocada al usuario antes de inventar texto.
1. Recopilar los datos de la marca
Usa AskQuestion (o su equivalente en tu interfaz) para recopilar el brief de la marca en fragmentos; no le muestres todo el schema.ts al usuario. Mapea sus respuestas en inputs.json con la forma tipada.
Los ocho grupos de preguntas, en orden:
| Grupo | Campos del esquema | Respuestas mínimas | Notas |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = un solo glifo (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | La URL es obligatoria; licencia por defecto Apache-2.0 |
| 3 | nav[] (hasta 5) | 3 | Insignias de conteo opcionales |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Todos | Título como MixedText (sans+em+punto) |
| 5 | about + capabilities.cards[4] | Todos | 4 tarjetas × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todos | Ambas rejillas de aridad fija |
| 7 | work.cards[2] + testimonial | Todos | 5 glifos de socios como datos de ruta SVG en línea |
| 8 | cta + footer.{columns[4],mega} | Todos | La palabra de cierre mega es un MixedText como los titulares |
Abre inputs.example.json para ver un ejemplo completo (el propio Open Design).
2. Decidir la estrategia de imágenes
| Estrategia | Cuándo elegir | Costo / latencia |
|---|---|---|
placeholder | Primera pasada. Demostración. Diapositiva interna. Sin presupuesto de imágenes aún. | $0, <1s |
generate | Entrega final. La marca quiere collages originales. | ~$0.40, ~6 min |
bring-your-own | El usuario tiene PNGs de dirección de arte. Colócalos en assets_path. | $0, 0s |
Define inputs.imagery.strategy en consecuencia.
placeholder — modo marco
npx tsx scripts/placeholder.ts <out>/assets/
Escribe 16 archivos .svg (con alias .png para compatibilidad) en <out>/assets/. Cada marcador de posición muestra el ID del espacio, la relación de aspecto, las dimensiones en píxeles y la sugerencia de prompt de image-manifest.json. Los <img src='./assets/hero.png'> del compositor funcionan directamente.
generate — modo gpt-image-2
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Llama al endpoint síncrono openai/gpt-image-2 de fal.ai por espacio. Compone los prompts como: ancla de estilo (sistema editorial de collage en papel) + variables de la marca (nombre / navegación / titular / énfasis en cursiva extraídos de inputs.json) + composición por espacio (por ejemplo, cabeza de yeso recortada + árbol creciendo a través de un arco). Omite los espacios cuyo archivo de destino ya exista; pasa --force para regenerar.
Sin FAL_KEY, el script imprime los prompts para que el operador pueda enrutarlos manualmente a través del comando slash /gpt-image-fal.
bring-your-own
Coloca 16 PNGs que coincidan con los nombres de archivo de assets/image-manifest.json en inputs.imagery.assets_path. Listo.
3. Componer el artefacto
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
El compositor lee inputs.json y ../styles.css, y escribe un archivo HTML autónomo. La página incluye:
- La hoja de estilo completa de Atelier Zero, incrustada.
- Todo el marcado de las secciones con atributos
data-revealpara la animación escalonada al desplazarse. - Script incrustado de IntersectionObserver (refleja
apps/landing-page/app/_components/reveal-root.tsx). - Script incrustado de navegación Headroom (refleja
header.tsx). - Buscador de estrellas de GitHub incrustado (detecta automáticamente desde
brand.primary_url).
4. (Opcional) Replicar el sitio Astro desplegable
Para una salida de producción desplegable, bifurca el paquete apps/landing-page/: cópialo en tu espacio de trabajo, alinea app/page.tsx con el contenido de tu inputs.json y copia tus <out>/assets/*.png en las rutas esperadas por app/image-assets.ts / URLs de R2. Compila con pnpm --filter @open-design/landing-page build para obtener una exportación estática en out/ lista para cualquier CDN.
Una iteración futura podría incluir un compositor que emita todo el árbol de
apps/landing-page/a partir deinputs.jsonen un solo comando. Hasta entonces, bifurcar y editar es la ruta compatible.
Autoverificación antes de entregar
Antes de marcar como completado, el agente debe verificar:
-
<out>/index.htmlse abre en un navegador sin errores de consola. - Los 16 espacios de imagen cargan (sin 404 en la pestaña de red de DevTools).
- Los énfasis en cursiva de los titulares se renderizan en Playfair (no en sans).
- Los puntos terminales de color coral aparecen al final de cada
displayh1/h2. - Desplazarse de arriba a abajo; cada sección se anima una vez.
- Redimensionar a 880px y 560px; sin desplazamiento horizontal, sin superposición.
-
prefers-reduced-motion: reduce(DevTools → Renderizado) deshabilita las transiciones limpiamente. - Lighthouse: contraste AA, intercambio de fuente en
font-display, sin cambio de diseño en el héroe (CLS < 0.05).
Archivos en este skill
skills/open-design-landing/
├── SKILL.md # este contrato
├── README.md # inicio rápido
├── schema.ts # entradas tipadas (fuente única de verdad)
├── styles.css # hoja de estilo Atelier Zero (fuente única de verdad)
├── inputs.example.json # Open Design como ejemplo
├── example.html # renderización canónica (regenerada de inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # envoltorio de gpt-image-2 (fal.ai)
│ └── placeholder.ts # marcos SVG con textura de papel
└── assets/
├── *.png # 16 placas de collage (instancia de Open Design)
├── image-manifest.json # espacio → mapeo de archivo/dimensiones/prompt
└── imagegen-prompts.md # paquete de prompts legible por humanos
Límites
- No inventes nuevos colores o tipografías. Los tokens están en
design-systems/atelier-zero/DESIGN.md; extiende el sistema de diseño antes de añadir un nuevo valor aquí. - No elimines los atributos
data-revealdel marcado generado. Sin ellos, la página se vuelve estática y se siente muerta. - No envuelvas el HTML compuesto en un framework que inyecte su propio orden de hojas de estilo — Atelier Zero depende de la cascada de orden de las hojas de estilo para la textura del papel y el z-index de las barras laterales.
- No añadas un archivo de hoja de estilo separado para la bifurcación del sitio Astro de aterrizaje; copia
styles.csstextualmente enapp/globals.csspara que la paridad visual se mantenga uno a uno.
Ver también
design-systems/atelier-zero/DESIGN.md— especificación de tokens.apps/landing-page/— contraparte estática Astro desplegable.skills/open-design-landing-deck/— skill hermano de diapositivas que reutiliza este sistema de diseño.
