open-design-landing
Construa um site de landing page editorial de página única (ou um deck de slides — veja a skill irmã open-design-landing-deck) no sistema de design Atelier Zero: fundo de papel quente, Inter Tight + Playfair Display, spans de ênfase itálica serifada, linhas pontilhadas finas, pontos finais de coral, movimento de revelação ao scroll e 16 placas de colagem surrealistas.
Esta é a receita canônica da página de marketing do Open Design — o exemplo de saída é exatamente a página que você vê em open-design.
A skill é totalmente parametrizada. O agente preenche um inputs.json tipado a partir do briefing do usuário; o compositor transforma esse JSON + o styles.css canônico em um artefato implantável.
inputs.json + styles.css 16 slots de imagem
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (autossuficiente)
<out>/assets/ (PNG ou SVG)
O que você obtém
Um único arquivo HTML com tudo isto:
- Topbar editorial (faixa volume / edição / idioma), navegação fixa estilo Headroom com contagem de estrelas do GitHub ao vivo.
- 8 seções numeradas em algarismos romanos com fundo texturizado de papel: hero (com 3 anéis de estatísticas + índice de 4 etapas), sobre, capacidades (4 cards), laboratórios (5 cards + pílulas de filtro + barra de progresso), método (4 etapas com miniaturas), trabalho selecionado (laje escura + 2 cards inclinados), depoimento (citação em destaque + 5 glifos de parceiros), CTA (faixa + pílula de e-mail).
- Rodapé com 4 colunas de links + palavra de destaque em itálico enorme.
- Movimento de revelação ao scroll em cada seção (IntersectionObserver, respeita
prefers-reduced-motion). - Totalmente responsivo nos breakpoints 1280 / 1080 / 880 / 560.
Contrato do fluxo de trabalho
Execute estas quatro etapas em ordem. O agente deve completar cada etapa antes de passar para a próxima, e preferir fazer ao usuário uma pergunta focada em vez de inventar texto.
1. Coletar informações da marca
Use AskQuestion (ou o equivalente em sua interface) para coletar o briefing da marca em partes; não despeje todo o schema.ts no usuário. Mapeie as respostas deles em inputs.json correspondendo à forma tipada.
Os oito grupos de perguntas, em ordem:
| Grupo | Campos do Schema | Respostas mínimas | Observações |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = glifo único (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL é obrigatória; license padrão Apache-2.0 |
| 3 | nav[] (até 5) | 3 | Badges de contagem opcionais |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | Todos | Headline como MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Todos | 4 cards × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todos | Ambas as grades têm aridade fixa |
| 7 | work.cards[2] + testimonial | Todos | 5 glifos de parceiros como dados de caminho SVG inline |
| 8 | cta + footer.{columns[4],mega} | Todos | Mega kicker é um MixedText como os headlines |
Abra inputs.example.json para um exemplo completo (o próprio Open Design).
2. Decidir a estratégia de imagens
| Estratégia | Quando escolher | Custo / latência |
|---|---|---|
placeholder | Primeira versão. Demo. Apresentação interna. Sem orçamento de imagem ainda. | $0, <1s |
generate | Entrega final. Marca quer colagens originais. | ~$0,40, ~6 min |
bring-your-own | Usuário tem PNGs com direção de arte. Coloque em assets_path. | $0, 0s |
Defina inputs.imagery.strategy de acordo.
placeholder — modo moldura
npx tsx scripts/placeholder.ts <out>/assets/
Escreve 16 arquivos .svg (com aliases .png para compatibilidade) em <out>/assets/. Cada placeholder mostra o id do slot, proporção, dimensões em pixels e a dica de prompt de image-manifest.json. Os <img src='./assets/hero.png'> do compositor etc. funcionam normalmente.
generate — modo gpt-image-2
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
Chama o endpoint síncrono openai/gpt-image-2 da fal.ai por slot. Compõe prompts como: âncora de estilo (sistema editorial colagem-papel) + variáveis da marca (nome / nav / headline / ênfase itálica extraída de inputs.json) + composição por slot (ex.: cabeça de gesso recortada + árvore crescendo através de arco). Pula slots cujo arquivo de destino já existe; passe --force para renderizar novamente.
Sem FAL_KEY, o script imprime os prompts para que o operador possa roteá-los manualmente através do comando slash /gpt-image-fal.
bring-your-own
Coloque 16 PNGs correspondentes aos nomes de arquivo de assets/image-manifest.json em inputs.imagery.assets_path. Pronto.
3. Compor o artefato
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
O compositor lê inputs.json e ../styles.css, depois escreve um arquivo HTML autossuficiente. A página inclui:
- A folha de estilo completa do Atelier Zero, inline.
- Toda a marcação das seções com atributos
data-revealpara movimento de scroll escalonado. - Script IntersectionObserver inline (espelha
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegação Headroom inline (espelha
header.tsx). - Buscador de contagem de estrelas do GitHub inline (detecta automaticamente a partir de
brand.primary_url).
4. (Opcional) Espelhar o site Astro implantável
Para saída de produção implantável, faça um fork do pacote apps/landing-page/: copie-o para seu workspace, alinhe app/page.tsx com o conteúdo do seu inputs.json, e copie seus <out>/assets/*.png para os caminhos esperados por app/image-assets.ts / URLs R2. Compile com pnpm --filter @open-design/landing-page build para uma exportação estática out/ pronta para qualquer CDN.
Uma iteração futura pode incluir um compositor que emita a árvore completa de
apps/landing-page/a partir deinputs.jsonem um único comando. Até lá, fork-e-edição é o caminho suportado.
Autoverificação antes de entregar
Antes de marcar como concluído, o agente deve verificar:
-
<out>/index.htmlabre em um navegador sem erros no console. - Todos os 16 slots de imagem carregam (sem 404 na aba Network do DevTools).
- Os spans de ênfase itálica dos headlines renderizam em Playfair (não sans).
- Pontos finais de coral aparecem no final de cada h1/h2
display. - Scroll do topo ao fim; cada seção anima uma vez.
- Redimensionar para 880px e 560px; sem scroll horizontal, sem sobreposição.
-
prefers-reduced-motion: reduce(DevTools → Rendering) desativa as transições de forma limpa. - Lighthouse: contraste AA, font-display swap, nenhum layout shift no hero (CLS < 0.05).
Arquivos nesta skill
skills/open-design-landing/
├── SKILL.md # este contrato
├── README.md # início rápido
├── schema.ts # entradas tipadas (fonte única da verdade)
├── styles.css # folha de estilo Atelier Zero (fonte única da verdade)
├── inputs.example.json # Open Design como exemplo prático
├── example.html # renderização canônica (regenerada de inputs.example.json)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # wrapper gpt-image-2 (fal.ai)
│ └── placeholder.ts # molduras SVG com textura de papel
└── assets/
├── *.png # 16 placas de colagem (instância Open Design)
├── image-manifest.json # mapeamento slot → arquivo/dimensões/prompt
└── imagegen-prompts.md # pacote de prompts legível por humanos
Limites
- Não invente novas cores ou tipografias. Os tokens estão em
design-systems/atelier-zero/DESIGN.md; estenda o sistema de design antes de adicionar uma nova rampa aqui. - Não remova atributos
data-revealda marcação gerada. Sem eles a página fica estática e parece morta. - Não envolva o HTML composto em um framework que injete sua própria ordem de folhas de estilo — o Atelier Zero depende da ordem em cascata da folha de estilo para a textura do papel e o z-index das barras laterais.
- Não adicione um arquivo de folha de estilo separado para o fork do site Astro; copie
styles.cssliteralmente paraapp/globals.csspara que a paridade visual permaneça um para um.
Veja também
skills/open-design-landing-deck/— skill irmã de slides que reutiliza este sistema de design.
