CommunityImagemgithub.com

og-images

Gera imagens de lançamento a partir da interface real do aplicativo: uma prévia de link de 1200×630 (Open Graph e X card) com título grande e legível, o ícone do app e uma captura real, prévias opcionais por página para um site, uma galeria do Product Hunt de 4 a 6 slides em 1270×760, um cabeçalho X em 1500×500 com zonas do avatar e do recorte do telefone preservadas, e as meta tags para colar. Leve, calmo, nas próprias cores da marca ou em um papel de parede incluso, verificado nos arquivos (tamanho exato, sem alfa, contraste de texto, tamanho do título, zonas seguras, sem fallback de fonte). Use quando for solicitado uma imagem OG, imagem Open Graph, prévia social, prévia de link, imagem de compartilhamento, Twitter Card, galeria do Product Hunt ou imagem de cabeçalho X.

O que é og-images?

Este skill gera imagens de lançamento profissional para aplicativos, usando capturas reais da interface do usuário em vez de elementos desenhados artificialmente. Ele produz vários formatos: uma prévia de link padrão de 1200×630 (para Open Graph e X/Twitter), uma galeria do Product Hunt com 4 a 6 slides em 1270×760, um cabeçalho X/Twitter de 1500×500 e meta tags HTML prontas para colar. O skill é útil para desenvolvedores e equipes de produto que precisam criar assets visuais para o lançamento de um app, garantindo consistência com a marca e qualidade profissional. Ele funciona analisando o repositório do usuário para extrair informações de marca (nome, cores, fontes, ícone) e capturando a interface real do aplicativo usando Playwright e scripts Swift/iOS. O processo inclui validações rigorosas: verificação de tamanho exato, ausência de canal alfa, contraste de texto mínimo de 4.5:1, tamanho do título adequado, zonas seguras para o avatar do X e prevenção de fallback de fontes. Ele suporta capturas de janelas macOS e telas de simulador iOS, e pode gerar prévias por página para sites com várias páginas. O skill prioriza o uso de capturas existentes no repositório e oferece um modo de papel de parede automático que seleciona a imagem de fundo mais harmoniosa com a marca.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdiraimov-otabek/claude-code-og-image-skill/tree/main/skills/og-images

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Imagens OG

Três tipos de imagem que fazem um trabalho: fazer alguém parar em um link e entender o aplicativo em um relance. Cada uma é uma captura real do aplicativo com um título grande, no campo da marca ou em um papel de parede claro. A interface é a protagonista. Nada é desenhado além da moldura.

Saídas, em launch-assets/og/ do repositório do usuário:

ArquivoTamanhoO quê
og.png1200×630A prévia de link para a página inicial.
og-<id>.png1200×630Opcional: um por página de um site, mesmo design, título daquela página.
ph/01-<id>.png … 061270×760Galeria do Product Hunt, 4 a 6 slides. O slide 1 é o herói.
x-header.png1500×500Cabeçalho X com as zonas do avatar e do recorte do telefone limpas.
meta.htmlAs tags <meta> para colar em <head>.

Tamanhos e zonas seguras, com fontes e datas, estão em references/sizes.md.

Quando usar

  • Um lançamento precisa de uma imagem de compartilhamento, uma galeria do Product Hunt ou um cabeçalho X.
  • O og:image atual do site é um logotipo em uma cor sólida, ou não existe.
  • Uma versão mudou a interface, então as prévias são renderizadas novamente a partir de capturas novas.

As capturas são janelas ou ilhas no estilo Mac em paisagem; uma tela de telefone em retrato não é suportada por esses cards. Não para: capturas de tela da App Store (um skill diferente, com tamanhos diferentes), ou qualquer coisa que precise de interface que o aplicativo não possui. Este skill nunca desenha interface.

Configuração (uma vez)

Node 20 ou mais recente. O Playwright vai para a pasta deste skill, não para o repositório do usuário:

npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium

Se estiver faltando, render.mjs imprime esta linha e sai com código 2.

Etapa 0. Marca

Leia launch-assets/brand.json no repositório do usuário. Se existir, use-o. Se estiver faltando, detecte cada campo do repositório e escreva o arquivo. Pergunte ao usuário apenas o que você não conseguiu encontrar, em uma única mensagem.

{
  "appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
  "colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
  "fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
  "iconPath": "site/assets/icon.png",
  "screenshotDirs": ["launch-assets/captures"],
  "siteUrl": "https://example.com"
}
  • appName, oneLiner: título do README e primeira linha, o <title> e <h1> do site, Info.plist.
  • colors: as variáveis CSS do site, o AccentColor do catálogo de assets, definições de cores Swift. Pegue os valores claros. Escreva em hexadecimal (#0d7f76); converta rgb(), oklch() e hsl() primeiro. Qualquer coisa que o renderizador não conseguir ler conta como cinza.
  • fonts.family (uma pilha CSS), fonts.file (um arquivo de fonte que o repositório contém, um caminho relativo à raiz do repositório, a pasta acima de launch-assets, ou null), fonts.google (como Geist:wght@400;600, ou null). Use a fonte da marca apenas se o repositório contiver o arquivo; caso contrário, use a pilha do sistema ou Google Fonts. Nunca copie uma fonte proprietária para o repositório do usuário.
  • iconPath: o ícone do aplicativo, um PNG quadrado (1024 px é o ideal), relativo à raiz do repositório. Procure nos assets do site, no catálogo de assets AppIcon, na pasta favicon. Obrigatório: o ícone e o nome estão em todas as imagens.
  • siteUrl: para onde meta.html aponta as URLs das imagens. Opcional; sem ele as tags carregam um placeholder.

Etapas

  1. Capturas. Reutilize o que existe: launch-assets/captures/, screenshotDirs, ou um launch-assets/store-screenshots/shots.json anterior. Faça novas capturas apenas quando nenhuma passar pelas regras abaixo. Primeiro procure pela maneira do próprio aplicativo se capturar: uma flag de snapshot, demonstração ou dados de exemplo (rg -i "demo|snapshot|screenshot|marketing" no código-fonte, no README e em Package.swift; por exemplo MyApp --snapshot <dir> ou MYAPP_DEMO=1). Leia o que uma flag faz antes de executá-la. Nunca execute nada que escaneie, limpe ou escreva dados reais de usuário, e nunca inicie uma segunda cópia de um aplicativo que mantenha estado ativo. Se uma flag puder fazer isso, pare e pergunte. Caso contrário, em um Mac, traga o aplicativo para a frente no estado a ser mostrado e execute swift <skill-folder>/scripts/capture-window.swift "MyApp" capture.png (a maior janela visível na tela do aplicativo, sem sombra, pixels Retina; ela pula um notch ou painel de app da barra de menus, que fica em uma camada de janela superior, e avisa isso). iOS: xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, então xcrun simctl io booted screenshot capture.png, então xcrun simctl status_bar booted clear.

    Regras para cada captura:

    • Interface real, focada. A janela ativa: trafic lights coloridos, uma barra lateral iluminada. Uma janela cinza e esmaecida é uma falha.
    • Estabilizada. Nenhum contador no meio de uma rolagem, nenhum spinner, nada meio desenhado.
    • Dados de demonstração neutros. Nenhum nome pessoal, arquivo real, nome de projeto ou conta, nenhum nome de produto de outra empresa (a menos que o próprio site do aplicativo nomeie essa integração). Use o modo de demonstração, nunca uma captura de tela da coisa real.
    • Modo claro se o aplicativo tiver um. Capturas escuras são para aplicativos apenas em modo escuro.
    • 2x pixels. Um card mostra uma captura com no máximo 1.15x seus próprios pixels (a renderização falha acima disso), então uma janela precisa de cerca de 1400 px de largura para uma prévia de link e 2000 px para um slide de galeria.
    • Conteúdo real. Nenhum campo vazio, nenhum lorem, nenhum texto truncado na parte que o título aborda.
    • Algo que se lê pequeno. A prévia de link mostra a captura com cerca de 600 px de largura. Escolha a captura cujo ponto principal seja visível nesse tamanho (um número grande, uma lista clara), não um painel de configurações denso. Corte para a parte que importa.
    • Uma captura ImageRenderer do SwiftUI (a ilha de um app de notch) vem com placeholders amarelos opacos em seus flares de canto: defina "clean": true. Para uma ilha flutuando no card, adicione "square": true, que ajusta os flares de canto quadrados para as bordas do corpo. Corte qualquer linha vazia de notch com crop.

    Feito quando cada captura passar pela lista. Leia o tamanho de cada arquivo (sips -g pixelWidth -g pixelHeight) e olhe para ele.

  2. Escreva as palavras.

    • Título do link: o one-liner do aplicativo ou o título da própria página, nas palavras do site: 9 palavras ou menos, em caixa de frase, sem ponto final, sem travessão, sem !. É o único texto grande no card, então mais curto é maior.
    • Páginas: se o repositório tiver um site com várias páginas, execute node <skill-folder>/scripts/pages.mjs <site-folder>. Ele imprime o <title> e <h1> de cada página. Escolha as páginas que valem uma prévia própria (os guias, a página de preços, os maiores recursos); pule páginas que nomeiem o produto de outra empresa. Pegue o <h1> ou o mais curto dos dois, remova o sufixo do nome do site e tags do tipo "(2026)", mantenha em 9 palavras. Nunca parafraseie.
    • Slides: se launch-assets/store-screenshots/shots.json existir, "ph": { "fromShots": "../store-screenshots/shots.json" } reutiliza seus títulos, subtítulos, capturas e cortes (primeiros 6 shots, "limit" altera isso). Caso contrário, escreva 4 a 6 slides: o slide 1 diz o que é o aplicativo, cada slide posterior tem um benefício e faz sentido sozinho. Título 6 palavras ou menos, um subtítulo opcional de uma frase curta.
    • Título do cabeçalho X: o one-liner. 6 palavras ou menos.
    • Texto alternativo: uma frase que diga o que a imagem mostra. Padrão: <app>: <title>. <subline>; escreva alt no link quando a captura adicionar algo que valha a pena dizer.

    A cópia usa as próprias palavras do site. Cada linha é tirada do site ou README e encurtada; cada número, nome e afirmação está no site. Verifique cada linha com rg contra a cópia do site antes de mantê-la.

  3. Escreva launch-assets/og/og.json.

    {
      "brand": "../brand.json",
      "out": ".",
      "wallpaper": "auto",
      "link": {
        "title": "A Mac cleaner for developers",
        "capture": "../captures/overview.png",
        "alt": "Shedi, a Mac cleaner for developers: 43.84 GB found, sorted into safe to clean and check first"
      },
      "pages": [
        { "id": "xcode-deriveddata", "title": "Clear Xcode DerivedData", "capture": "../captures/xcode.png" }
      ],
      "ph": { "fromShots": "../store-screenshots/shots.json" },
      "x": { "title": "A Mac cleaner for developers", "capture": "../captures/overview.png" }
    }
    

    Deixe de fora pages, ph ou x para pular esse tipo. Caminhos são relativos a og.json. Uma página herda tudo de link (captura, corte, layout) e sobrescreve o que especificar. Opções em link, uma página, um slide ou x:

    • capture (ou captures, até 3, empilhadas), crop ({ x, y, w, h }, 0 a 1 da captura após as margens transparentes serem cortadas; crops para várias capturas), clean, square, radius, width (largura da captura como uma fração do card), shadow: false, minCoverage.
    • layout: cards de link são side (título à esquerda, uma janela subindo do canto inferior direito) ou below (título centralizado, uma captura larga abaixo dele). O padrão escolhe below para uma captura mais larga que 2:1, side caso contrário. Slides são fit (a captura inteira, nada cortado), bleed (cortado pela borda inferior, para uma janela) ou pair (2 ou 3 capturas empilhadas). Um slide sem layout e com uma captura de janela simples (sem clean) é bleed; qualquer outra coisa é fit.
    • minCoverage: o mínimo de cobertura da interface (link 0.3, slide 0.4, cabeçalho 0.12). Uma captura que cubra 80% da largura do card passa sem isso (uma ilha ou barra fina não pode ficar mais alta). Não abaixe o mínimo para esconder uma captura pequena: mostre-a maior, corte-a ou escolha outra.
    • Em um slide em fromShots, adicione "slides": [{ "id": "<shot id>", ... }] para sobrescrever as opções de um slide.

    Fundo, uma vez para todas as imagens: "wallpaper": "auto" escolhe a imagem incluída cujo matiz está mais próximo do tom de destaque da marca (azul e verde-azulado, verde, quente, rosa) e imprime a escolha e o motivo. Informe ao usuário a escolha e o motivo, e que eles podem mudá-la ("wallpaper": "snow", ou um caminho para sua própria imagem calma e clara, com pelo menos 2400 px de largura). Um tom de destaque cinza, ou um que esteja a mais de 50 graus de cada imagem, recebe o campo da marca em vez disso (o fundo da marca lavado com um pouco de seu tom de destaque). Deixe a chave de fora para o campo. Este skill inclui cinco imagens.

  4. Renderize.

    node <skill-folder>/scripts/render.mjs launch-assets/og/og.json
    

    Uma linha de saída por PNG: ok ou FAIL, tamanho, peso do arquivo, a fonte que realmente desenhou o título, o contraste das palavras contra os pixels realmente atrás delas, o tamanho do título e altura das maiúsculas, a cobertura da interface e o quanto a captura e o papel de parede foram ampliados. --only link|pages|ph|x renderiza um tipo (qualquer outra coisa falha). Também escreve meta.html.

    O guarda falha: um tamanho que não é exato, um canal alfa, um arquivo acima de 5 MB, contraste de texto abaixo de 4.5:1 (não há scrim; escolha um papel de parede mais claro ou tinta mais escura), um título cuja altura das maiúsculas está abaixo do mínimo (link 40 px, slide 38 px, cabeçalho 36 px, para ainda ser legível em uma prévia de 600 px de largura) ou que precisa de mais linhas do que cabem, cópia muito longa ou com travessão (" - " ou "--") ou !, uma captura ampliada mais de 1.15x ou um papel de parede mais de 1.2x, cobertura de interface abaixo do mínimo a menos que a captura cubra 80% da largura do card (medido nos pixels de conteúdo da captura, não em sua caixa, então áreas pretas ou brancas em branco não contam), qualquer coisa fora da área segura do X ou dentro da zona do avatar, e uma fallback de fonte: a primeira família nomeada de fonts.family deve ser a fonte que desenhou o título ("Inter, sans-serif" sem arquivo desenharia SF Pro: FAIL). Uma pilha que começa com -apple-system ou system-ui significa a fonte do sistema e falha apenas em uma fallback como Helvetica ou Arial. Corrija cada FAIL em og.json e renderize novamente.

  5. Passo de QA. Obrigatório, e feito nos arquivos, não na configuração.

    1. Tamanho e alfa: sips -g pixelWidth -g pixelHeight -g hasAlpha <cada arquivo>. Tamanhos exatos de sizes.md, hasAlpha: no.
    2. Olhar: abra cada PNG com a ferramenta de leitura em tamanho real. Em seguida, node <skill-folder>/scripts/preview.mjs launch-assets/og e abra _preview-600.png e _preview-300.png (cada imagem com 600 e 300 px de largura, como um feed mostraria), depois exclua os dois arquivos. Para cada imagem verifique:
      • O título é legível a 300 px e nada está cortado ou sozinho em uma segunda linha.
      • A fonte na linha de saída é a que você pediu.
      • A captura é nítida, mostra o ponto do título, não tem texto truncado e nenhum dado pessoal.
      • Nomes: nenhum nome ou logotipo de concorrente ou outra empresa, a menos que o site nomeie essa integração; nenhum nome pessoal.
      • Palavras: cada linha é a redação do próprio site, encurtada; cada número está no site.
      • Cabeçalho X: o canto inferior esquerdo (x abaixo de 420, y acima de 300) está limpo para a foto do perfil; o conteúdo fica na faixa do meio, longe do topo e da base de 70 px. Verifique com sizes.md e, se possível, no perfil real.
      • Conjunto: os slides são lidos como uma família; nenhum dois fazem o mesmo ponto.
    3. Corrija e renderize novamente, depois olhe para aquele arquivo novamente.
    4. Só então relate: a lista de arquivos, a saída de sips e qualquer coisa que você não pôde verificar. Diga ao usuário para copiar os PNGs para o site, colar meta.html em <head> e atualizar a prévia em cache no depurador de cada plataforma.

Regras de aparência

  • Claro primeiro. Um papel de parede claro ou o campo da marca, tinta escura sobre ele. Sem fundo escuro com neon.
  • Sem brilho, sem halo. Profundidade é uma borda de 1 px e sombras pretas neutras com baixa opacidade.
  • Um trabalho por imagem. Um título, uma captura (ou um par), no máximo um subtítulo.
  • Tipo grande. O título é o que sobrevive a uma miniatura. Cópia curta é o que permite que ele seja grande.
  • Apenas capturas reais. A interface nunca é desenhada, redesenhada ou gerada.

Habilidades Relacionadas