¿Qué hace open-design-landing?
Construye un sitio editorial de una 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 con span, reglas de puntos finos, puntos de terminación coral, animaciones de 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 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 composer convierte ese JSON + la hoja de estilo canónica styles.css en un artefacto desplegable.
inputs.json + styles.css 16 espacios de imagen
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autocontenido)
<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 adhesiva estilo Headroom con conteo 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), acerca de, capacidades (4 tarjetas), laboratorios (5 tarjetas + píldoras de filtro + barra de progreso), método (4 pasos con miniaturas), trabajo seleccionado (losa 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 + palabra clave enorme en cursiva serif.
- Animación scroll-reveal en cada sección (IntersectionObserver, respeta
prefers-reduced-motion). - Totalmente responsive en 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 continuar, y prefiere hacer una pregunta enfocada al usuario en lugar de inventar texto.
1. Recopilar datos de la marca
Usa AskQuestion (o su equivalente en tu UI) para recopilar el brief de marca en fragmentos; 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 schema | Respuestas mínimas | Notas |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Marca = un solo glifo (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL es obligatorio; 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 inline |
| 8 | cta + footer.{columns[4],mega} | Todos | Mega kicker es un MixedText como los headlines |
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. Diapositiva 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. Ponlos 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 marcador de posición muestra el id del espacio, la relación de aspecto, las dimensiones en píxeles y la pista de prompt de image-manifest.json. Las etiquetas <img src='./assets/hero.png'> del composer 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 prompts como: ancla de estilo (sistema editorial de collage en papel) + variables de marca (nombre / navegación / headline / é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 espacios cuyo archivo de destino ya existe; pasa --force para regenerar.
Sin FAL_KEY, el script imprime los prompts para que el operador pueda enrutarlos manualmente a través del slash-command /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. Hecho.
3. Componer el artefacto
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
El composer lee inputs.json y ../styles.css, luego escribe un único archivo HTML autocontenido. La página incluye:
- La hoja de estilo completa de Atelier Zero, incrustada.
- Todo el marcado de secciones con atributos
data-revealpara animación de scroll escalonada. - Script IntersectionObserver incrustado (refleja
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegación Headroom incrustado (refleja
header.tsx). - Cargador de conteo de estrellas de GitHub incrustado (detección automática 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 R2. Construye con pnpm --filter @open-design/landing-page build para una exportación estática out/ lista para cualquier CDN.
Una iteración futura podría incluir un composer que emita todo el árbol de
apps/landing-page/desdeinputs.jsonen un solo comando. Hasta entonces, fork-y-edición es la ruta soportada.
Autocomprobació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 404s en la pestaña de red de DevTools).
- Los spans de énfasis en cursiva en los headlines se renderizan en Playfair (no sans).
- Los puntos de terminación coral aparecen al final de cada h1/h2
display. - 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 → Representación) desactiva las transiciones limpiamente. - Lighthouse: contraste AA, intercambio de font-display, sin cambio de diseño en el hero (CLS < 0.05).
Archivos en este skill
skills/open-design-landing/
├── SKILL.md # este contrato
├── README.md # inicio rápido
├── schema.ts # inputs tipados (fuente única de verdad)
├── styles.css # hoja de estilo Atelier Zero (fuente única de verdad)
├── inputs.example.json # Open Design como ejemplo
├── example.html # renderizado canónico (regenerado 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 # mapeo espacio → archivo/dimensiones/prompt
└── imagegen-prompts.md # paquete de prompts legible para humanos
Límites
- No inventes nuevos colores o tipografías. Los tokens viven 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 del papel y el z-index de los rieles laterales.
- No agregues un archivo de hoja de estilo separado para el fork del landing page de 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 desplegable en Astro.skills/open-design-landing-deck/— skill hermano de diapositivas que reutiliza este sistema de diseño.
