O que galyarder-design-landing faz?
Construa um site editorial de página única (ou um deck de slides — veja o skill irmão galyarder-design-landing-deck) no sistema de design Atelier Zero: fundo de papel quente, Inter Tight + Playfair Display, spans de ênfase em itálico serifado, réguas pontilhadas finas, pontos finais coral, animação scroll-reveal e 16 placas de colagem surreais.
Esta é a receita canônica da página de marketing da Galyarder Design — o exemplo de saída é a própria página que você vê em galyarder-design.
O skill é totalmente parametrizado. 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:
- Topbar editorial (faixa volume / edição / idioma), navegação pegajosa 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), labs (5 cards + filtros por pílula + 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-chave enorme em itálico serifado.
- Animação 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 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 interface) para coletar o brief da marca em partes; não despeje o schema.ts inteiro no usuário. Mapeie as respostas deles para inputs.json seguindo 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+ponto) |
| 5 | about + capabilities.cards[4] | Todas | 4 cards × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | Todas | Ambos grids de 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 os headlines |
Abra inputs.example.json para um exemplo completo (a própria Galyarder Design).
2. Decidir a estratégia de imagens
| Estratégia | Quando escolher | Custo / latência |
|---|---|---|
placeholder | Primeira passagem. Demo. Slide 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-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 de image-manifest.json. Os <img src='./assets/hero.png'> do compositor funcionam sem problemas.
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; passe --force para re-renderizar.
Sem FAL_KEY, o script imprime os prompts para que o operador possa roteá-los manualmente através do comando de barra /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, então escreve um único arquivo HTML autocontido. A página inclui:
- A stylesheet completa do Atelier Zero, inline.
- Marcação de todas as seções com atributos
data-revealpara animação scroll escalonada. - Script IntersectionObserver inline (espelha
apps/landing-page/app/_components/reveal-root.tsx). - Script de navegação Headroom inline (espelha
header.tsx). - Buscador inline 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, 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. Construa com pnpm --filter @galyarder-design/landing-page build para uma exportação estática out/ pronta para qualquer CDN.
Uma iteração futura pode empacotar 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 de rede do DevTools).
- Spans de ênfase em itálico nos headlines renderizam em Playfair (não sans).
- Pontos finais coral aparecem no final de cada h1/h2 de exibição.
- Role 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) desabilita transições corretamente. - Lighthouse: contraste AA, font-display swap, sem layout shift no hero (CLS < 0.05).
Arquivos neste skill
skills/galyarder-design-landing/
├── SKILL.md # este contrato
├── README.md # início rápido
├── schema.ts # inputs tipados (fonte única da verdade)
├── styles.css # stylesheet Atelier Zero (fonte única da verdade)
├── inputs.example.json # Galyarder Design como exemplo trabalhado
├── 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 Galyarder Design)
├── image-manifest.json # slot → mapeamento arquivo/dimensões/prompt
└── imagegen-prompts.md # pacote de prompts legível por humanos
Limites
- Não invente novas cores ou tipografias. 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 ordenação de stylesheet — o Atelier Zero depende da cascata de ordenação de stylesheet para textura de papel e z-index das barras laterais.
- Não adicione um arquivo de stylesheet 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 Astro estática implantável.skills/galyarder-design-landing-deck/— skill irmão de slides que reutiliza este sistema de design.
