Communitygithub.com

Im-Fran/landing-skills

Use ao escolher a direção visual de uma landing page, incluindo tipografia, paleta de cores, layout, imagens ou tokens de design, ou quando uma página parece genérica, pronta ou gerada por IA.

O que é landing-skills?

Esta skill garante que uma landing page tenha uma identidade visual única e bem fundamentada, evitando o uso de padrões genéricos que não pertencem ao cliente. Ela guia o agente de IA por um processo estruturado para definir a direção visual antes de qualquer marcação de código. O resultado são dois arquivos: `landing/direction.md`, que documenta as decisões e suas justificativas, e `landing/tokens.css`, que contém os tokens de design (cores, tipografia, espaçamento) que serão usados por outras skills como `landing-skills:landing-build`. A skill é útil para agentes que atuam em ferramentas como Claude Code, Cursor ou Codex, e seu processo inclui etapas como inventariar o assunto, definir uma direção visual baseada em âncoras concretas, rejeitar direções genéricas (como usar papel timbrado da empresa por padrão), pesquisar tipografia, derivar uma paleta de cores usando o espaço de cor OKLCH, planejar o layout e determinar a necessidade de movimento ou 3D. A skill também possui verificações de autoconsistência para garantir que cada escolha visual seja única e justificada.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-art-direction

Perguntar na sua IA favorita

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

Documentação

Direção de arte para landing pages

Você decide a aparência da página antes de qualquer pessoa escrever marcação. A saída são dois arquivos: landing/direction.md, uma direção escrita com uma razão para cada escolha, e landing/tokens.css, os tokens de design que a landing-skills:landing-build usa sem alterações e que a landing-skills:landing-motion lê para saber a intenção.

O trabalho é encontrar a aparência que pertence a este cliente e a nenhum outro. Uma direção que serviria para um cliente diferente em um ramo diferente é um modelo, por mais elegante que pareça.

Por que esta skill existe

Agentes sem orientação deram a clientes não relacionados a mesma aparência: creme, um acento verde escuro ou terracota, fontes do sistema ou Georgia. Uma escolha é um sinal revelador quando é o padrão não pensado, e é boa quando escolhida por uma razão específica para o cliente. A evidência está em references/visual-tells.md.

Entradas

  1. landing/brief.md: o produto, público, ação de conversão, ativos, restrições da marca, idioma, pilha tecnológica e Momentos desejados (o movimento, 3D ou efeitos de rolagem que o usuário pediu). A direção dá a cada momento desejado seu papel, propósito e forma de movimento reduzido na seção Intenção de movimento e 3D (passo 8).
  2. landing/copy.md: o texto aprovado, um H2 por seção na ordem da página, terminando com Placeholders. A lista de seções é o esqueleto do seu layout e as palavras definem o tom.

Se algum estiver faltando, ou se o cliente tiver regras de marca ou uma folha de estilo existente, leia references/inputs.md primeiro. Em resumo: o texto vem primeiro, então execute landing-skills:landing-copy quando puder; caso contrário, trabalhe a partir do briefing e marque o que depende do texto como provisório.

Processo

Siga os passos em ordem. Os passos 1 a 3 produzem texto, não valores.

A ordem de leitura é uma regra. Escreva as seções Assunto e Direção antes de abrir qualquer arquivo em references/, com duas exceções: references/inputs.md, que você lê no início quando uma entrada está faltando, e references/visual-tells.md, que você lê no passo 2 para o teste de padrão. Em seguida, abra cada referência apenas no passo que a utiliza. A razão: uma tabela lida antes de a direção existir se torna a resposta, e leitores que leem as tabelas primeiro escolhem as mesmas fontes e paletas para clientes não relacionados.

Caminho curto. Para uma página de uma a três seções sem decisões de imagens a serem tomadas, estes passos ainda se aplicam na íntegra: assunto (1), direção com padrões rejeitados (2 e 3), tipografia encontrada por pesquisa (4), paleta com contraste (5) e os tokens principais (9). Estes se resumem a uma linha cada em direction.md: o mapa de layout (6), ativos (7) e intenção de movimento (8). As verificações de convergência nunca são puladas.

