Communitygithub.com

open-design-landing

Constrói um site editorial de página única no sistema de design Atelier Zero, com colagens surrealistas e motion de scroll-reveal.

O que é open-design-landing?

Esta skill cria um site de landing page editorial de alta qualidade, inspirado no visual das revistas Monocle, Apartamento e Études, utilizando o sistema de design Atelier Zero. O agente preenche um arquivo `inputs.json` tipado a partir de um brief da marca e, opcionalmente, gera 16 imagens de colagem via `gpt-image-2`. Em seguida, executa um composer que produz um único arquivo HTML autocontido, ou, como alternativa, pode espelhar o site Astro de marketing em `apps/landing-page/`. O resultado inclui navegação sticky estilo Headroom, motion de scroll-reveal em todas as seções e design responsivo. A skill é útil para equipes que desejam um site editorial sofisticado e parametrizável, economizando horas de trabalho manual de design e desenvolvimento. Suporta execução local com Node.js/TypeScript e integração opcional com fal.ai para geração de imagens. O processo é guiado por um contrato de fluxo de trabalho que garante consistência e qualidade.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/open-design-landing

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

open-design-landing preview

Documentação

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:

GrupoCampos do schemaRespostas mín.Observações
1brand.{name,mark,tagline,description,location}5Mark = um único glifo (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL é obrigatória; license padrão Apache-2.0
3nav[] (até 5)3Badges de contagem opcionais
4hero.{label,headline,lead,primary,secondary,stats}TodosHeadline como MixedText (sans+em+ponto)
5about + capabilities.cards[4]Todos4 cartões × {num,tag,title,body}
6labs.cards[5] + method.steps[4]TodosAmbos os grids com aridade fixa
7work.cards[2] + testimonialTodos5 glifos de parceiros como dados de caminho SVG inline
8cta + footer.{columns[4],mega}TodosMega 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égiaQuando escolherCusto / latência
placeholderPrimeira passagem. Demonstração. Projeto interno. Sem orçamento de imagem ainda.$0, <1s
generateEntrega final. A marca quer colagens originais.~$0,40, ~6 min
bring-your-ownO 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-reveal para 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 de inputs.json em 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.html abre 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 display h1/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-reveal da 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.css literalmente para app/globals.css para que a paridade visual permaneça de um para um.

Veja também

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas