open-design-landing
Construye un sitio editorial de una sola página (o una presentación de diapositivas — ver la skill hermana open-design-landing-deck) en el sistema de diseño Atelier Zero: fondo de papel cálido, Inter Tight + Playfair Display, tramos de énfasis en cursiva serif, reglas punteadas, puntos terminales color coral, movimiento scroll-reveal y 16 láminas de collage surrealistas.
Esta es la receta canónica de la página de marketing de Open Design — el ejemplo de salida es la propia página que ves en open-design.
La skill está completamente parametrizada. El agente llena un inputs.json tipado a partir del brief del usuario; el compositor convierte ese JSON + la styles.css canónica 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)
Lo que obtienes
Un único archivo HTML con todo lo siguiente:
- Barra superior editorial (volumen / número / 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: hero (con 3 anillos de estadísticas + índice de 4 pasos), about, capabilities (4 tarjetas), labs (5 tarjetas + píldoras de filtro + barra de progreso), method (4 pasos con miniaturas), selected work (loseta oscura + 2 tarjetas inclinadas), testimonial (cita destacada + 5 glifos de socios), CTA (cinta + píldora de email).
- Pie de página con 4 columnas de enlaces + enorme palabra final en cursiva serif.
- Animación scroll-reveal en cada sección (IntersectionObserver, respeta
prefers-reduced-motion). - Totalmente responsivo en los puntos de quiebre 1280 / 1080 / 880 / 560.
Contrato de flujo de trabajo
Ejecuta estos cuatro pasos en orden. El agente debe completar cada paso antes de pasar al siguiente y preferir hacer al usuario una pregunta enfocada en lugar de inventar texto.
1. Recopilar los datos de la marca
Usa AskQuestion (o el equivalente en tu interfaz) para recopilar el brief de la marca por partes; no vuelques todo el schema.ts sobre el usuario. Mapea sus respuestas en inputs.json que coincida con la forma tipada.
Los ocho grupos de preguntas, en orden:
| Grupo | Campos del esquema | Respuestas mín. | Notas |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = un solo glifo (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | 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 | Headline como MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Todos | 4 tarjetas × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todos | Ambas cuadrículas 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 | Mega kicker 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 | Primer paso. Demo. Presentación 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 con dirección de arte. Colócalos en assets_path. | $0, 0s |
Establece 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 placeholder muestra el id del espacio, la relación de aspecto, las dimensiones en píxeles y la pista del prompt de image-manifest.json. El <img src='./assets/hero.png'> del compositor, etc., simplemente funcionan.
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 marca (nombre / nav / titular / énfasis en cursiva extraídos de inputs.json) + composición por espacio (p. ej., cabeza de yeso recortada + árbol creciendo a través de un arco). Omite los espacios cuyo archivo de destino ya existe; pasa --force para volver a renderizar.
Sin FAL_KEY, el script imprime los prompts para que el operador pueda enrutarlos manualmente a través de la skill de 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, luego escribe un archivo HTML autónomo. La página incluye:
- La hoja de estilo completa de Atelier Zero, en línea.
- Todo el marcado de secciones con atributos
data-revealpara movimiento scroll escalonado. - Script IntersectionObserver en línea (refleja
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegación Headroom en línea (refleja
header.tsx). - Obtenedor de conteo de estrellas de GitHub en línea (detecta automáticamente desde
brand.primary_url).
4. (Opcional) Reflejar el sitio Astro desplegable
Para la salida de producción desplegable, haz un fork del 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. Construye con pnpm --filter @open-design/landing-page build para obtener una exportación estática out/ lista para cualquier CDN.
Una iteración futura puede incluir un compositor que emita el árbol completo de
apps/landing-page/desdeinputs.jsonen un solo comando. Hasta entonces, fork-y-edita es la ruta compatible.
Autoverificación antes de entregar
Antes de marcar como terminado, 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 tramos de énfasis en cursiva del titular se renderizan en Playfair (no en sans).
- Los puntos terminales color coral aparecen al final de cada
displayh1/h2. - Desplázate de arriba a abajo; cada sección se anima una vez.
- Redimensiona a 880px y 560px; sin desplazamiento horizontal, sin superposición.
-
prefers-reduced-motion: reduce(DevTools → Rendering) deshabilita las transiciones limpiamente. - Lighthouse: contraste AA, font-display swap, sin cambio de diseño en el hero (CLS < 0.05).
Archivos en esta 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 trabajado
├── example.html # renderizado canónico (regenerado desde inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # envoltorio gpt-image-2 (fal.ai)
│ └── placeholder.ts # marcos SVG con textura de papel
└── assets/
├── *.png # 16 láminas de collage (instancia de Open Design)
├── image-manifest.json # espacio → archivo/dimensiones/prompt mapeo
└── 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 agregar una nueva rampa 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 hojas de estilo para la textura de papel y el z-index de los rieles laterales.
- No agregues un archivo de hoja de estilo separado para el fork del sitio de aterrizaje Astro; 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 hermana de diapositivas que reutiliza este sistema de diseño.
