Communitygithub.com

chongdashu/cc-skills

Geração inteligente de imagens OG que estuda seu código-fonte, entende rotas e identidade visual e, em seguida, cria imagens Open Graph contextualmente apropriadas usando Playwright e componentes React.

O que é cc-skills?

Esta skill capacita agentes de IA (como Claude Code, Cursor, Codex) a gerar imagens Open Graph (OG) autênticas e alinhadas à marca de um site, indo muito além de templates genéricos. Ao receber gatilhos como "create og images", o agente primeiro analisa profundamente o código-fonte para descobrir rotas (Next.js, Astro, React Router), extrair a identidade visual (cores, fontes, logotipo) e entender os tipos de páginas (landing, artigo, produto). Com base nessa análise, ele projeta layouts contextuais — diferentes para cada tipo de página — e gera as imagens usando Playwright para renderizar componentes React ou HTML customizado, garantindo consistência com o design real do site. A skill fornece scripts de automação (Python) para análise e geração, diretrizes específicas para frameworks populares e uma ênfase em evitar anti-padrões como templates genéricos, conteúdo fictício e designs superlotados. O resultado são imagens OG que parecem extensões naturais do site, melhorando a experiência de compartilhamento social.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chongdashu/cc-skills/tree/HEAD/.claude/skills/og-image-creator

Perguntar na sua IA favorita

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

Documentação

Criador de Imagens OG

Gere imagens Open Graph autênticas e alinhadas à marca, estudando primeiro seu código-fonte e, em seguida, criando imagens contextualmente apropriadas para cada rota usando Playwright e seus componentes existentes.

Filosofia: Autenticidade em vez de Template

Antes de gerar imagens OG, pergunte:

  • Qual é a identidade visual deste site (cores, fontes, logotipo, linguagem de design)?
  • Quais rotas/páginas existem e quais são seus propósitos?
  • Quais componentes e ativos podem ser reutilizados para consistência?
  • Quais tipos de página precisam de tratamentos visuais diferentes?

Princípios centrais:

  1. Estude antes de gerar: Entenda a estrutura do código-fonte, roteamento e marca antes de criar qualquer coisa
  2. Autenticidade em vez de templates: Use cores, fontes e componentes reais da marca — não templates genéricos de cartão social
  3. Design sensível ao contexto: Páginas de destino, artigos, produtos e documentação precisam de abordagens visuais diferentes
  4. Automação inteligente: Detecte rotas automaticamente e extraia a marca, mas permita personalização pelo usuário

Fluxo de Trabalho

1. Descobrir e Analisar

