Skill Figma Generate Library
A skill da Figma para criar um design system no Figma a partir do seu código: variáveis, modos claro e escuro, estilos e componentes com variantes.
Oficial · Figma| Autor | Figma |
|---|---|
| Licença | No licence file; Figma Developer Terms apply |
| Fonte | figma/mcp-server-guide · SKILL.md no GitHub |
| Site do projeto | developers.figma.com/docs/figma-mcp-server |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
A skill figma-generate-library é a skill oficial da Figma para agentes criarem ou atualizarem um design system no Figma a partir do seu código. Ela lê as suas variáveis CSS, arquivos de tema e componentes e cria as variáveis correspondentes no Figma (com modos claro e escuro), estilos de texto e de efeito e componentes com conjuntos de variantes bem montados, com cada propriedade vinculada a uma variável em vez de um valor fixo.
Ela decide o que criar e em que ordem; a skill complementar figma-use decide como cada script de canvas é escrito, por isso as duas são sempre carregadas juntas. Ela funciona pelo servidor MCP remoto do Figma e exige uma conta no Figma e um arquivo que você possa editar. O tamanho do trabalho acompanha o pedido: um conjunto de tokens, um componente, uma biblioteca completa ou a reconciliação do que ficou diferente entre o código e o Figma.
Do SKILL.md da skill: Build professional-grade design-system assets in Figma that match code.
O que ela faz
- Escolhe um único escopo antes de mexer no arquivo (só tokens, um componente ou família, uma biblioteca completa ou uma reconciliação código-Figma) e publica uma checklist curta do que vai entregar e de como vai conferir.
- Descobre primeiro: analisa o código relevante, examina as páginas, variáveis e estilos que o arquivo já tem, lista as bibliotecas que o arquivo pode usar e pesquisa nelas, e pergunta a você quando o código e o Figma discordam sobre um valor.
- Cria coleções de variáveis e modos (por exemplo, Primitives mais uma coleção Color com Light e Dark), variáveis semânticas como aliases das primitivas, um escopo em cada variável e a sintaxe de código var() do CSS que aponta de volta para o seu código.
- Monta os componentes em ordem de dependência, com conjuntos de variantes, propriedades de componente e vínculos com variáveis; usa instance swap para ícones em vez de uma variante por ícone e divide qualquer matriz com mais de 30 variantes.
- Numa biblioteca completa, adiciona páginas de capa, de primeiros passos, de fundamentos e de componentes, depois os mapeamentos do Code Connect e uma auditoria final de acessibilidade, nomes e vínculos.
- Mantém um registro de estado com todos os IDs criados em um arquivo JSON, para que uma montagem longa possa continuar em um novo chat, e nunca roda dois scripts de canvas ao mesmo tempo.
O que você recebe
- Variáveis, modos, estilos de texto, estilos de efeito, componentes e conjuntos de componentes no seu arquivo do Figma, além de páginas de documentação quando o escopo as inclui.
- Um arquivo de estado no seu computador (/tmp/design-system-state-<run id>.json) que lista o que foi criado, usado para retomar a montagem.
Quando usar
- Os seus design tokens e componentes estão no código e a biblioteca do Figma não existe, está incompleta ou desatualizada.
- Você precisa de um componente novo no Figma feito do jeito certo, com variantes e vínculos com variáveis em vez de desenhado à mão.
- Você está configurando temas claro e escuro como modos de variáveis do Figma que correspondam ao seu CSS.
- O código e o Figma ficaram diferentes e você quer atualizar no lugar só os tokens e componentes que mudaram.
Quando não usar
- Você quer uma tela ou página montada a partir de uma biblioteca existente: isso é com a figma-generate-design.
- Você quer código a partir de um design do Figma: use a figma-design-to-code.
- Você não tem código nem fonte de tokens para usar como base e quer que uma marca seja inventada: a skill cria o que o código define e pergunta em vez de chutar.
- Você só tem um assento View ou Collab em um arquivo compartilhado: gravar fora dos seus rascunhos exige um assento Full.
O que ela exige
- Uma conta no Figma e um arquivo que você possa editar. A documentação da Figma diz que gravar fora dos seus rascunhos exige um assento Full, e que gravar no canvas é grátis durante o beta e depois será um recurso pago, cobrado por uso.
- O servidor MCP remoto do Figma (https://mcp.figma.com/mcp) conectado ao seu agente e com login feito no Figma.
- A skill figma-use da Figma, que esta skill exige em todo script de canvas. O plugin do Figma instala as duas.
- O seu código (ou um arquivo de tokens) como fonte da verdade. As ferramentas de leitura contam para os limites de uso da Figma: até 20 chamadas por mês no plano Starter ou em um assento View ou Collab; as ferramentas de gravação ficam de fora.
- Tempo, para uma biblioteca completa: ela roda em fases com pontos de controle, e a skill entrega um prompt de continuação para retomar em um novo chat.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | O contrato de escopo, o fluxo de cada escopo, 15 regras de design system, o registro de estado, a matriz de reutilização de bibliotecas e quando perguntar a você. |
references/discovery-phase.md | Como analisar o código e o arquivo do Figma antes de mudar qualquer coisa. |
references/token-creation.md | Coleções, modos, aliases, escopos e sintaxe de código, incluindo um padrão maior para várias marcas. |
references/component-creation.md | Como montar componentes e conjuntos de variantes com propriedades e vínculos. |
references/documentation-creation.md | Páginas de capa, de primeiros passos e de fundamentos. |
references/code-connect-setup.md | Como mapear componentes do Figma para componentes do código e definir a sintaxe de código das variáveis. |
references/naming-conventions.md | Nomes para variáveis, páginas, variantes e estilos quando o arquivo ainda não tem uma convenção. |
references/error-recovery.md | O que fazer quando um script falha e como limpar com segurança um trabalho abandonado. |
scripts/*.js | Oito scripts auxiliares embutidos nas chamadas de canvas: examinar o arquivo, criar coleções e tokens semânticos, montar conjuntos de variantes, vincular variáveis, criar uma página de documentação, validar e remover só os órfãos listados. |
Licença conforme encontrada no repositório em 2026-11-15: No licence file; Figma Developer Terms apply.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- Use a figma-generate-library para criar variáveis do Figma a partir de src/styles/tokens.css neste arquivo: <file URL>. Primitives mais uma coleção Color com os modos Light e Dark.
- Monte o nosso componente Button no Figma a partir de components/Button.tsx, com as variantes Size, Variant e State vinculadas às nossas variáveis.
- Compare o nosso tema do Tailwind com as variáveis desta biblioteca do Figma e atualize só o que mudou.
- Monte um design system completo em um novo arquivo do Figma a partir deste repositório: fundamentos, Button, Input, Card, Badge e uma página de primeiros passos.
Como instalar a skill figma-generate-library
Conecte o servidor MCP do Figma e instale também a figma-use
No Claude Code, o caminho mais rápido é o plugin da Figma no marketplace oficial da Anthropic: ele adiciona o servidor MCP e todas as skills da Figma, incluindo a figma-use, de que esta skill precisa. Depois de instalar, execute /mcp no Claude Code e entre no Figma pelo navegador.
Copiar a pasta à mão também funciona, desde que a figma-use seja copiada ao lado dela (os comandos abaixo fazem as duas coisas) e o servidor MCP seja adicionado com o segundo comando.
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpNo Cursor, no Gemini CLI e no VS Code
O guia da Figma instala o mesmo plugin no Cursor com /add-plugin figma no chat do agente, e como extensão do Gemini CLI (depois /mcp auth figma). No VS Code, adicione um servidor MCP HTTP com a mesma URL e use o modo agente do Copilot.
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guidePor que não há caminho pelo claude.ai nem pela API
Todas as etapas chamam ferramentas MCP ativas do Figma, como use_figma, get_libraries e search_design_system. O sandbox de skills da Claude API não tem acesso à rede, e não verificamos uma configuração no claude.ai, por isso esta página traz só as configurações de agentes.
Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:
Claude Code: pelo marketplace de plugins
- Abra o Claude Code em um terminal com
claude. - Este plugin está no marketplace oficial da Anthropic, que o Claude Code adiciona automaticamente na primeira vez que você o abre.
- Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
/plugin install figma@claude-plugins-official - Digite / e procure
/figma:figma-generate-library, ou simplesmente peça a tarefa.
Pelo shell, em vez de dentro de uma sessão:
claude plugin install figma@claude-plugins-officialO plugin é instalado inteiro, então outras skills vêm junto, incluindo figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, figma-use-figjam, figma-use-motion, figma-use-slides.
Claude Code: copie a pasta para a sua pasta de skills
Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /figma-generate-library ou apenas descreva a tarefa.
No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.
Codex, Gemini CLI, Cursor e GitHub Copilot
Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:
git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-generate-library .agents/skills/
cp -R mcp-server-guide/skills/figma-use .agents/skills/| Agente | Pasta do projeto | Sua pasta de usuário | Observações |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente). |
Fontes destas instruções
Conferido com a documentação de cada fornecedor em 2026-11-14:
Primeiro o escopo, depois parar
A skill foi escrita para não inflar o escopo. Um pedido de um componente não vira uma biblioteca completa: ela cria só os tokens que faltam para esse componente, valida o resultado, mostra os estados pedidos como instâncias em um único frame compacto e para. Um pedido só de tokens não ganha componentes.
Cada escopo tem a sua própria definição de pronto (cobertura de variantes, escopos e aliases de variáveis, sintaxe de código, vínculos e uma conferência visual), e documentação ou auditorias extras são relatadas como próximos passos em vez de serem iniciadas.
Regras que mantêm a biblioteca limpa
Cada variável recebe um escopo explícito (fundos, texto, bordas, espaçamentos, raios) em vez de aparecer em todos os seletores de propriedade, e a sintaxe de código para web usa a forma var() com o nome real da sua variável CSS. As cores semânticas são aliases das primitivas em vez de repetir valores brutos.
A limpeza só apaga nós pelos IDs exatos do registro, nunca adivinhando pelos nomes, então ela não remove as suas próprias camadas.
Perguntas sobre a skill figma-generate-library
Qual é a diferença entre a figma-generate-library e a figma-generate-design?
A figma-generate-library cria as partes reutilizáveis de um design system: variáveis, estilos, componentes e conjuntos de variantes. A figma-generate-design monta telas e páginas com essas partes. Se uma tarefa precisa das duas, a skill figma-use da Figma diz para carregar as duas.
Ela cria variáveis de modo claro e escuro?
Sim. O padrão de tokens dela é uma coleção Primitives com um modo, uma coleção Color com os modos Light e Dark como aliases das primitivas e coleções separadas de Spacing e Typography. Sistemas maiores podem usar mais modos, por exemplo variantes de marca ou de contraste.
Ela vai recriar componentes que a minha biblioteca já tem?
Não, ela pesquisa primeiro. Ela reutiliza um componente da biblioteca quando as propriedades, o modelo de tokens e os nomes servem; cria um wrapper em volta dele quando a aparência está certa, mas as propriedades não; e só recria quando a API ou o modelo de tokens é incompatível ou você não pode editar a biblioteca. Quando a escolha não é clara, ela pergunta a você.
Ela precisa da figma-use?
Sim. A skill diz que a figma-use precisa estar carregada em toda chamada use_figma: a figma-generate-library sabe o que criar e em que ordem, e a figma-use conhece as regras da Plugin API. Instalar o plugin da Figma traz as duas.
A skill figma-generate-library é grátis?
Os arquivos da skill são grátis para instalar, mas não são de código aberto: o repositório não tem arquivo de licença e valem os Developer Terms da Figma. Você precisa de uma conta no Figma; gravar fora dos seus rascunhos exige um assento Full, e a Figma diz que gravar no canvas é grátis durante o beta e depois será pago, cobrado por uso.
O que acontece se uma montagem longa for interrompida?
A skill grava um registro de estado com todos os IDs criados em um arquivo JSON e entrega um prompt de continuação com um ID de execução. Em um novo chat, ela relê esse arquivo e varre o arquivo do Figma pelos nomes para continuar de onde parou, sem duplicar o que já existe.
Mais skills de IA
Skills relacionadas
Skill UI/UX Pro Max
Comunidade · nextlevelbuilderBusque dados UI/UX locais sobre sistemas de design, paletas, tipografia, acessibilidade e tecnologias.Skill Figma Use (use_figma)
Oficial · FigmaA skill base por trás de toda gravação no Figma: as regras que um agente segue ao rodar scripts da Plugin API no seu arquivo pelo use_figma.Skill Figma Generate Design
Oficial · FigmaA skill da Figma para criar ou atualizar telas em um arquivo do Figma a partir do seu código, usando os componentes e variáveis do seu design system.Skill Theme Factory
Oficial · AnthropicDez temas prontos de cores e fontes para slides, documentos e páginas, mostrados em um PDF para você escolher, ou um tema novo sob medida.Skill Brand Guidelines
Oficial · AnthropicAplica as cores e fontes da marca Anthropic a slides e documentos. Rende mais como modelo para uma skill da sua própria marca.Design de miniaturas skill
Comunidade · Frank HeijdenrijkPlaneje miniaturas de vídeo honestas e legíveis no celular, com teste comparativo nativo.