Communitygithub.com

open-design-landing

Produza um site editorial de página única de classe mundial na linguagem visual Atelier Zero (colagem editorial Monocle / Apartamento / Études) — a mesma estética que a Open Design usa em sua própria superfície de marketing. O agente preenche um `inputs.json` tipado a partir de um brief de marca, opcionalmente gera 16 ativos de colagem via gpt-image-2 e executa um compositor de função pura que emite um arquivo HTML autocontido; um caminho separado pode espelhar o site de marketing Astro em `apps/landing-page/`. Movimento de revelação por scroll e navegação fixa estilo Headroom são conectados automaticamente.

O que é open-design-landing?

Esta skill automatiza a criação de uma landing page editorial de página única utilizando o sistema de design **Atelier Zero**, reconhecido por seu estilo de colagem editorial refinado (similar a Monocle, Apartamento e Études). É a mesma receita que a Open Design emprega para sua própria página de marketing. O processo inicia com o preenchimento de um `inputs.json` tipado a partir do brief da marca, com o agente guiando a coleta de informações em grupos de perguntas focados. Opcionalmente, é possível gerar 16 imagens de colagem surrealistas usando o modelo gpt-image-2 (via fal.ai ou Azure), ou utilizar placeholders SVG texturizados para agilizar o desenvolvimento. O coração da skill é um compositor de função pura (`scripts/compose.ts`) que, a partir do `inputs.json` e da folha de estilos canônica `styles.css`, produz um arquivo HTML autocontido com todas as seções (hero, about, capabilities, labs, method, work, testimonial, cta, footer), animações de revelação por scroll, navegação fixa estilo Headroom e total responsividade nos breakpoints 1280/1080/880/560. A skill suporta três formatos de saída: HTML autônomo, um espelho do site Astro em `apps/landing-page/` para deploy em produção, ou ambos. Destinada a fundadores, estúdios de design e mantenedores de OSS que buscam uma presença de marketing premium e editorial sem abrir mão do controle artesanal sobre pixels e ritmo tipográfico.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Keimoshi/Silverloft/tree/HEAD/open-design-port/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 — 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:

GrupoCampos do SchemaRespostas mínimasObservações
1brand.{name,mark,tagline,description,location}5Mark = glifo único (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL é obrigatório; licença padrão Apache-2.0
3nav[] (até 5)3Crachás de contagem opcionais
4hero.{label,headline,lead,primary,secondary,stats}TodosHeadline como MixedText (sans+em+dot)
5about + capabilities.cards[4]Todos4 cartões × {num,tag,title,body}
6labs.cards[5] + method.steps[4]TodosAmbas as grades de 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 (a própria Open Design).

2. Decidir a estratégia de imagem

EstratégiaQuando escolherCusto / latência
placeholderPrimeira passada. Demonstração. Slide interno. Sem orçamento de imagem ainda.$0, <1s
generateEntrega final. Marca quer colagens originais.~$0,40, ~6 min
bring-your-ownUsuá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-reveal para 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 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 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 display h1/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-reveal da 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.css literalmente para app/globals.css para que a paridade visual permaneça 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