Descoberta de rotas:

  • Analise a estrutura do projeto para determinar o framework (Next.js, Astro, React, etc.)
  • Detecte rotas automaticamente com base nas convenções do framework:
    • Next.js: app/*/page.tsx ou pages/*.tsx
    • Astro: src/pages/*.astro
    • React Router: Analise a configuração de rotas
  • Extraia metadados das rotas (título, descrição) das páginas
  • Categorize os tipos de página (landing, artigo, produto, sobre, etc.)

Extração da marca:

  • Encontre arquivos de logotipo/ícone (SVG preferencialmente)
  • Extraia a paleta de cores do CSS/configuração do Tailwind
  • Identifique fontes primárias das folhas de estilo ou configuração
  • Capture padrões de design dos componentes existentes

Use scripts/analyze_codebase.py para automatizar a descoberta.

2. Estratégia de Design

Determine layouts apropriados por tipo de página:

  • Páginas de destino (Landing pages): Negrito, minimalista, enfatize a proposta de valor
  • Artigos/Posts de blog: Título + trecho, data/autor se relevante
  • Páginas de produto: Nome do produto, recurso principal, visual se disponível
  • Documentação: Tópico + descrição, sensação organizada/estruturada
  • Sobre/Empresa: Foco na marca, profissional

Princípios de layout:

  • Espaçamento generoso (evite poluição visual)
  • Alto contraste para legibilidade ao ser compartilhado
  • Cores da marca como detalhes, não de forma avassaladora
  • Hierarquia tipográfica que corresponda ao site
  • 1200x630px (dimensões padrão OG)

3. Gerar Imagens

Geração baseada em componentes:

  • Reutilize componentes React sempre que possível para consistência
  • Use Playwright para renderizar componentes em imagens
  • Aplique cores, fontes e ativos da marca
  • Injete metadados reais da página (não placeholders)

Abordagem técnica:

  1. Crie um modelo HTML mínimo com estilos da marca
  2. Para cada rota, gere marcação específica da página
  3. Use Playwright para capturar a captura de tela em 1200x630
  4. Salve em public/og/ ou diretório estático apropriado
  5. Atualize os metadados da página para referenciar a imagem OG

Use scripts/generate_og_images.py para automação.

4. Verificar e Otimizar

  • Valide os metadados da imagem OG no HTML
  • Teste com ferramentas de pré-visualização OG (opengraph.xyz, linkedin inspector)
  • Certifique-se de que os tamanhos de arquivo sejam razoáveis (<200KB preferencialmente)
  • Verifique a aparência da imagem em diferentes escalas

Orientações Específicas por Framework

Next.js

App Router:

// app/page.tsx
export const metadata = {
  openGraph: {
    images: ['/og/home.png'],
  },
}

Pages Router:

// pages/index.tsx
<Head>
  <meta property="og:image" content="/og/home.png" />
</Head>

Imagens OG dinâmicas: Considere a Geração de Imagens OG do Next.js (@vercel/og) para conteúdo dinâmico, mas use geração estática para consistência da marca.

Astro

---
// src/pages/index.astro
const ogImage = '/og/home.png';
---
<head>
  <meta property="og:image" content={ogImage} />
</head>

React SPAs

Adicione tags OG ao public/index.html ou use react-helmet:

<Helmet>
  <meta property="og:image" content="/og/home.png" />
</Helmet>

Anti-Padrões a Evitar

❌ Templates genéricos: Não use modelos de cartão social prontos que ignoram a marca do site

  • Por que é ruim: Cria uma desconexão entre o site e a experiência de compartilhamento social
  • Melhor: Extraia cores, fontes reais da marca e use-as consistentemente

❌ Tamanho único para todos: Não use o mesmo design de imagem OG para todos os tipos de página

  • Por que é ruim: Perde a oportunidade de uma apresentação contextualmente apropriada
  • Melhor: Layouts diferentes para landing, artigos, produtos, etc.

❌ Conteúdo placeholder: Não use "Lorem ipsum" ou texto genérico

  • Por que é ruim: Derrota o propósito das imagens de pré-visualização
  • Melhor: Use títulos e descrições reais das páginas a partir dos metadados

❌ Superlotação: Não amontoe muito texto, muitas imagens ou layouts complexos

  • Por que é ruim: Ilegível quando reduzido em feeds sociais
  • Melhor: Foco em 1-2 elementos-chave com espaçamento generoso

❌ Ignorar componentes: Não crie imagens OG do zero se existirem componentes

  • Por que é ruim: Quebra a consistência visual com o site
  • Melhor: Reutilize estilos de botões, layouts de cartão, tipografia dos componentes

❌ Geração manual: Não crie imagens OG uma a uma manualmente

  • Por que é ruim: Não escalável, difícil manter consistência
  • Melhor: Automatize o processo de geração para lidar com todas as rotas

Orientações para Variação

IMPORTANTE: Imagens OG devem variar com base no contexto da página, não convergir para um único design.

Dimensões para variar:

  • Layout: Centralizado vs alinhado à esquerda, coluna única vs dividida, foco em texto vs visual
  • Ênfase de cor: Cor primária da marca vs neutro, gradiente vs sólido
  • Hierarquia de conteúdo: Título grande vs título+descrição equilibrado
  • Elementos visuais: Tamanho/posição do logotipo, elementos decorativos, ícones
  • Tipografia: Proporções de tamanho, distribuição de peso, combinação de fontes

Evite convergir para:

  • Mesmo fundo gradiente para tudo
  • Layout idêntico de "título + logotipo"
  • Proporção de tamanho de fonte única
  • Posição fixa do logotipo

O contexto impulsiona a variação:

  • Documentação técnica → Limpo, organizado, baseado em ícones
  • Landing de marketing → Negrito, colorido, focado em valor
  • Artigos de blog → Amigável ao leitor, contexto de autor/data
  • Páginas de produto → Ênfase visual no produto

Requisitos Técnicos

Dependências (instale conforme necessário):

npm install playwright sharp
# ou
pip install playwright Pillow

Configuração do Playwright:

playwright install chromium

Estrutura de arquivos:

project/
├── public/og/          # Imagens OG geradas
│   ├── home.png
│   ├── about.png
│   └── ...
└── scripts/            # Scripts de geração
    ├── analyze_codebase.py
    └── generate_og_images.py

Lembre-se

Imagens OG são uma extensão da sua marca, não cartões sociais genéricos.

Estude o código-fonte para entender a linguagem de design. Extraia a identidade da marca. Use componentes e conteúdo reais. Crie imagens contextualmente apropriadas que pareçam nativas do site.

Quando alguém compartilhar sua página, a imagem OG deve parecer uma pré-visualização natural — não um template colocado por cima.

Você é capaz de criar imagens OG sofisticadas e alinhadas à marca que melhoram, em vez de prejudicar, a identidade do site.

Habilidades Relacionadas