O que open-design-landing faz?
Construa um site editorial de página única (ou uma apresentação — veja a skill irmã open-design-landing-deck) no sistema de design Atelier Zero: fundo de papel quente, Inter Tight + Playfair Display, ênfases em itálico serifado, réguas pontilhadas finas, pontos de terminação coral, movimento de revelação por scroll e 16 placas de colagem surreais.
Esta é a receita canônica da página de marketing da Open Design — o exemplo de saída é a própria 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 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 (autocontido)
<out>/assets/ (PNG ou SVG)
O que você obtém
Um único arquivo HTML com tudo isso:
- Barra superior editorial (volume / edição / idioma), navegação fixa estilo Headroom com contagem ao vivo de estrelas do GitHub.
- 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.
- Movimento de revelação por scroll 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 prosseguir e preferir fazer uma pergunta focada ao usuário a inventar texto.
1. Coletar entradas da marca
Use AskQuestion (ou o equivalente na sua UI) para coletar o brief da marca em partes; não despeje o schema.ts inteiro no usuário. Mapeie as respostas para inputs.json no formato tipado.
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ório; licença padrão Apache-2.0 |
| 3 | nav[] (até 5) | 3 | Crachás 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 cartões × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todos | Ambas as grades de 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 (a própria Open Design).
2. Decidir a estratégia de imagem
| Estratégia | Quando escolher | Custo / latência |
|---|---|---|
placeholder | Primeira passada. Demonstração. Slide interno. 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 de direção de arte. Coloque-os 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. As tags <img src='./assets/hero.png'> do compositor funcionam diretamente.
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 em itálico extraídos 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; use --force para regerar.
Sem FAL_KEY, o script imprime os prompts para que o operador possa roteá-los manualmente pela skill de comando /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, e escreve um único arquivo HTML autocontido. A página inclui:
- A folha de estilos completa do Atelier Zero, inline.
- Marcação de todas as seções com atributos
data-revealpara movimento de scroll escalonado. - Script inline do IntersectionObserver (espelha
apps/landing-page/app/_components/reveal-root.tsx). - Script inline da navegação Headroom (espelha
header.tsx). - Script inline de busca de contagem de estrelas do GitHub (detecta automaticamente de
brand.primary_url).
4. (Opcional) Espelhar o site Astro implantável
Para saída de produção implantável, 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-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 Network do DevTools).
- Ênfases em itálico no headline renderizam em Playfair (não em sans).
- Pontos de terminação coral aparecem no final de cada
displayh1/h2. - Rolagem do topo ao fim; cada seção anima uma vez.
- Redimensione 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, sem deslocamento de layout 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 estilos 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 texturizadas em 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 ordenação 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 estilo separado para o fork da landing page Astro; copie
styles.cssliteralmente paraapp/globals.csspara que a paridade visual permaneça 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.skills/open-design-landing-deck/— skill irmã de slides que reutiliza este sistema de design.
