Communitygithub.com

open-design-landing

Produce un sitio de aterrizaje editorial de una sola página, de clase mundial, en el lenguaje visual de Atelier Zero (collage editorial Monocle / Apartamento / Études): la misma estética que Open Design utiliza para su propia superficie de marketing.

¿Qué es open-design-landing?

Este skill habilita a un agente de IA para construir un sitio de aterrizaje editorial autónomo de una sola página, utilizando el sistema de diseño Atelier Zero. El agente recopila datos de marca a través de preguntas estructuradas, completa un archivo `inputs.json` y opcionalmente genera 16 activos de collage mediante gpt-image-2. Luego ejecuta un compositor de función pura que emite un archivo HTML autocontenido con estilos CSS en línea, scripts de animación (scroll-reveal) y navegación sticky tipo Headroom. También ofrece una ruta separada para reflejar el contenido en un sitio Astro desplegable en `apps/landing-page/`. Es ideal para fundadores, estudios de diseño y mantenedores de OSS que necesitan una página de marketing editorial premium sin fricción, con múltiples estrategias de imagen (placeholder, generación automática o imágenes propias) y parámetros de formato de salida (HTML standalone, Astro o ambos).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Keimoshi/Silverloft/tree/HEAD/open-design-port/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 de aterrizaje editorial de una sola página (o una presentación — ver 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 de puntos finos, puntos terminales coral, movimiento 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 misma página que ves en open-design.

El skill está completamente parametrizado. El agente completa un inputs.json tipado a partir del briefing del usuario; el compositor 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)

Qué obtienes

Un único archivo HTML con todo lo siguiente:

  • Barra superior editorial (volumen / número / selector de idioma), navegación sticky tipo 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 + palabra de cierre gigante en cursiva serif.
  • Movimiento de scroll-reveal en cada sección (IntersectionObserver, respeta prefers-reduced-motion).
  • Completamente responsivo en los puntos de ruptura 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 una pregunta enfocada al usuario en lugar de inventar texto.

1. Recopilar datos de marca

Usa AskQuestion (o su equivalente en la interfaz) para recopilar el briefing de la marca en fragmentos; no vuelques todo schema.ts al usuario. Mapea sus respuestas en inputs.json ajustándose a la forma tipada.

Los ocho grupos de preguntas, en orden:

GrupoCampos del esquemaRespuestas mínimasNotas
1brand.{name,mark,tagline,description,location}5Mark = un solo glifo (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL es obligatorio; licencia por defecto Apache-2.0
3nav[] (hasta 5)3Distintivos de conteo opcionales
4hero.{label,headline,lead,primary,secondary,stats}TodasHeadline 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 SVG en línea
8cta + footer.{columns[4],mega}TodasMega 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 imagen

EstrategiaCuándo elegirCosto / latencia
placeholderPrimer pase. Demo. Diapositiva interna. Sin presupuesto de imagen aún.$0, <1s
generateEntrega final. La marca quiere collages originales.~$0.40, ~6 min
bring-your-ownEl 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, las dimensiones en píxeles y la sugerencia de prompt de image-manifest.json. Los <img src='./assets/hero.png'> del compositor funcionan sin problemas.

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 prompts como: anclaje 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 (por ejemplo, cabeza de yeso recortada + árbol creciendo a través de un arco). Omite espacios cuyo archivo de destino ya existe; usa --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, luego escribe un archivo HTML autocontenido. La página incluye:

  • La hoja de estilo completa de Atelier Zero, en línea.
  • Todo el marcado de las secciones con atributos data-reveal para el movimiento de scroll escalonado.
  • Script inline de IntersectionObserver (refleja apps/landing-page/app/_components/reveal-root.tsx).
  • Script inline de navegación Headroom (refleja header.tsx).
  • Script inline de obtención de 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 obtener una exportación estática en out/ lista para cualquier CDN.

Una iteración futura podría incluir un compositor que genere el árbol completo de apps/landing-page/ a partir de inputs.json en un solo comando. Hasta entonces, fork-y-edición es la ruta recomendada.


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 del titular se renderizan en Playfair (no sans).
  • Aparecen puntos terminales coral al final de cada display h1/h2.
  • Desplazamiento 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 → Rendering) desactiva las transiciones limpiamente.
  • Lighthouse: contraste AA, font-display swap, sin cambios 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 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  # mapeo espacio → archivo/dimensiones/prompt
    └── imagegen-prompts.md  # paquete de prompts legibles por humanos

Límites

  • No inventes nuevos colores o tipografías. Los tokens residen 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-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 del papel y el z-index de los rieles laterales.
  • No añadas un archivo de hoja de estilo separado para el fork del landing page en 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