O que open-design-landing faz?
Construa um site editorial de página única (ou uma apresentação de slides — consulte o skill irmão open-design-landing-deck) no sistema de design Atelier Zero: fundo de papel envelhecido, Inter Tight + Playfair Display, ênfase em itálico serifado, linhas finas pontilhadas, pontos terminais coral, animações de revelação por rolagem e 16 placas de colagem surrealistas.
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.
O skill é totalmente parametrizado. 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 / 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), sobre, capacidades (4 cards), laboratórios (5 cards + filtros + barra de progresso), método (4 etapas com miniaturas), trabalhos selecionados (laje escura + 2 cards inclinados), depoimento (citação em destaque + 5 glifos de parceiros), CTA (faixa + pílula de email).
- Rodapé com 4 colunas de links + palavra de destaque em itálico serifado gigante.
- Animação de revelação por rolagem 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 prefira fazer uma pergunta focada ao usuário em vez de inventar texto.
1. Coletar entradas da marca
Use AskQuestion (ou o equivalente em sua interface) para coletar o brief da marca em partes; não despeje todo o schema.ts no usuário. Mapeie as respostas em 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 = 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} | Todas | Headline como MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | Todas | 4 cards × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todas | Ambas as grades com aridade fixa |
| 7 | work.cards[2] + testimonial | Todas | 5 glifos de parceiros como dados de path SVG inline |
| 8 | cta + footer.{columns[4],mega} | Todas | Mega kicker é um MixedText como as headlines |
Abra inputs.example.json para um exemplo completo (própria Open Design).
2. Decidir a estratégia de imagem
| Estratégia | Quando escolher | Custo / latência |
|---|---|---|
placeholder | Primeira passagem. 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/
Gera 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. As tags <img src='./assets/hero.png'> do composer 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 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 através do slash-command /gpt-image-fal.
bring-your-own
Coloque 16 PNGs com nomes de arquivo correspondentes a 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 arquivo HTML autocontido. A página inclui:
- A folha de estilo completa do Atelier Zero, incorporada.
- Marcação de todas as seções com atributos
data-revealpara animação de rolagem escalonada. - Script IntersectionObserver incorporado (espelha
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegação Headroom incorporado (espelha
header.tsx). - Buscador de contagem de estrelas do GitHub incorporado (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 espaço de trabalho, alinhe app/page.tsx com o conteúdo de 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 composer 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 no navegador sem erros no console. - Todos os 16 slots de imagem carregam (sem 404s na aba de rede do DevTools).
- Ênfase em itálico nas headlines renderiza em Playfair (não sans).
- Pontos terminais coral aparecem no final de cada
displayh1/h2. - Role do topo ao fim; cada seção anima uma vez.
- Redimensione para 880px e 560px; sem rolagem horizontal, sem sobreposição.
-
prefers-reduced-motion: reduce(DevTools → Rendering) desativa transições de forma limpa. - Lighthouse: contraste AA, font-display swap, sem mudança de layout no hero (CLS < 0.05).
Arquivos neste 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 texturizadas 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 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 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 cascata de ordem de folhas de estilo para a textura de papel e 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 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ão de slides que reutiliza este sistema de design.