1. Inventarie o assunto

A partir do briefing e do texto, liste em substantivos simples, sob três tipos de fonte:

  • Material e objeto: do que o produto é feito ou o que ele manipula, as ferramentas, as texturas. Para software, as coisas com que seus usuários trabalham e sobre as quais trabalham.
  • Lugar e luz: onde é feito ou usado, a luz ali, a hora do dia, o clima, o som do ambiente.
  • Gesto e momento: o que alguém faz com ele, um som que ele faz, o momento de uso que mais importa (o primeiro uso, o trabalho concluído, a pausa antes de decidir).

Em seguida, adicione o contexto do público quando eles encontram a página, três a seis palavras do texto que descrevam como soa, e uma linha sobre o que o visitante deve acreditar antes de realizar a ação.

Escolha três âncoras, uma de cada tipo de fonte: coisas concretas com uma cor, uma textura, um ritmo ou um personagem que você possa nomear. Por exemplo, para outros clientes que não o seu: "o latão de uma bússola de navio" (material), "sol baixo de inverno sobre um canal congelado" (lugar e luz), "o barulho de uma lançadeira cruzando um tear" (gesto). A paleta, o tipo e as imagens derivam destas.

A papelada do ramo (formulários, recibos, etiquetas, desenhos, fichas técnicas, telas) conta como um tipo de fonte e pode fornecer no máximo uma âncora: é a coisa mais fácil de nomear, então atrai todos os clientes para a mesma aparência. O nome do produto ou da empresa pode fornecer uma âncora quando se refere a algo real (um rio, um pássaro, uma rua), nunca a paleta inteira.

2. Escreva a direção e sua razão

Escreva uma ou duas frases que nomeiem a aparência e a vinculam às âncoras, depois a razão: por que esta aparência atende a este público e a esta ação.

Escreva duas direções que você considerou e rejeitou, cada uma com sua razão. Pelo menos uma é o padrão óbvio para a categoria (escuro e neon para uma ferramenta de desenvolvedor, creme e serifa para um produto artesanal, azul frio para saúde). "O documento do ramo" (a página estilizada como o livro-razão, planta baixa, ficha técnica, recibo, etiqueta ou formulário do cliente) é um padrão no mesmo nível: se foi sua primeira ideia, rejeite-a com uma razão, a menos que você possa dizer o que a torna certa para este cliente e errada para um concorrente com a mesma papelada.

Em seguida, execute dois testes:

  • Teste de troca. Substitua o cliente por um negócio de outro ramo. Se a direção ainda se encaixar, é genérica; reescreva-a até que nomeie algo que apenas este cliente tenha.
  • Teste de padrão. Leia references/visual-tells.md e compare seu plano com os padrões que ele lista. Se o plano corresponder a um, dê a razão específica para este cliente por escrito ou mude o plano.

3. Comprometa-se por escrito

Escreva as seções Assunto e Direção de landing/direction.md agora, antes de qualquer token existir. Tudo depois disso deve remontar a elas. Quando uma escolha posterior não o fizer, mude a escolha ou revise a direção propositalmente e diga isso no arquivo.

4. Tipografia

Trabalhe a partir das âncoras, não de uma palavra de tom: uma palavra de tom se encaixa em muitas fontes, e todo leitor com a mesma palavra escolhe a mesma. Use as palavras sonoras do texto apenas como uma verificação do resultado.

  1. Escreva dois a quatro requisitos que a fonte deve atender, cada um verificável em um exemplar e vinculado a uma âncora (formas suaves e arredondadas como pedras de rio desgastadas; um slab pesado; algarismos old-style em texto corrido). Escreva-os antes de abrir references/typography.md.
  2. Decida quantas fontes: uma família, duas faces, ou também uma fonte mono, pelos critérios em references/typography.md ("Decida quantas fontes"). Display mais texto mais mono não é a forma padrão.
  3. Abra references/typography.md e siga seus passos 3 e 4: filtre os catálogos com seus requisitos rígidos, registre o filtro e o número de correspondências, observe uma variedade do resultado, faça uma lista de pelo menos três por função com pelo menos duas encontradas por pesquisa, confirme as características em fontes legíveis, escolha, registre dois candidatos rejeitados e execute sua verificação de convergência. Sua seção "Primeiras fontes alcançadas" lista as fontes que os leitores alcançam primeiro.
  4. Escolha um fallback metricamente próximo para cada pilha de fontes, pelo método no mesmo arquivo ("Notas de carregamento de fontes"), e registre o porquê.
  5. Dimensione o herói para seu título real; o mesmo arquivo tem os números.

5. Cor

Derive a paleta das âncoras em OKLCH pelo método em references/colour.md, incluindo a tinta e o fundo, que são derivados como qualquer outra cor. Registre cada cor com sua função, valor oklch(), fallback hex sRGB e âncora, e a taxa de contraste WCAG 2.2 de cada par de texto e fundo que você usará. A leveza OKLCH não é uma taxa de contraste; calcule a taxa com o script nesse arquivo.

Quando a paleta for derivada, execute a verificação de convergência de cores em references/colour.md. O mesmo arquivo cobre cores de estado, cor de link, primeiros acentos alcançados, valores provisórios quando nenhum ativo pode ser amostrado e um tema escuro projetado propositalmente.

6. Layout

Mapeie cada H2 em copy.md para uma decisão de layout: largura, alinhamento, densidade, fundo e qual recurso visual ele carrega. Escolha a uma ou duas seções de destaque pelo teste em references/layout.md ("Onde gastar ousadia"); uma faixa escura invertida é uma escolha com um critério lá, não o padrão.

7. Imagens e ativos

Para cada visual que o mapa de seção precisa, registre o que mostra, sua proporção de aspecto e se o ativo existe. references/assets.md cobre fotografia, ilustração, fotos de produto, ícones, logotipos e o caso sem ativos. Um ativo faltando recebe um espaço reservado etiquetado em sua proporção final e uma linha na lista de solicitações. Nenhuma foto de banco de imagens de pessoas, nenhuma captura de tela inventada, nenhuma marca de logotipo desenhada; uma marca nominativa digitada na fonte de exibição é um substituto aceitável, registrado como uma proposta.

8. Intenção de movimento e 3D

Decida se a página precisa de movimento ou 3D; none é uma resposta válida e frequentemente correta. Para cada momento que você nomear, dê seu lugar, o que mostra, seu propósito (explicar o produto, confirmar uma ação, guiar a atenção para uma coisa) e sua versão de movimento reduzido. Uma cena 3D também precisa de uma imagem de pôster estática.

Mantenha-se em um momento de assinatura por padrão. Mais é justificado quando cada um explica uma coisa diferente que uma imagem estática não pode mostrar. Quando os Momentos desejados do briefing pedem vários, o briefing vence: nomeie cada um, dê a cada um seu propósito e forma de movimento reduzido, e posicione-os de modo que não compartilhem a mesma tela. landing-skills:landing-motion implementa exatamente o que você escreve aqui.

9. Escreva os tokens

Escreva landing/tokens.css conforme descrito em "Formato de saída". Cada token de cor e fonte aparece em direction.md com sua razão; cada escala (texto, espaço, raio) é explicada uma vez, com sua base ou proporção e para que servem seus passos. Defina apenas tokens que a página usará.

Raio: dois valores são suficientes quando o design tem dois tipos de elemento; adicione um terceiro apenas para um terceiro tipo real. --radius-control é sempre um deles. Tema: registre claro, escuro ou ambos em Cor; o arquivo de tokens não contém propriedade color-scheme, e a construção a define para corresponder.

10. Autoverificação e entrega

Execute as verificações em "Autoverificação". Em seguida, diga ao usuário o que você decidiu em algumas linhas, liste os ativos a solicitar e nomeie a próxima skill: landing-skills:landing-build.

Formato de saída

Leia references/example.md agora, apenas para o formato de ambos os arquivos. Seus valores pertencem a um cliente inventado e não são candidatos para o seu.

landing/direction.md

Use estes H2s nesta ordem. O último H2 é sempre Intenção de movimento e 3D.

  1. Assunto: o inventário e as três âncoras.
  2. Direção: a frase, a razão, as direções rejeitadas com razões e o resultado do teste de troca.
  3. Tipografia: o registro listado em references/typography.md ("Registrando a decisão").
  4. Cor: âncoras com OKLCH (marcado provisório quando estimado), tabela de funções, tabela de contraste, decisão de tema, qualquer frase de convergência.
  5. Layout: grade, ritmo, uma linha por seção de texto, onde a ousadia vai.
  6. Imagens e ativos: cada visual com proporção de aspecto e status, depois a lista de solicitação de ativos.
  7. Superfícies e detalhes: raio, bordas, sombras, ícones, com razões.
  8. Intenção de movimento e 3D: none com uma razão, ou uma entrada por momento.

landing/tokens.css

Propriedades personalizadas em :root apenas, com cinco prefixos e nenhum outro: --color-*, --font-*, --text-* (tamanhos, entrelinha, tracking), --space-* (espaçamento, ritmo, medida) e --radius-*. Nenhum outro seletor, nenhum @font-face, nenhum estilo de componente.

Escreva os valores hex sRGB em :root, depois os valores oklch() dentro de um bloco @supports (color: oklch(0 0 0)). Uma propriedade personalizada assume o último valor declarado mesmo quando o navegador não pode analisá-lo como uma cor, portanto duas declarações em uma regra não são um fallback. references/colour.md tem os esqueletos, incluindo o tema escuro.

Cada tokens.css contém este conjunto principal, com exatamente estes nomes, para que landing-skills:landing-build possa confiar neles:

TokenPara
--color-bgo fundo da página
--color-inktexto do corpo e títulos no fundo da página; links inline, sublinhados
--color-ink-mutedlegendas e texto secundário no fundo da página
--color-lineréguas e divisores
--color-actiona cor do controle: o preenchimento da ação primária
--color-action-hovero estado de hover e pressionado da ação
--color-on-actiontexto sobre o preenchimento da ação
--font-displaytítulos (a mesma família que --font-text quando uma família é usada)
--font-texttexto do corpo
--text-basetamanho do corpo
--text-displayo tamanho do título herói, ajustado ao seu comprimento
--space-gutterpreenchimento lateral da página
--space-section-openpreenchimento das seções que carregam a afirmação
--space-section-densepreenchimento de seções de leitura rápida
--space-content-maxlargura máxima do conteúdo
--radius-controlcantos de botões e entradas

Todo o resto é livre, dentro dos cinco prefixos. Cada fundo adicional que carrega texto recebe um token emparelhado, --color-<fundo> com --color-on-<fundo>, e cada par tem uma taxa calculada. Nunca use um token de fundo como cor de texto. Um acento usado em uma faixa escura precisa de seu próprio passo de aprovação para essa faixa ou permanece fora dela (references/colour.md).

Autoverificação

Antes de entregar, confirme cada linha. Corrija o que falha.

  • Você releu references/visual-tells.md e verificou a direção e os tokens contra cada cluster e a tabela de sinais que o detector não pode ver. Esta verificação é obrigatória.
  • direction.md tem os oito H2s em ordem e termina com Intenção de movimento e 3D.
  • Três âncoras de três tipos de fonte, no máximo uma de papelada; o teste de troca passa; duas direções rejeitadas, uma o padrão da categoria.
  • Tipografia: o registro em references/typography.md ("Registrando a decisão") está completo, incluindo o filtro de pesquisa e contagem, as marcas lembradas ou encontradas e a frase de convergência onde sua regra se aplica.
  • Nenhuma fonte dos conjuntos em references/typography.md ("Fontes excessivamente usadas") sem sua razão por escrito.
  • O tamanho do título herói se ajusta ao seu comprimento.
  • Cor: cada cor tem uma âncora ou uma função, um valor oklch() e um fallback hex; a verificação de convergência de cores em references/colour.md foi executada após a derivação.
  • Cada par de texto que você usará...

Individual skills in this repo

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

Habilidades Relacionadas