Guia de leitura localizado
figma-useFinalidade, utilização e fonte
Pré-requisito OBRIGATÓRIO — você DEVE invocar esta habilidade ANTES de cadause_figmachamada de ferramenta. NUNCA ligueuse_figmadiretamente, sem carregar essa habilidade primeiro. Ignorá-la causa falhas comuns e difíceis de depurar. Acione sempre que o usuário quiser executar uma ação de gravação ou uma ação de leitura específica que exija a execução de JavaScript no contexto do arquivo Figma — por exemplocreate/edit/deletenós, configurar variáveis ou tokens, construir componentes e variantes, modificar o layout automático ou preenchimentos, vincular variáveis a propriedades ou inspecionar a estrutura do arquivo programaticamente.
Fonte recuperada:
- Repositório de origem
- openai/skills
- SKILL.md
skills/.curated/figma-use/SKILL.md- Estrelas do repositório
- 28,420
- Atualização do repositório
- 2026-10-29
- Classificação de Habilidades
- Desenvolvimento
- Última coleta
Licença: Não especificado
Os trechos do fluxo de trabalho são auxiliares de leitura e não instruções executáveis do Codez. Nenhuma Skill de terceiros foi executada para gerar esta página.
Os trechos abaixo, que descrevem o propósito e o fluxo de trabalho, são material original, organizado e traduzido para facilitar a leitura. Eles são distintos da análise editorial da Codez, que possui uma etiqueta separada.
O que esta habilidade faz
Pré-requisito OBRIGATÓRIO — você DEVE invocar esta habilidade ANTES de cadause_figmachamada de ferramenta. NUNCA ligueuse_figmadiretamente, sem carregar essa habilidade primeiro. Ignorá-la causa falhas comuns e difíceis de depurar. Acione sempre que o usuário quiser executar uma ação de gravação ou uma ação de leitura específica que exija a execução de JavaScript no contexto do arquivo Figma — por exemplocreate/edit/deletenós, configurar variáveis ou tokens, construir componentes e variantes, modificar o layout automático ou preenchimentos, vincular variáveis a propriedades ou inspecionar a estrutura do arquivo programaticamente.
Como funciona o fluxo de trabalho upstream
5Fluxo de trabalho incremental (como evitar bugs)
A causa mais comum de erros é tentar fazer muita coisa em uma única operação.use_figmaLigue. Trabalhe em pequenos passos e valide após cada um.
use_figma — Habilidade da API do Plugin Figma
Usaruse_figmaMCP para executar JavaScript em arquivos do Figma através da API de Plugins. Toda a documentação de referência detalhada está disponível emreferences/Sempre passeskillNames: "figma-use"ao ligaruse_figmaEste é um parâmetro de registro usado para rastrear o uso da habilidade — ele não afeta a execução.
1Regras Críticas
Usarreturnpara enviar dados de volta. O valor de retorno é serializado automaticamente em JSON (objetos, arrays, strings, números). NÃO chamefigma.closePlugin()Ou então, envolva o código em uma IIFE assíncrona — isso é tratado automaticamente. Escreva JavaScript puro com nível superior.awaitereturnO código é automaticamente encapsulado em um contexto assíncrono. NÃO o encapsule em(async () => { ... })().
// Switch to a specific page (loads its content)
const targetPage = figma.root.children.find((p) => p.name === "My Page");
await figma.setCurrentPageAsync(targetPage);
// targetPage.children is now populated
// Iterate over all pages
for (const page of figma.root.children) {
await figma.setCurrentPageAsync(page);
// page.children is now loaded — read or modify them here
}Requisitos e configuração
Nenhuma passagem de requisitos resumida foi selecionada deste arquivo. Isso não significa que a Skill não tenha dependências. Verifique as instruções de configuração do repositório e os arquivos referenciados.
Limites e verificações de qualidade
Nenhuma passagem de limites separada foi selecionada deste arquivo. Isso não significa que a Skill seja segura para todas as entradas ou ambientes. Analise o código-fonte completo e valide seus próprios resultados.
Comece com um teste seguro.
- Verifique o host compatível e as instruções de instalação do repositório. Mantenha o diretório Skill e seus scripts, recursos e documentação referenciados juntos;SKILL.mdsozinho pode omitir dependências.
- Forneça ao agente suas entradas reais, a saída desejada e os critérios de aceitação. A sintaxe de invocação e as ferramentas disponíveis dependem do host; este site não pressupõe um comando de instalação universal.
- Teste o fluxo de trabalho original em um projeto descartável ou em uma cópia. Analise as operações que alteram arquivos, serviços remotos ou recursos faturáveis antes de permiti-las.
- Valide o resultado comparando-o com as verificações de qualidade da fonte e com seus próprios requisitos. Um gatilho bem-sucedido ou uma alta contagem de estrelas no repositório não garantem um resultado correto.
Leia mais na fonte.
- use_figma — Habilidade da API do Plugin Figma
- 1Regras Críticas
- 2Regras da página (críticas)
- Mudando de página
- Execuções de script em toda a extensão
- 3.
returnSeu canal de saída é - 4Modo de edição
- 5Fluxo de trabalho incremental (como evitar bugs)
- O padrão
- 6Recuperação de erros e autocorreção
- Quando
use_figmaretorna um erro - Quando o script é executado com sucesso, mas o resultado parece incorreto.
- 7Lista de verificação pré-voo
- 8Descubra as convenções antes de criar.
- Roteiros de inspeção rápida
- 9Documentos de referência
- 10Exemplos de trechos de código
Habilidades relacionadas
Tradução e escopo
Este guia de leitura seleciona trechos do texto fixado a montante.SKILL.mdA tradução foi feita com auxílio de ferramentas. Este não é um manual completo nem garante compatibilidade comprovada. Leia o original e os arquivos referenciados antes de usar.
Esta introdução refere-se à versão fixada abaixo; a atividade atual do repositório e o tempo de coleta são mostrados separadamente.
- Fonte fixada
- Leia o original ↗
- Fonte recuperada
- Commit de origem
49f948faa9258a0c61caceaf225e179651397431- Fonte SHA-256
afa9c4ae068a18b93e4914b2d224180ace113db7713dd66f4df397f16ba9c4b4