O que open-design-landing faz?
Construa um site editorial de página única (ou uma apresentação de slides — veja a skill irmã open-design-landing-deck) no sistema de design Atelier Zero: fundo de papel quente, fontes Inter Tight + Playfair Display, spans de ênfase em itálico serifado, linhas finas pontilhadas, pontos terminais coral, motion de scroll-reveal e 16 placas de colagem surrealistas.
Esta é a receita canônica da página de marketing do OpenDesign — 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 brief do usuário; o composer 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 (autocontido)
<out>/assets/ (PNG ou SVG)
O que você obtém
Um único arquivo HTML com tudo isso:
- Barra superior editorial (volume / edição / faixa de idioma), navegação sticky estilo Headroom com contador 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)
- about
- capabilities (4 cartões)
- labs (5 cartões + filtros + barra de progresso)
- method (4 etapas com miniaturas)
- selected work (laje escura + 2 cartões inclinados)
- testimonial (citação de destaque + 5 glifos de parceiros)
- CTA (faixa + pílula de e-mail)
- Rodapé com 4 colunas de links + palavra de destaque enorme em itálico serifado.
- Motion de scroll-reveal em cada seção (IntersectionObserver, respeita
prefers-reduced-motion). - Totalmente responsivo nos breakpoints 1280 / 1080 / 880 / 560.
Contrato de fluxo de trabalho
Execute estas quatro etapas em ordem. O agente deve completar cada etapa antes de avançar, e preferir fazer uma pergunta focada ao usuário a inventar texto.
1. Coletar entradas da marca
Use AskQuestion (ou o equivalente na sua interface) para coletar o brief da marca em partes; não despeje todo o schema.ts no usuário. Mapeie as respostas para inputs.json de acordo com a forma tipada.
Os oito grupos de perguntas, em ordem:
| Grupo | Campos do schema | Respostas mín. | Observações |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = um único glifo (Ø, ▲, ★…) |
| 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+ponto) |
| 5 | about + capabilities.cards[4] | Todos | 4 cartões × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todos | Ambos os grids com 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 OpenDesign).
2. Decidir a estratégia de imagens
| Estratégia | Quando escolher | Custo / latência |
|---|---|---|
placeholder | Primeira passagem. Demonstração. Projeto interno. Sem orçamento de imagem ainda. | $0, <1s |
generate | Entrega final. A marca quer colagens originais. | ~$0,40, ~6 min |
bring-your-own | O usuário tem PNGs de 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 do image-manifest.json. Os <img src='./assets/hero.png'> etc. do composer funcionam perfeitamente.
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 para cada slot. Compõe prompts como: âncora de estilo (sistema editorial de colagem em 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 re-renderizar.
Sem FAL_KEY, o script imprime os prompts para que o operador possa roteá-los manualmente através da skill de slash-command /gpt-image-fal.
bring-your-own
Coloque 16 PNGs correspondendo aos nomes de arquivo do 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 composer lê inputs.json e ../styles.css, e escreve um único arquivo HTML autocontido. A página inclui:
- A folha de estilo completa do Atelier Zero, inline.
- Toda a marcação das seções com atributos
data-revealpara motion 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 do R2. Compile com pnpm --filter @open-design/landing-page build para uma exportação estática em out/ pronta para qualquer CDN.
Uma iteração futura pode incluir um composer que emita toda a árvore
apps/landing-page/a partir deinputs.jsonem um único comando. Até lá, fork-e-edite é o caminho suportado.
Autoverificação antes de entregar
Antes de marcar como concluído, o agente deve verificar:
-
<out>/index.htmlabre no navegador sem erros no console. - Todos os 16 slots de imagem carregam (sem 404 na aba de rede do DevTools).
- Spans de ênfase itálica em headlines renderizam em Playfair (não sans).
- Pontos terminais coral aparecem no final de cada
displayh1/h2. - Rolar do topo ao fim; toda seção anima uma vez.
- Redimensionar para 880px e 560px; sem scroll horizontal, sem sobreposição.
-
prefers-reduced-motion: reduce(DevTools → Rendering) desabilita transições completamente. - Lighthouse: contraste AA, font-display swap, sem layout shift no hero (CLS < 0,05).
Arquivos nesta skill
design-templates/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 do Atelier Zero (fonte única da verdade)
├── inputs.example.json # OpenDesign 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 OpenDesign)
├── image-manifest.json # mapeamento slot → arquivo/dimensões/prompt
└── imagegen-prompts.md # pacote de prompts legível
Limites
- Não invente novas cores ou famílias tipográficas. Os tokens vivem 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 sem vida. - Não envolva o HTML composto em um framework que injete sua própria ordem de folhas de estilo — o Atelier Zero depende da cascata de ordem das folhas 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 da landing page Astro; copie
styles.cssliteralmente paraapp/globals.csspara que a paridade visual permaneça de um para um.
Veja também
design-systems/atelier-zero/DESIGN.md— especificação de tokens.apps/landing-page/— contraparte estática Astro implantável.design-templates/open-design-landing-deck/— skill irmã de slides que reutiliza este sistema de design.
