Vai al contenuto

Skill Figma Use (use_figma)

La skill di base dietro ogni scrittura in Figma: le regole che un agente segue quando esegue script della Plugin API nel tuo file tramite use_figma.

Ufficiale · Figma
AutoreFigma
LicenzaNo licence file; Figma Developer Terms apply
Fontefigma/mcp-server-guide · SKILL.md su GitHub
Sito del progettodevelopers.figma.com/docs/figma-mcp-server
Funziona inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Letta dalla fonte il

La skill figma-use è la skill di base ufficiale di Figma per il suo strumento MCP use_figma, che permette a un agente IA di eseguire JavaScript sulla Figma Plugin API dentro il tuo file: creare e modificare frame, testo, auto layout, componenti, variabili e stili, oppure esaminare la struttura di un file. Figma la indica come prerequisito obbligatorio: l'agente la carica prima di ogni chiamata use_figma.

È un regolamento più che un flusso di lavoro. Elenca gli errori che fanno fallire gli script sul canvas (font non caricati, colori nell'intervallo 0–255, cambio di pagina fatto nel modo sbagliato, ID dei nodi non restituiti) e come evitarli, e rimanda alle skill operative che si basano su di essa: figma-generate-design per le schermate, figma-generate-library per gli elementi del design system, figma-use-motion per l'animazione. Richiede il server MCP remoto di Figma e un account Figma.

Dallo SKILL.md della skill: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.

Questa è una skill ufficiale di Figma. Come ogni skill, dà istruzioni all'agente e può includere script che esegue, quindi installala dalla fonte indicata qui, non da una copia trovata altrove.

Cosa fa

  1. Fissa le regole di base per ogni script use_figma: JavaScript semplice con await al livello superiore, risultati restituiti con return (console.log non è visibile) e ogni ID di nodo creato o modificato restituito, così le chiamate successive possono ritrovarlo.
  2. Previene gli errori più comuni: caricare un font prima di qualsiasi modifica al testo, colori come valori da 0 a 1, riempimenti e tratti riassegnati come nuovi array, dimensionamento dell'auto layout impostato solo dopo aver aggiunto il nodo al suo genitore, nuovi frame di primo livello posizionati lontano dall'origine.
  3. Spiega la gestione delle pagine (al massimo un cambio di pagina per script, e lavoro su più pagine diviso in chiamate parallele) e le differenze tra i file Figma Design, FigJam e Slides.
  4. Indica all'agente quale skill complementare caricare: figma-generate-design per qualsiasi modifica visibile al design, figma-generate-library per componenti e token riutilizzabili, la skill delle trasformazioni 3D per prospettiva e inclinazione.
  5. Copre il lavoro sul design system (componenti, variabili, stili di testo e di effetto) con riferimenti dedicati, e mantiene leggere le letture di grandi dimensioni restituendo prima ID e conteggi.
  6. Definisce il recupero dagli errori: se uno script fallito si può ripetere in sicurezza o se l'agente deve prima leggere il canvas per vedere cosa è cambiato.

Cosa ottieni

  • Niente di per sé: determina come l'agente scrive gli script use_figma. Il risultato è ciò che il compito richiedeva, creato o modificato nel tuo file Figma.

Quando usarla

  • Qualsiasi compito di un agente che scrive in un file Figma tramite il server MCP di Figma: viene caricata automaticamente prima di use_figma.
  • Modifiche programmatiche che un designer troverebbe noiose: rinominare livelli in blocco, collegare colori a variabili, correggere l'auto layout, verificare la struttura di un file.
  • Stai scrivendo una tua skill per Figma e vuoi le regole di base su cui si fondano quelle ufficiali.

Quando non usarla

  • Costruire schermate intere o librerie di design system: usa figma-generate-design o figma-generate-library, che caricano da sole figma-use.
  • Trasformare un design Figma in codice: questo legge soltanto il file ed è il compito di figma-design-to-code.
  • Usi solo il server MCP desktop di Figma: non può scrivere sul canvas, quindi lì use_figma non è disponibile.

Cosa richiede

  • Il server MCP remoto di Figma (https://mcp.figma.com/mcp) collegato e con accesso effettuato; la documentazione di Figma indica che la scrittura sul canvas funziona solo con il server remoto.
  • Un account Figma con accesso in modifica al file. Per scrivere fuori dalle tue bozze serve un seat Full; la scrittura è gratuita durante la beta e Figma dichiara che in seguito diventerà a pagamento in base all'utilizzo.
  • Per modifiche visibili al design, figma-generate-design accanto (la skill la rende obbligatoria), e figma-generate-library per gli elementi della libreria. Il plugin di Figma le installa tutte.

File della skill

File o cartellaA cosa serve
SKILL.md21 regole fondamentali, regole sulle pagine, modalità dell'editor, API efficienti (node.query, node.set, createAutoLayout, screenshot inline), il flusso di lavoro incrementale, il recupero dagli errori e una checklist preliminare.
references/gotchas.mdOgni insidia nota con codice sbagliato e codice corretto, a partire dalla procedura di caricamento dei font per le modifiche al testo.
references/common-patterns.mdStrutture di script funzionanti: forme, testo, auto layout, variabili, componenti, flussi in più passaggi.
references/component-patterns.mdSet di varianti, proprietà dei componenti, scambio di istanza e ricerca dei componenti esistenti.
references/variable-patterns.mdCollezioni, modalità, ambiti, alias e collegamento delle variabili.
references/working-with-design-systems/Nove brevi guide per usare e creare componenti, variabili, stili di testo e stili di effetto.
references/plugin-api-standalone.d.tsLe definizioni di tipo complete della Plugin API (circa 400 KB), in cui cercare le firme esatte invece di leggerle per intero.

Licenza trovata nel repository il 2026-11-15: No licence file; Figma Developer Terms apply.

Prompt di esempio

Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.

  • In questo file Figma, rinomina i livelli che hanno ancora nomi predefiniti come "Frame 12" con nomi descrittivi basati sul contenuto, ed elenca cosa hai cambiato.
  • Collega tutti i riempimenti blu scritti a mano nella pagina Pricing alla nostra variabile color/brand/primary.
  • Elenca le pagine, i componenti e le collezioni di variabili di questo file, così possiamo pianificare una pulizia.
  • Converti le schede nel frame Features in auto layout con spaziature di 16 px, mantenendo il loro aspetto attuale.

Come installare figma-use

Installala con il plugin di Figma, o insieme alle skill complementari

figma-use si installa raramente da sola. Il plugin di Figma per Claude Code aggiunge in un colpo solo il server MCP remoto e tutte le skill di Figma; dopo l'installazione, esegui /mcp e accedi a Figma.

Se copi le cartelle a mano, i comandi qui sotto copiano anche figma-generate-design e figma-generate-library, perché figma-use affida a loro il lavoro di design visibile e quello sulla libreria.

claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcp

Cursor, Gemini CLI e VS Code

La guida di Figma installa lo stesso plugin in Cursor (/add-plugin figma nella chat dell'agente) e come estensione di Gemini CLI (poi /mcp auth figma). In VS Code, aggiungi un server MCP HTTP con lo stesso URL e usa la modalità agente di Copilot.

/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guide

Non per i caricamenti su claude.ai né per la Claude API

La skill ha senso solo con lo strumento use_figma del server MCP remoto di Figma. La sandbox delle skill della Claude API non ha accesso alla rete e non abbiamo verificato una configurazione per claude.ai.

Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:

Claude Code: dal marketplace dei plugin

  1. Avvia Claude Code in un terminale con claude.
  2. Questo plugin si trova nel marketplace ufficiale di Anthropic, che Claude Code aggiunge da solo al primo avvio.
  3. Installa il plugin. Claude Code ne mostra prima i dettagli: controlla cosa aggiungerà (skill, hook, server MCP), poi scegli se è per te, per tutti su questo repository o solo per te in questo repository.
    /plugin install figma@claude-plugins-official
  4. Digita / e cerca /figma:figma-use, oppure chiedi semplicemente di svolgere il compito.

Dalla shell invece che da una sessione:

claude plugin install figma@claude-plugins-official

Il plugin si installa per intero, quindi arrivano anche altre skill, tra cui figma-3d-transforms, figma-code-connect, figma-code-workflows, figma-create-new-file, figma-design-to-code, figma-generate-design, figma-generate-diagram, figma-generate-library, figma-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use-figjam, figma-use-motion, figma-use-slides.

Claude Code: copia la cartella nella tua cartella delle skill

Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).

git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p ~/.claude/skills
cp -R mcp-server-guide/skills/figma-use ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-design ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-generate-library ~/.claude/skills/

Claude Code rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /figma-use o descrivi semplicemente il compito.

Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.

Codex, Gemini CLI, Cursor e GitHub Copilot

Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la skill:

git clone --depth 1 https://github.com/figma/mcp-server-guide.git
mkdir -p .agents/skills
cp -R mcp-server-guide/skills/figma-use .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-design .agents/skills/
cp -R mcp-server-guide/skills/figma-generate-library .agents/skills/
AgenteCartella del progettoLa tua cartella utenteNote
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

Fonti per questi passaggi

Verificati sulla documentazione di ciascun fornitore il 2026-11-14:

Com'è fatto uno script sicuro sul canvas

Ogni script è abbastanza piccolo da poter essere ripetuto, inizia passando una sola volta alla sua pagina, carica i font che usa, apporta le modifiche e restituisce gli ID che ha creato o modificato. Il lavoro correlato si può raggruppare in un'unica chiamata quando ripeterla non farebbe danni; il lavoro si divide ai confini tra pagine o dopo un errore reale.

I controlli si basano sui dati che lo script restituisce (ID, conteggi, nomi, dimensioni), più di norma uno screenshot dopo la composizione e uno dopo una correzione visiva, invece di uno screenshot a ogni passaggio.

File grandi senza risposte enormi

Le letture ampie restituiscono solo ID, nomi, tipi e conteggi; i dettagli vengono recuperati per gli ID scelti in una chiamata successiva, e ogni inventario (variabili, stili, componenti, pagine) viene restituito separatamente. La skill dice all'agente di misurare la dimensione di una risposta prima di restituirla invece di troncarla senza avvisare.

Domande su figma-use

Che cos'è use_figma?

use_figma è lo strumento di scrittura generico del server MCP di Figma. L'agente invia un frammento di JavaScript, Figma lo esegue sulla Plugin API nel tuo file e restituisce ciò che lo script restituisce. Funziona nei file Figma Design, FigJam, Slides e Specs, e solo sul server remoto.

Mi serve figma-use se ho già figma-generate-design?

Sì. figma-generate-design e figma-generate-library richiedono entrambe figma-use prima di qualsiasi script sul canvas, perché figma-use contiene le regole della Plugin API su cui si basano. Il plugin di Figma le installa insieme.

Perché Figma la definisce un prerequisito obbligatorio?

Gli script sul canvas falliscono in modi difficili da diagnosticare: una modifica al testo genera un errore se il font non è caricato, un colore pari a 255 è fuori intervallo, un cambio di pagina con il setter sbagliato genera un errore, e uno script che non restituisce gli ID dei nodi lascia al buio la chiamata successiva. La skill fornisce subito queste regole, così l'agente non deve impararle per tentativi.

Può modificare lavagne FigJam e Figma Slides?

use_figma funziona in tutti e tre gli editor, ma ognuno consente tipi di nodo diversi. figma-use copre Figma Design e le differenze; per FigJam e Slides, Figma fornisce le skill figma-use-figjam e figma-use-slides.

La skill figma-use è gratuita?

I file si installano gratis ma non sono open source: non c'è un file di licenza e si applicano i Developer Terms di Figma. Servono un account Figma e un seat Full per scrivere fuori dalle tue bozze, e Figma dichiara che la scrittura sul canvas è gratuita durante la beta e in seguito diventerà una funzione a pagamento in base all'utilizzo.

Altre skill IA

Skill correlate

Categorie di skill