open-design-landing
Construye un sitio editorial 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, Inter
Tight + Playfair Display, énfasis en cursiva serif, reglas punteadas
finas, puntos de terminación coral, animación de revelación al hacer scroll 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 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 styles.css canónica en un artefacto desplegable.
inputs.json + styles.css 16 espacios de imagen
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autocontenido)
<out>/assets/ (PNG o SVG)
Qué 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: héroe (con 3 anillos de estadísticas + índice de 4 pasos), acerca de, capacidades (4 tarjetas), laboratorios (5 tarjetas + filtros de píldoras + barra de progreso), método (4 pasos con miniaturas), trabajo seleccionado (loseta oscura + 2 tarjetas inclinadas), testimonio (cita destacada + 5 glifos de socios), CTA (cinta + píldora de correo electrónico).
- Pie de página con 4 columnas de enlaces + una palabra enorme en cursiva serif.
- Animación de revelación al hacer scroll en cada sección (IntersectionObserver, respeta
prefers-reduced-motion). - Totalmente adaptable a los puntos de interrupción 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 preferir hacer al usuario una pregunta enfocada a inventar contenido.
1. Recopilar entradas de la marca
Usa AskQuestion (o el equivalente en tu interfaz) para recopilar el brief
de la marca en partes; no le vuelques todo el schema.ts al 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ínimas | Notas |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = glifo único (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | La URL es obligatoria; license por defecto Apache-2.0 |
| 3 | nav[] (hasta 5) | 3 | Insignias de conteo opcionales |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Todas | Headline como MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Todas | 4 tarjetas × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todas | Ambas cuadrículas de aridad fija |
| 7 | work.cards[2] + testimonial | Todas | 5 glifos de socios como datos de ruta SVG en línea |
| 8 | cta + footer.{columns[4],mega} | Todas | El mega kicker es un MixedText como los titulares |
Abre inputs.example.json para un ejemplo
completo (el propio Open Design).
2. Decidir la estrategia de imágenes
| Estrategia | Cuándo elegir | Costo / latencia |
|---|---|---|
placeholder | Primer pase. Demo. Presentación interna. Sin presupuesto de imágenes todavía. | $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 |
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 sugerencia de prompt de
image-manifest.json. Las etiquetas <img src='./assets/hero.png'>
del compositor funcionan sin más.
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 / navegación / titular / énfasis en cursiva extraídos
de
inputs.json) + composición por espacio (p. ej., cabeza de escayola recortada - árbol creciendo a través de un arco). Omite los espacios cuyo archivo de destino
ya existe; pasa
--forcepara volver a renderizar.
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 luego escribe un
archivo HTML autocontenido. La página incluye:
- La hoja de estilo completa de Atelier Zero, inline.
- Todo el marcado de las secciones con atributos
data-revealpara el movimiento de revelación escalonado al hacer scroll. - Script IntersectionObserver inline (refleja
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegación Headroom inline (refleja
header.tsx). - Obtenedor inline del contador de estrellas de GitHub (detecta automáticamente
desde
brand.primary_url).
4. (Opcional) Reflejar el sitio Astro desplegable
Para una 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 una exportación
estática en out/ lista para cualquier CDN.
Una iteración futura podría incluir un compositor que emita el árbol completo de
apps/landing-page/a partir deinputs.jsonen un solo comando. Hasta entonces, fork-y-edita 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 Red de DevTools).
- Los tramos de énfasis en cursiva del titular se renderizan en Playfair (no en sans).
- Los puntos de terminación coral aparecen al final de cada h1/h2
display. - Desplázate de arriba a abajo; cada sección anima una vez.
- Redimensiona a 880px y 560px; sin desplazamiento horizontal, sin superposición.
-
prefers-reduced-motion: reduce(DevTools → Rendering) desactiva las transiciones limpiamente. - Lighthouse: contraste AA, font-display swap, 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 práctico
├── example.html # renderizado canónico (regenerado a partir de 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 → mapeo de archivo/dimensiones/prompt
└── imagegen-prompts.md # paquete de prompts legible para 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 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 del orden de la cascada de hojas de estilo para la textura de papel y el z-index de las barras laterales.
- No añadas un archivo de hoja de estilo separado para el fork de la
página de aterrizaje de Astro; copia
styles.csstextualmente enapp/globals.csspara que la paridad visual se mantenga uno a uno.
Ver también
skills/open-design-landing-deck/— skill hermano de diapositivas que reutiliza este sistema de diseño.
