Communitygithub.com

open-design-landing

Construye un sitio editorial de una página con el sistema de diseño Atelier Zero (papel cálido, collage surrealista, desplazamiento con revelado).

¿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) con la estética visual de Atelier Zero, utilizada por Open Design. El proceso comienza con la recolección de datos de marca a través de preguntas estructuradas, que se almacenan en un archivo `inputs.json` tipado. El agente puede optar por tres estrategias de imágenes: usar marcadores de posición (sin costo), generar 16 collages únicos mediante la API gpt-image-2 (con costo y latencia), o permitir que el usuario proporcione sus propias imágenes. Luego, un compositor (`compose.ts`) toma el `inputs.json` y la hoja de estilos canónica `styles.css` para generar un único archivo HTML autónomo. Este HTML incluye navegación adhesiva estilo Headroom, animaciones de revelado al desplazarse (scroll-reveal), y es completamente responsivo. Como paso opcional, el agente puede replicar el contenido en un proyecto Astro desplegable (`apps/landing-page/`). El skill está diseñado para agentes como Claude Code, Cursor y Codex, y su flujo de trabajo está estrictamente definido para garantizar coherencia visual y funcional.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/cosmasgicter/mihasv3/tree/HEAD/.kiro/skills/open-design-templates/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 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, tramos de énfasis en serifa cursiva, reglas punteadas, puntos de terminación coral, animación de revelado al desplazarse y 16 láminas de collage surrealista.

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 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)

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 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 clave en cursiva con serifa.
  • Animación de revelado al desplazarse 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 continuar, y preferir hacer una pregunta enfocada al usuario antes de inventar texto.

1. Recopilar datos de marca

Usa AskQuestion (o el equivalente en tu interfaz) para recopilar el brief de la marca en fragmentos; no le muestres todo el schema.ts al usuario. Mapea sus respuestas en inputs.json con 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}TodosTitular como MixedText (sans+em+punto)
5about + capabilities.cards[4]Todos4 tarjetas × {num,tag,title,body}
6labs.cards[5] + method.steps[4]TodosAmbas cuadrículas de aridad fija
7work.cards[2] + testimonialTodos5 glifos de socios como datos de ruta SVG en línea
8cta + footer.{columns[4],mega}TodosMega palabra clave 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

EstrategiaCuándo elegirCosto / latencia
placeholderPrimer pase. Demo. Interno. 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 según corresponda.

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. El <img src='./assets/hero.png'> del compositor, etc., funciona 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 exista; pasa --force para volver a renderizar.

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, inline.
  • Todo el marcado de las secciones con atributos data-reveal para la animación de desplazamiento escalonada.
  • Script inline de IntersectionObserver (refleja apps/landing-page/app/_components/reveal-root.tsx).
  • Script inline de navegación Headroom (refleja header.tsx).
  • Cargador inline de conteo 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, bifurca el 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 out/ lista para cualquier CDN.

Una iteración futura puede incluir un compositor que emita todo el árbol apps/landing-page/ desde inputs.json en un solo comando. Hasta entonces, bifurcar y editar es la vía compatible.


Autoverificación antes de entregar

Antes de marcar como terminado, el agente debe verificar:

  • <out>/index.html se 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 de terminación coral aparecen al final de cada display h1/h2.
  • Desplazarse 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 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 estilos Atelier Zero (fuente única de verdad)
├── inputs.example.json      # Open Design como ejemplo
├── example.html             # renderización canónica (regenerada 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 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 elimines atributos data-reveal del marcado generado. Sin ellos, la página se vuelve estática y sin vida.
  • 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 estilos separado para la bifurcación de la landing page de Astro; copia styles.css textualmente en app/globals.css para que la paridad visual sea uno a uno.

Ver también

Individual skills in this repo

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

cosmasgicter/mihasv3

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

cosmasgicter/mihasv3

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

cosmasgicter/mihasv3

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

cosmasgicter/mihasv3

Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.

Skills relacionados