Gerador de landing pages
Gera uma landing page completa e pronta para deploy a partir de qualquer repositório, analisando sua documentação e estrutura.
Quando usar esta skill
- Criar uma landing page para um repositório GitHub
- Gerar sites estáticos a partir de documentação existente
- Padronizar landing pages em vários projetos
- Converter conteúdo README em páginas de marketing/exibição
O que esta skill faz
- Analisa o Repositório: Lê README.md, CHANGELOG.md, package.json/VERSION, docs/, assets/
- Extrai Conteúdo: Identifica título, slogan, funcionalidades, instalação, capturas de tela
- Mapeia para Seções: Hero, Funcionalidades, Instalação, FAQ, Rodapé (+ opcional: Banner de Risco, Preços)
- Gera a Landing Page: Cria site estático completo (HTML + CSS + JS)
- Saída Pronta para Deploy: Inclui workflow do GitHub Actions para GitHub Pages
Como usar
Uso básico
/gerador-de-landing-pages from ~/caminho/para/repo
Com opções
/gerador-de-landing-pages from ~/caminho/para/repo --banner-de-risco --tabela-de-precos
Opções disponíveis
| Opção | Descrição | Padrão |
|---|---|---|
--banner-de-risco | Adicionar banner proeminente de aviso/isentação acima da dobra | false |
--tabela-de-precos | Incluir seção de comparação de preços | false |
--capturas-de-tela <caminho> | Caminho para pasta de capturas de tela | ./assets/ |
| `--tema [escuro | claro]` | Variante de tema de cores |
--pesquisa | Habilitar pesquisa Cmd+K | true |
--saida <caminho> | Diretório de saída | ./[nome-repo]-landing/ |
Fluxo de trabalho
Passo 1: Análise do repositório
Ler e analisar estes arquivos do repositório fonte:
README.md → Fonte principal de conteúdo (título, slogan, funcionalidades, instalação)
CHANGELOG.md → Informações de versão, mudanças recentes
package.json → Número da versão, dependências, metadados
VERSION → Fonte alternativa de versão
docs/ → Páginas de documentação adicionais
assets/ → Capturas de tela, imagens
LICENSE → Tipo de licença para badge
Passo 2: Mapa de extração de conteúdo
| Fonte | Seção de Destino | Método de Extração |
|---|---|---|
| Título/badges README | Hero | Primeiro H1 + linhas de badge shield.io |
| Resumo README | Slogan do Hero | Primeiro parágrafo ou citação após o título |
| Funcionalidades README | Grade de Funcionalidades | Seções H2/H3 com listas com marcadores |
| Instalação README | Início Rápido | Blocos de código com comandos shell |
| Uso README | Exemplos | Blocos de código com exemplos |
| FAQ README | FAQ | Padrões de details/summary ou H3+P |
| CHANGELOG | O que há de novo | Últimas 1 a 3 versões |
| assets/*.png | Capturas de tela | Seção de galeria |
Passo 3: Geração de seções
Gerar estas seções em ordem:
-
Cabeçalho (fixo)
- Nome do projeto/logo
- Links de navegação: Funcionalidades, Instalação, FAQ
- Ações: Pesquisa (Cmd+K), Estrela no GitHub, CTA principal
-
Banner de Risco (se
--banner-de-risco)- Estilo laranja/aviso acima da dobra
- Texto de isenção claro e visível
- Link para seção detalhada de divulgação
-
Seção Hero
- Título do H1 do README
- Slogan do resumo/primeiro parágrafo
- Badges de estatísticas (versão, licença, plataforma)
- CTAs: "Início Rápido" (primário), "Ver no GitHub" (secundário)
-
Arquitetura/Visão Geral (se houver diagrama no README)
- Diagrama ASCII convertido em bloco estilizado
- Ou cards de visão geral
-
Grade de Funcionalidades
- 4-6 cards de funcionalidades a partir do README
- Padrão ícone + título + descrição
-
Tabela de Preços (se
--tabela-de-precos)- Tabela de comparação de planos
- Tabela de multiplicadores/uso se presente
-
Galeria de Capturas de Tela (se assets existirem)
- Galeria baseada em abas ou carrossel
- Legendas a partir de texto alternativo
-
Seção de Início Rápido
- Comando de instalação em uma linha (bloco de código em destaque)
- Etapas de configuração
- Primeiro exemplo de uso
-
Divulgação de Risco (se
--banner-de-risco)- Seção de isenção completa
- Considerações de Termos de Serviço
- Recomendações
-
Seção FAQ
- Gerada a partir do FAQ do README ou perguntas comuns
- Padrão de detalhes recolhíveis
-
Projetos Relacionados (se houver links no README)
- Cards vinculando a dependências/repositórios relacionados
-
Rodapé
- Links rápidos
- Badge de licença
- Informações de versão
- Links para autor/repositório
Passo 4: Estrutura de saída
[nome-projeto]-landing/
├── index.html # Página principal da landing
├── styles.css # Folha de estilo completa
├── search.js # Funcionalidade de pesquisa Cmd+K
├── search-data.js # Índice de pesquisa (FAQ, funcionalidades)
├── favicon.svg # Gerado ou copiado
├── robots.txt # SEO
├── CLAUDE.md # Instruções do projeto
├── README.md # Documentação do repositório da landing
├── assets/ # Capturas de tela copiadas
│ └── [copiado da origem]
└── .github/
└── workflows/
└── static.yml # Deploy no GitHub Pages
Passo 5: Ponto de verificação de validação
Antes de finalizar, verifique:
- Todas as seções renderizam corretamente no navegador
- Links apontam para destinos válidos (repositório GitHub, documentação, comandos de instalação)
- Layout responsivo funciona nas larguras móvel (375px), tablet (768px) e desktop (1280px)
- Acessibilidade: links de pular presentes, rótulos ARIA em elementos interativos, contraste de cores atende WCAG AA
Stack tecnológica
- Sem etapa de build: HTML + CSS + JS puros
- Pesquisa: MiniSearch carregado sob demanda de CDN com fallback
- Deploy: GitHub Pages via Actions
- Estilização: Propriedades personalizadas CSS, responsivo, tema escuro padrão
- Acessibilidade: Links de pular, rótulos ARIA, navegação por teclado
Padrões CSS (de landings estabelecidas)
Classes de componentes
/* Botões */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline
/* Cards */
.feature-card, .comparison-card, .path-card
/* Layout */
.container, .features-grid, .hero, .section
/* Utilitários */
.visually-hidden, .skip-link
Variáveis CSS
:root {
--color-bg: #0d1117;
--color-surface: #161b22;
--color-border: #30363d;
--color-text: #c9d1d9;
--color-text-muted: #8b949e;
--color-primary: #58a6ff;
--color-success: #3fb950;
--color-warning: #d29922;
--color-danger: #f85149;
--space-xs: 0.25rem;
--space-sm: 0.5rem;
--space-md: 1rem;
--space-lg: 1.5rem;
--space-xl: 2rem;
--radius: 6px;
}
Exemplo
Usuário: /gerador-de-landing-pages from ~/projetos/meu-projeto --banner-de-risco --tabela-de-precos
Saída:
Cria ~/projetos/meu-projeto-landing/ com:
- Landing page completa exibindo o roteador multi-provedor
- Banner de risco de Termos de Serviço proeminente (laranja, acima da dobra)
- Cards de provedores (Anthropic, Copilot, Ollama)
- Tabelas de preços do README
- Galeria de capturas de tela
- Pronto para deploy no GitHub Pages
Dicas
- Sempre inclua
--banner-de-riscopara projetos com considerações legais/ToS - Capturas de tela melhoram significativamente a qualidade da landing - certifique-se de que
assets/esteja populado - A skill preserva o idioma do README (inglês/francês)
- Revise o FAQ gerado - pode precisar de personalização
- Teste o design responsivo após a geração
Referências
Veja referencias/padrao-landing.md para documentação detalhada do padrão.
Veja assets/ para modelos e trechos reutilizáveis.