Communitygithub.com

open-design-landing

Construye un sitio editorial de una página (o una presentación de diapositivas) en el sistema de diseño Atelier Zero, inspirado en el estilo de OpenDesign, con collage generado por IA.

¿Qué es open-design-landing?

Este skill permite a un agente de IA generar un sitio web editorial de una sola página (landing page) completamente funcional, utilizando el sistema de diseño Atelier Zero (estilo Monocle / Apartamento / Études). El flujo de trabajo está altamente parametrizado: el agente recopila información de la marca del usuario a través de un cuestionario estructurado y la escribe en un archivo `inputs.json` tipado. Luego, puede generar 16 placas de collage únicas mediante `gpt-image-2` (a través de fal.ai) o usar marcadores de posición. Finalmente, un compositor de funciones puras toma el JSON y la hoja de estilos canónica `styles.css` para emitir un único archivo HTML autónomo con navegación sticky estilo Headroom, animaciones de aparición al hacer scroll, tipografía Inter Tight + Playfair Display, y un diseño completamente responsivo. Está diseñado para el sistema OpenDesign y es compatible con cualquier agente que pueda ejecutar TypeScript (como Claude Code, Cursor, o Codex). El skill también ofrece una ruta opcional para generar una versión desplegable como sitio Astro en `apps/landing-page/`.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/open-design-landing

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

open-design-landing preview

Documentación

¿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, tramos de énfasis en cursiva serif, reglas punteadas finas, puntos terminales coral, animaciones de aparición al hacer scroll y 16 placas de collage surrealistas.

Esta es la receta canónica de la página de marketing de OpenDesign — el ejemplo de salida es la misma página que ves en open-design.

El skill está completamente parametrizado. El agente rellena 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 / idioma), navegación sticky estilo Headroom con contador de estrellas de GitHub en vivo.
  • 8 secciones numeradas en números romanos con fondo texturizado de papel: héroe (con 3 anillos de estadísticas + índice de 4 pasos), acerca de, capacidades (4 tarjetas), laboratorios (5 tarjetas + filtros + 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 + gran palabra de cierre en cursiva serif.
  • Animaciones de aparición al hacer scroll en cada sección (IntersectionObserver, respeta prefers-reduced-motion).
  • Completamente responsivo en los puntos de interrupción 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 prefiere hacer una pregunta enfocada al usuario en lugar de inventar texto.

1. Recopilar inputs de la marca

Usa AskQuestion (o su equivalente en tu interfaz de usuario) para recopilar el brief de la marca en partes; no le muestres todo el schema.ts al usuario. Mapea sus respuestas en inputs.json siguiendo la forma tipada.

Los ocho grupos de preguntas, en orden:

GrupoCampos del esquemaRespuestas mínimasNotas
1brand.{name,mark,tagline,description,location}5Marca = un solo glifo (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL es obligatorio; licencia por defecto Apache-2.0
3nav[] (hasta 5)3Insignias de conteo opcionales
4hero.{label,headline,lead,primary,secondary,stats}TodasTitular como MixedText (sans+em+punto)
5about + capabilities.cards[4]Todas4 tarjetas × {num,tag,title,body}
6labs.cards[5] + method.steps[4]TodasAmbas cuadrículas de aridad fija
7work.cards[2] + testimonialTodas5 glifos de socios como datos de ruta SVG en línea
8cta + footer.{columns[4],mega}TodasLa mega palabra de cierre es un MixedText como los titulares

Abre inputs.example.json para ver un ejemplo completo (OpenDesign mismo).

2. Decidir la estrategia de imagen

EstrategiaCuándo elegirCosto / latencia
placeholderPrimer pase. Demo. Presentación interna. Sin presupuesto de imágenes aún.$0, <1s
generateEntrega final. La marca quiere collages originales.~$0.40, ~6 min
bring-your-ownEl 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 marcador de posición muestra el id del espacio, la relación, las dimensiones en píxeles y la sugerencia de prompt de image-manifest.json. Los <img src='./assets/hero.png'> del compositor, etc., 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 cada 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 (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 regenerar.

Sin FAL_KEY, el script imprime los prompts para que el operador pueda enrutarlos manualmente a través del 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 único archivo HTML autónomo. La página incluye:

  • La hoja de estilos completa de Atelier Zero, incrustada en línea.
  • Todo el marcado de las secciones con atributos data-reveal para la animación de scroll escalonada.
  • 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).
  • Cargador de contador de estrellas de GitHub en línea (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 / las 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 de inputs.json en un solo comando. Hasta entonces, la bifurcación y edición es la ruta compatible.


Autoverificación antes de entregar

Antes de marcar como completado, el agente debe verificar:

  • <out>/index.html se abre en un navegador sin errores de consola.
  • Los 16 espacios de imagen se cargan (sin 404s en la pestaña de red de DevTools).
  • Los tramos de énfasis en cursiva de los titulares se renderizan en Playfair (no en sans).
  • Los puntos terminales coral aparecen al final de cada h1/h2 de display.
  • Desplazarse de arriba a abajo; cada sección se anima una vez.
  • Redimensionar a 880px y 560px; sin scroll horizontal, sin superposición.
  • prefers-reduced-motion: reduce (DevTools → Rendering) desactiva las transiciones limpiamente.
  • Lighthouse: contraste AA, font-display swap, sin desplazamiento de diseño en el héroe (CLS < 0.05).

Archivos en este skill

design-templates/open-design-landing/
├── SKILL.md                 # este contrato
├── README.md                # inicio rápido
├── schema.ts                # inputs tipados (fuente única de verdad)
├── styles.css               # hoja de estilos de Atelier Zero (fuente única de verdad)
├── inputs.example.json      # OpenDesign como ejemplo trabajado
├── example.html             # renderización canónica (regenerado desde 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 OpenDesign)
    ├── image-manifest.json  # mapeo de espacio → archivo/dimensiones/prompt
    └── imagegen-prompts.md  # paquete de prompts legible por 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 omitas los atributos data-reveal del 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 estilos separado para la bifurcación de la página de destino de Astro; copia styles.css textualmente en app/globals.css para que la paridad visual se mantenga uno a uno.

Ver también

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados