Communitygithub.com

figma-designer

Projete no Figma como este designer: variáveis reais, estilos de texto, layout automático e componentes, em um sistema visual fixo (escala de tipo e raio do Tailwind, tokens de espaçamento, tokens de cor em duas camadas, regras de botão e estado). Use esta habilidade sempre que criar, editar ou revisar algo em um arquivo Figma através do Figma MCP.

O que é figma-designer?

Esta skill transforma o agente em um designer de interface especializado que opera dentro do Figma seguindo regras rígidas de design system. Ela impõe o uso de variáveis reais para cores (em duas camadas: Core Colors e Color System com modos Claro/Escuro), tokens de espaçamento e raio baseados na escala do Tailwind, e estilos de texto nomeados. O agente é instruído a verificar o arquivo existente antes de criar novos tokens, construir fundações primeiro (variáveis, estilos, frame Foundations), e depois construir telas seção por seção, usando auto layout e vinculação de variáveis em vez de valores fixos. A skill também cobre regras de tipografia (apenas uma fonte, sem itálico, escala Tailwind), contraste e acessibilidade (4.5:1 para corpo), layout (largura máxima do hero 680, frames desktop 1440px), ícones (Phosphor/Solar/Iconamoon), componentes interativos com estados (Default, Hover, Pressed, Focus, Disabled para botões com 5 tipos × 5 estados), e uma checklist de auto-verificação antes de finalizar. Funciona com o Figma MCP, carregando as skills auxiliares `figma-use`, `figma-generate-design` e `figma-generate-library` conforme necessário. É indicada para criação de telas, landing pages, componentes, mockups, sistemas de design e tokens, e deve ser carregada antes de qualquer chamada `use_figma`.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamsabbirhasann/ai-design-skills-main/tree/HEAD/skills/figma-designer

Perguntar na sua IA favorita

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

Documentação

Figma Designer

Estas são as regras do próprio designer para trabalhar no Figma. Elas se sobrepõem às habilidades oficiais do Figma e não as substituem.

  • Carregue figma-use antes de qualquer chamada use_figma. Ela contém as regras da API de Plugin (faixas de cores, carregamento de fontes, dimensionamento de layout). Esta skill adiciona apenas regras de design.
  • Para telas e páginas completas, carregue também figma-generate-design. Para bibliotecas de componentes e tokens, carregue também figma-generate-library.
  • Os nomes e valores exatos dos tokens estão na Referência de tokens no final deste arquivo. Leia-a antes de criar ou vincular qualquer variável ou estilo de texto.

Fluxo de trabalho

  1. Verifique o arquivo primeiro. Liste as coleções de variáveis locais e estilos de texto, e pesquise nas bibliotecas do arquivo (search_design_system) por variáveis, estilos e componentes. Reutilize o que existe antes de criar algo.

  2. Configure as fundações se estiverem faltando. Crie tudo abaixo antes de construir qualquer tela:

    • as variáveis spacing e radius
    • as duas camadas de cor (Core Colors, depois Color System com modos Claro e Escuro)
    • os estilos de texto

    Claro e escuro são modos de variável, nunca dois conjuntos de cores fixas.

    • Mostre os tokens na tela. Coloque um frame Foundations na página Foundations, da mesma forma que os componentes ficam em seu próprio frame. Dentro dele, adicione uma seção de layout automático para cada coleção:
      • Core Colors: uma linha por paleta, uma amostra por tom
      • Color System: uma linha por grupo, com os modos Claro e Escuro lado a lado usando modos de variável explícitos em duas colunas
      • spacing: uma barra por token, dimensionada ao seu valor
      • radius: um quadrado por token, com esse raio
      • Estilos de texto: uma linha de amostra por estilo
    • Vincule as amostras para que elas atualizem com os tokens. Cada preenchimento de amostra está vinculado à sua variável. Cada barra de espaçamento e amostra de raio está vinculada à sua variável. Cada amostra de texto usa seu estilo. Quando o usuário edita um token, o frame se atualiza sozinho.
    • Rótulos: cada amostra é rotulada com seu nome de token e, para Color System, seu alias (Surface/Primary → Grayscale/870). O texto não pode se vincular a um valor de cor, então os rótulos hex não se atualizam sozinhos. Ressincronize os rótulos sempre que criar, renomear ou alterar tokens.
  3. Construa seção por seção. Faça o hero primeiro, depois uma seção por etapa. Nunca construa uma página inteira de uma só vez. Faça uma captura de tela após cada seção e corrija-a antes de prosseguir.

  4. Use layout automático em todos os lugares. Todo frame com filhos usa layout automático. Preenchimento e espaçamento são vinculados a variáveis de espaçamento, nunca a números digitados.

  5. Vincule, não digite.

    • Vincule cada preenchimento, traço, raio, preenchimento e espaçamento a uma variável.
    • Cada camada de texto usa um estilo de texto.
    • Vincule designs apenas a tokens do Color System, nunca diretamente a Core Colors.
  6. Auto-verifique antes de finalizar. Execute a checklist no final deste arquivo, corrija cada falha e depois relate o que foi construído e o que foi pulado.

Tipografia

  • Fontes: qualquer fonte é permitida. Use a que o usuário ou a marca nomear; verifique-a com figma.listAvailableFontsAsync() antes de carregar.
  • Uma única família tipográfica por arquivo, a menos que o usuário peça um par. Geist Mono é permitida ao lado da fonte principal apenas para código, dados ou números.
  • Sem estilos itálicos. Sem pesos acima de bold.
  • Os tamanhos vêm apenas da escala de tipo do Tailwind: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60, 72, 96, 128. Se um tamanho cair entre os degraus, arredonde para o degrau abaixo e use sua altura de linha.
  • Estilos de texto. Crie os estilos nomeados na Referência de tokens → Estilos de texto (Heading 1 a 6, Title 1 a 5, Body 1 a 6, Button-lg/md/sm/Xsm, Caption 1 a 5). Use os nomes exatamente, incluindo capitalização.
    • Agrupe-os em pastas por tipo, para que o painel leia Heading / Heading 1, Body / Body 4, Button / Button-md.
    • Cada camada de texto usa um desses estilos. Nunca defina um tamanho ou peso solto; alterar o peso em uma camada com estilo desvincula o estilo.
  • Qual grupo usar:
    • Heading: cabeçalhos de página e seção, do maior ao menor. Heading 1 é o hero.
    • Title: títulos de cartão, títulos de itens de lista, rótulos que lideram um bloco, itens de navegação.
    • Body: texto corrido. Dentro de cada tamanho, 1 é o peso mais forte e o último é regular.
    • Button: texto dentro de botões apenas. Botões principais usam Button-md; botões pequenos de cabeçalho usam Button-sm.
    • Caption: metadados, texto de ajuda, badges, timestamps, letras miúdas.
  • Novos estilos. Se um projeto precisar de um, adicione o próximo número em seu grupo (por exemplo Body 7), construído a partir de um degrau da escala. Nunca invente um novo nome ou um tamanho fora da escala.
  • Cópia:
    • Sem hífens dentro do texto.
    • Nenhuma palavra sozinha na última linha de um cabeçalho. Quebre os cabeçalhos manualmente em pontos significativos (use uma quebra de linha no texto, não um frame mais estreito).
    • O cabeçalho hero (Heading 1) não tem pontos finais, nem no final nem entre frases. Separe duas ideias com uma quebra de linha: Veja a bagunça / Decida o que consertar, não Veja a bagunça. Decida o que consertar.

Espaçamento

  • Use apenas as variáveis numéricas spacing/*: 0, 2, 4, 8, 12, 16, 24, 32, 40, 48, 64, 80, 96. Nada no meio.
  • Vincule paddingTop/Right/Bottom/Left e itemSpacing a elas com setBoundVariable. Dê às variáveis de espaçamento o escopo GAP, que cobre tanto preenchimento quanto espaçamento.
  • Quando um valor de design cair entre tokens, arredonde para o token mais próximo e vincule-o.
  • Botões principais usam 8 de preenchimento vertical (spacing/75) e 12 horizontal (spacing/100).

Raio de canto

  • Use apenas valores de raio do Tailwind (0, 2, 4, 6, 8, 12, 16, 24, full), como variáveis radius/* com o escopo CORNER_RADIUS. Vincule cada canto (topLeftRadius…).
  • Regra de raio aninhado. Quando uma forma está dentro de outra e o espaçamento entre elas é inferior a 32: raio interno = raio externo − espaçamento Aplique-a apenas quando o resultado for maior que 2. Exemplo: um cartão com 16 de raio e 8 de preenchimento dá aos elementos internos 8.
  • Verifique isso em cada frame aninhado: leia o raio e o preenchimento do pai, calcule o raio do filho e defina-o para a variável radius/* correspondente.

Cor

Estrutura de token: duas camadas, em todos os arquivos

Os nomes e a estrutura são fixos. Os valores hex seguem a marca do usuário. Lista completa de nomes: Referência de tokens → Cor.

  1. Coleção Core Colors: paletas brutas. Primary, Secondary, Accent, Grayscale, e paletas semânticas Red (erro), Green (sucesso) e Yellow (aviso).
    • Cada paleta tem pelo menos 10 tons, de 00 (quase branco) a 1000 (quase preto). 500 é o matiz base.
    • Construa os tons a partir das cores base da marca.
    • Cores transparentes também ficam aqui, como uma paleta Grayscale-Alpha (700-16 … 700-80) com a opacidade armazenada na variável. Um alias não pode adicionar opacidade, então Overlay/* cria alias destes.
  2. Coleção Color System: tokens semânticos com modos Light e Dark. Cada valor é um alias para uma Core Color, nunca um hex bruto.
    • Grupos: Border/, Surface/, Action/, Text/, Icon/, Overlay/.
    • Cada função tem um token base mais as variantes que precisa: -Hover, -Click ou -Selected, -Disabled, -Subtle, -Inverted.
  • Designs vinculam-se apenas a tokens do Color System. Uma reformulação de marca então muda apenas Core Colors.
  • Nomeie tokens pela função, nunca pela cor bruta (sem Surface/Blue 500).
  • Escopo das variáveis para o que elas colorem: FRAME_FILL/SHAPE_FILL para superfícies, TEXT_FILL para texto, STROKE_COLOR para bordas. Nunca deixe ALL_SCOPES.

Superfícies

  • Fundos do modo escuro, apenas estes: #000000 · #181818 · #1F1F1F · #272727 · #313131 · #131209

  • Sem gradientes de fundo. As superfícies são planas. Isso inclui botões e sobreposições de fade.

  • O cabeçalho hero é a única exceção de gradiente, no texto apenas, da esquerda para a direita:

    • tema escuro #FFFFFF → #9B9B9B
    • tema claro #000000 → #666666

    Vincule ambas as paradas do gradiente a variáveis de cor (boundVariables.color em cada parada) para que o gradiente alterne com o modo.

  • Uma cor de destaque, mantida abaixo de 80% de saturação.

  • As bordas vão ao redor de todo o elemento ou não vão. Nunca uma borda de um único lado em um cartão. Para dividir linhas, use um retângulo de 1px preenchido com um token Border/*, não um traço de um lado.

Contraste e acessibilidade

  • Texto do corpo: pelo menos 4.5:1 contra seu fundo.
  • Texto grande (24 e acima, ou 18 negrito e acima) e partes da UI (ícones, bordas de entrada, anéis de foco): pelo menos 3:1.
  • Em cabeçalhos com gradiente, verifique o contraste na extremidade mais clara do gradiente, não na mais escura.
  • Nunca confie apenas na cor para mostrar o estado. Combine-a com um ícone, rótulo ou mudança de peso.
  • Alvos de toque têm pelo menos 44 × 44 em frames móveis.
  • Se uma cor da marca falhar no contraste com o texto branco, use um tom mais escuro da mesma paleta para o token Action/* em vez de alterar o texto.

Layout

  • Largura máxima do cabeçalho hero e subtítulo 680.
  • Sem tag de sobrancelha (a pequena pílula ou rótulo acima de um cabeçalho, como ● Design QA, não um redesign) por padrão. Adicione uma apenas quando o usuário pedir, ou quando uma imagem de inspiração que o usuário enviou mostrar uma.
  • Frames desktop têm 1440 de largura, com um contêiner de conteúdo centralizado de 1200 a 1280.
  • Adicione frames de 768 e 390 quando a tela precisar de versões responsivas.
  • Não padronize três cartões iguais em uma linha. Considere um zigue-zague de duas colunas, uma grade assimétrica ou um layout bento.
  • Alinhe elementos compartilhados entre cartões lado a lado: títulos, preços, listas e botões começam no mesmo Y.

Ícones

  • Use Phosphor, Solar ou Iconamoon. Nunca Material Icons ou Material Symbols.
  • Use um peso de traço em todo o arquivo.
  • Importe ícones como SVG (createNodeFromSvg) e recolorir-os com um token Icon/* vinculado. Nunca redesenhe um ícone a partir de primitivas.

Componentes e estados

  • Qualquer coisa usada mais de uma vez é um componente. Exponha seu texto como propriedades de componente.

  • Componentes interativos obtêm variantes para Default, Hover, Pressed, Focus, Disabled. Campos de entrada também obtêm Error e Filled.

  • Botões são um conjunto de componentes com estas duas propriedades, todas as combinações presentes (25 variantes por tamanho):

    • Type = Primary | Secondary | Tertiary | Error | Warning
    • State = Default | Hover | Pressed | Focus | Disabled

    Vincule preenchimentos a Action/* (por exemplo Action/Primary, Action/Primary-Hover, Action/Primary-Click, Action/Primary-Disabled), bordas a Border/* e rótulos a Text/*. Focus adiciona um anel visível (traço externo de 2px com contraste 3:1 ou melhor), não apenas uma mudança de cor.

  • Visualizações de dados obtêm estados Loading (um esqueleto com a forma do layout real), Empty (uma visualização de introdução composta) e Error.

Movimento (apenas protótipo)

  • Use Smart Animate com a bezier personalizada 0.22, 1, 0.36, 1:
    • 500ms para mudanças de layout
    • 300ms para cor ou opacidade
  • Nunca use as predefinições lineares ou de facilitação padrão do Figma.

Conteúdo

  • Cópia de rascunho real, nunca texto de espaço reservado.
  • Use nomes, marcas e números críveis para a indústria do produto. Evite números suspeitamente redondos e nomes genéricos como "Acme".
  • Preenchimento proibido: "revolucionário", "potencializar", "vanguarda", "sem esforço", "transforme seu fluxo de trabalho", "leve ao próximo nível", "aproveite o poder", "classe mundial".
  • Uso de letra minúscula para cabeçalhos e botões.

Landing pages

Quando a tarefa for uma landing page, siga também a habilidade landing-page-design do usuário para estrutura de página e cópia (perguntas iniciais, ordem das seções, regras de CTA). Isso inclui a seção obrigatória de tagline grande com uma revelação palavra por palavra, mostrada como uma interação de protótipo. Se essa habilidade não estiver disponível, peça ao usuário por ela antes de planejar as seções.

Higiene do arquivo

  • Nomeie cada camada de forma significativa (Pricing / Card / Pro). Nunca deixe Frame 427, Group 3, Vector ou Rectangle 1.
  • Coleções de variáveis: spacing, radius, Core Colors e Color System, com modos Light e Dark em Color System.
  • Estilos de texto usam os nomes acima, agrupados em pastas por tipo.
  • Uma página por área: Foundations, Components, Screens.
  • Coloque novos frames de nível superior em espaço claro da tela, nunca sobre o trabalho existente. Não exclua ou mova as camadas existentes do usuário, a menos que solicitado.

Checklist (execute antes de relatar)

  • Cada camada de texto usa um estilo de texto nomeado (Heading, Title, Body, Button, Caption) na escala do Tailwind
  • Cada preenchimento e espaçamento está vinculado a uma variável de espaçamento
  • Cada raio está vinculado a uma variável de raio, e raios aninhados seguem a fórmula
  • Cada preenchimento e traço está vinculado a um token do Color System (nunca a um hex bruto ou Core Color), e os modos Claro e Escuro funcionam ambos
  • As paletas Core Colors têm pelo menos 10 tons cada, e cada token do Color System é um alias
  • O frame Foundations mostra cada token e estilo de texto, com amostras vinculadas às suas variáveis e rótulos sincronizados
  • O contraste passa 4.5:1 para o corpo e 3:1 para texto grande e partes da UI
  • Sem gradientes de fundo, sem bordas de um lado, sem itálico
  • Cabeçalho hero e subtítulo limitados a 680, o cabeçalho hero não tem pontos finais, e não há tags de sobrancelha, a menos que solicitado ou mostrado em uma imagem de inspiração enviada
  • Componentes interativos têm todas as variantes de estado, e botões têm todos os 5 tipos × 5 estados
  • Ícones de Phosphor, Solar ou Iconamoon com um peso de traço
  • Sem cópia de espaço reservado, sem camada nomeada Frame ou Group

Referência de tokens

Os nomes são fixos. Os valores hex de cor seguem a marca do usuário; os valores de espaçamento, raio e tipo são fixos.

Espaçamento

Coleção spacing, um modo, FLOAT, escopo GAP.

TokenValor
spacing/00
spacing/252
spacing/504
spacing/758
spacing/10012
spacing/20016
spacing/30024
spacing/40032
spacing/50040
spacing/60048
spacing/70064
spacing/80080
spacing/90096

Raio

Coleção radius, um modo, FLOAT, escopo CORNER_RADIUS.

TokenValor
radius/00
radius/22
radius/44
radius/66
radius/88
radius/1212
radius/1616
radius/2424
radius/full9999

Estilos de texto

A fonte é a única do arquivo.

Heading

NomeTamanhoPesoAltura da linha
Heading 172Bold80
Heading 260Bold68
Heading 348Bold56
Heading 436Bold44
Heading 530Bold38
Heading 624Bold32

Title

NomeTamanhoPesoAltura da linha
Title 120Bold28
Title 220Medium28
Title 318Bold26
Title 418Medium26
Title 516Bold24

Body

NomeTamanhoPesoAltura da linha
Body 116Bold24
Body 216Medium24
Body 316Regular24
Body 414Bold20
Body 514Medium20
Body 614Regular20

Button

NomeTamanhoPesoAltura da linha
Button-lg18Medium26
Button-md16Medium24
Button-sm14Medium20
Button-Xsm12Medium16

Caption

NomeTamanhoPesoAltura da linha
Caption 112Bold16
Caption 212Medium16
Caption 312Regular16
Caption 410Medium14
Caption 510Regular14

Cor

Core Colors

Coleção Core Colors, com um modo.

Primary (Primary/00 … Primary/1000) Secondary (Secondary/00 … Secondary/1000) Accent (Accent/00 … Accent/1000) Grayscale (Grayscale/00 … Grayscale/1000) Red (Red/00 … Red/1000) Green (Green/00 … Green/1000) Yellow (Yellow/00 … Yellow/1000) Grayscale-Alpha (Grayscale-Alpha/700-16 … Grayscale-Alpha/700-80)

Color System

Coleção Color System, com modos Light e Dark.

Border/ — Border/Primary, Border/Secondary, Border/Subtle, Border/Hover, Border/Disabled, Border/Error

Surface/ — Surface/Primary, Surface/Secondary, Surface/Tertiary, Surface/Subtle, Surface/Inverted, Surface/Hover, Surface/Click

Action/ — Action/Primary, Action/Primary-Hover, Action/Primary-Click, Action/Primary-Disabled, Action/Secondary, Action/Secondary-Hover, Action/Secondary-Click, Action/Secondary-Disabled, Action/Tertiary, Action/Tertiary-Hover, Action/Tertiary-Click, Action/Tertiary-Disabled, Action/Error, Action/Error-Hover, Action/Error-Click, Action/Error-Disabled, Action/Warning, Action/Warning-Hover, Action/Warning-Click, Action/Warning-Disabled

Text/ — Text/Primary, Text/Secondary, Text/Subtle, Text/Inverted, Text/Disabled, Text/Link, Text/Error, Text/Warning, Text/Success

Icon/ — Icon/Primary, Icon/Secondary, Icon/Subtle, Icon/Inverted, Icon/Disabled, Icon/Accent, Icon/Error, Icon/Warning, Icon/Success

Overlay/ — Overlay/Subtle, Overlay/Medium, Overlay/Heavy

Habilidades Relacionadas