Skill Figma Generate Library
La skill di Figma per costruire un design system in Figma partendo dal tuo codice: variabili, modalità chiara e scura, stili e componenti con varianti.
Ufficiale · Figma| Autore | Figma |
|---|---|
| Licenza | No licence file; Figma Developer Terms apply |
| Fonte | figma/mcp-server-guide · SKILL.md su GitHub |
| Sito del progetto | developers.figma.com/docs/figma-mcp-server |
| Funziona in | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Letta dalla fonte il |
La skill figma-generate-library è la skill ufficiale di Figma per agenti che crea o aggiorna un design system in Figma partendo dal tuo codice. Legge le variabili CSS, i file del tema e i componenti, poi crea le variabili Figma corrispondenti (con modalità chiara e scura), gli stili di testo e di effetto e i componenti con set di varianti ben strutturati, collegando ogni proprietà a una variabile invece che a un valore fisso.
Decide cosa costruire e in che ordine; la skill complementare figma-use decide come scrivere ogni script sul canvas, quindi le due vengono sempre caricate insieme. Lavora tramite il server MCP remoto di Figma e richiede un account Figma e un file che puoi modificare. Si adatta alla richiesta: un set di token, un componente, una libreria completa o un riallineamento di ciò che è cambiato tra codice e Figma.
Dallo SKILL.md della skill: Build professional-grade design-system assets in Figma that match code.
Cosa fa
- Sceglie un unico ambito prima di toccare il file (solo token, un singolo componente o una famiglia, una libreria completa o un riallineamento dal codice a Figma) e pubblica una breve checklist di cosa consegnerà e di come lo verificherà.
- Prima esplora: analizza il codice pertinente, esamina pagine, variabili e stili già presenti nel file, elenca le librerie che il file può usare e le consulta, e ti chiede cosa fare quando codice e Figma non concordano su un valore.
- Crea collezioni di variabili e modalità (per esempio Primitives più una collezione Color con Light e Dark), variabili semantiche come alias delle primitive, un ambito per ogni variabile e la sintassi di codice CSS var() che rimanda al tuo codice.
- Costruisce i componenti in ordine di dipendenza con set di varianti, proprietà dei componenti e collegamenti alle variabili, usa lo scambio di istanza per le icone invece di una variante per icona e divide qualsiasi matrice di varianti più grande di 30.
- Per una libreria completa, aggiunge le pagine di copertina, introduzione, fondamenti e componenti, poi le mappature Code Connect e una verifica finale di accessibilità, nomi e collegamenti.
- Tiene un registro di stato con ogni ID creato in un file JSON, così una costruzione lunga può riprendere in una nuova chat, e non esegue mai due script sul canvas contemporaneamente.
Cosa ottieni
- Variabili, modalità, stili di testo, stili di effetto, componenti e set di componenti nel tuo file Figma, più le pagine di documentazione quando l'ambito le prevede.
- Un file di stato sul tuo computer (/tmp/design-system-state-<run id>.json) con l'elenco di ciò che è stato creato, usato per riprendere la costruzione.
Quando usarla
- I tuoi design token e componenti sono nel codice e la libreria Figma manca, è incompleta o non è aggiornata.
- Ti serve un nuovo componente in Figma costruito come si deve, con varianti e collegamenti alle variabili invece che disegnato a mano.
- Stai configurando temi chiaro e scuro come modalità delle variabili Figma che corrispondano al tuo CSS.
- Codice e Figma si sono disallineati e vuoi aggiornare sul posto solo i token e i componenti cambiati.
Quando non usarla
- Vuoi una schermata o una pagina costruita con una libreria esistente: quello è il compito di figma-generate-design.
- Vuoi il codice da un design Figma: usa invece figma-design-to-code.
- Non hai codice né una fonte di token da cui partire e vuoi che venga inventato un brand: la skill costruisce ciò che il codice definisce e chiede invece di tirare a indovinare.
- Hai solo un seat View o Collab su un file condiviso: per scrivere fuori dalle tue bozze serve un seat Full.
Cosa richiede
- Un account Figma e un file che puoi modificare. La documentazione di Figma indica che per scrivere fuori dalle tue bozze serve un seat Full e che la scrittura sul canvas è gratuita durante la beta e in seguito diventerà una funzione a pagamento in base all'utilizzo.
- Il server MCP remoto di Figma (https://mcp.figma.com/mcp) collegato al tuo agente e con accesso effettuato a Figma.
- La skill figma-use di Figma, che questa skill richiede per ogni script sul canvas. Il plugin di Figma le installa entrambe.
- Il tuo codice (o un file di token) come fonte di riferimento. Gli strumenti di lettura rientrano nei limiti di utilizzo di Figma: fino a 20 chiamate al mese con il piano Starter o con un seat View o Collab; gli strumenti di scrittura ne sono esenti.
- Tempo, per una libreria completa: procede per fasi con punti di controllo, e la skill ti fornisce un prompt di continuazione per riprendere in una nuova chat.
File della skill
| File o cartella | A cosa serve |
|---|---|
SKILL.md | Il contratto sull'ambito, il flusso di lavoro per ogni ambito, 15 regole per il design system, il registro di stato, la matrice di riutilizzo delle librerie e quando chiederti conferma. |
references/discovery-phase.md | Come analizzare il codice e il file Figma prima di modificare qualsiasi cosa. |
references/token-creation.md | Collezioni, modalità, alias, ambiti e sintassi di codice, compreso uno schema più ampio per più brand. |
references/component-creation.md | Costruire componenti e set di varianti con proprietà e collegamenti. |
references/documentation-creation.md | Pagine di copertina, introduzione e fondamenti. |
references/code-connect-setup.md | Mappare i componenti Figma sui componenti del codice e impostare la sintassi di codice delle variabili. |
references/naming-conventions.md | Nomi per variabili, pagine, varianti e stili quando il file non ha ancora una convenzione. |
references/error-recovery.md | Cosa fare quando uno script fallisce e come ripulire in sicurezza il lavoro abbandonato. |
scripts/*.js | Otto script di supporto incorporati nelle chiamate sul canvas: esaminare il file, creare collezioni e token semantici, costruire set di varianti, collegare variabili, creare una pagina di documentazione, validare e rimuovere solo gli elementi orfani elencati. |
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.
- Usa figma-generate-library per creare variabili Figma da src/styles/tokens.css in questo file: <file URL>. Primitives più una collezione Color con le modalità Light e Dark.
- Costruisci in Figma il nostro componente Button partendo da components/Button.tsx, con le varianti Size, Variant e State collegate alle nostre variabili.
- Confronta il nostro tema Tailwind con le variabili di questa libreria Figma e aggiorna solo ciò che è cambiato.
- Crea un design system completo in un nuovo file Figma partendo da questo repository: fondamenti, Button, Input, Card, Badge e una pagina introduttiva.
Come installare figma-generate-library
Collega il server MCP di Figma e installa anche figma-use
In Claude Code la strada più rapida è il plugin di Figma dal marketplace ufficiale di Anthropic: aggiunge il server MCP e tutte le skill di Figma, tra cui figma-use, che serve a questa skill. Dopo l'installazione, esegui /mcp in Claude Code e accedi a Figma nel browser.
Funziona anche copiare la cartella a mano, purché accanto venga copiata anche figma-use (i comandi qui sotto fanno entrambe le cose) e il server MCP venga aggiunto con il secondo comando.
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpCursor, Gemini CLI e VS Code
La guida di Figma installa lo stesso plugin in Cursor con /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-guidePerché non c'è una strada per claude.ai o per l'API
Ogni passaggio chiama strumenti MCP di Figma attivi, come use_figma, get_libraries e search_design_system. La sandbox delle skill della Claude API non ha accesso alla rete e non abbiamo verificato una configurazione per claude.ai, quindi sono indicate solo le configurazioni per agenti.
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
- Avvia Claude Code in un terminale con
claude. - Questo plugin si trova nel marketplace ufficiale di Anthropic, che Claude Code aggiunge da solo al primo avvio.
- 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 - Digita / e cerca
/figma:figma-generate-library, oppure chiedi semplicemente di svolgere il compito.
Dalla shell invece che da una sessione:
claude plugin install figma@claude-plugins-officialIl 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-generative-plugins, figma-implement-motion, figma-shaders, figma-spec, figma-swiftui, figma-use, 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-generate-library ~/.claude/skills/
cp -R mcp-server-guide/skills/figma-use ~/.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-generate-library 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-generate-library .agents/skills/
cp -R mcp-server-guide/skills/figma-use .agents/skills/| Agente | Cartella del progetto | La tua cartella utente | Note |
|---|---|---|---|
| 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). |
Fonti per questi passaggi
Verificati sulla documentazione di ciascun fornitore il 2026-11-14:
Prima l'ambito, poi ci si ferma
La skill è scritta per evitare che il lavoro si allarghi oltre la richiesta. Una richiesta per un componente non diventa una libreria completa: crea solo i token mancanti che servono a quel componente, lo valida, mostra gli stati richiesti come istanze in un unico frame compatto e si ferma. Una richiesta di soli token non produce componenti.
Ogni ambito ha la sua definizione di lavoro finito (copertura delle varianti, ambiti e alias delle variabili, sintassi di codice, collegamenti e un controllo visivo), e documentazione o verifiche aggiuntive vengono segnalate come passi successivi invece di essere avviate.
Regole che tengono pulita la libreria
Ogni variabile riceve un ambito esplicito (sfondi, testo, bordi, spaziature, raggi) invece di comparire in ogni selettore di proprietà, e la sintassi di codice web usa la forma var() con il vero nome della tua variabile CSS. I colori semantici sono alias delle primitive invece di ripetere i valori grezzi.
La pulizia elimina i nodi solo tramite gli ID esatti presenti nel suo registro, mai indovinandoli dai nomi, quindi non rimuove i tuoi livelli.
Domande su figma-generate-library
Che differenza c'è tra figma-generate-library e figma-generate-design?
figma-generate-library costruisce le parti riutilizzabili di un design system: variabili, stili, componenti e set di varianti. figma-generate-design costruisce schermate e pagine con quelle parti. Se un compito richiede entrambe, la skill figma-use di Figma indica di caricarle tutte e due.
Può creare variabili per la modalità chiara e scura?
Sì. Il suo schema standard per i token è una collezione Primitives con una sola modalità, una collezione Color con le modalità Light e Dark come alias delle primitive, e collezioni separate Spacing e Typography. I sistemi più grandi possono usare più modalità, per esempio varianti per brand o per contrasto.
Ricostruirà componenti che la mia libreria ha già?
No, prima cerca. Riutilizza un componente della libreria quando proprietà, modello dei token e nomi sono adatti; lo incapsula quando l'aspetto è giusto ma le proprietà no; e lo ricostruisce solo quando l'API o il modello dei token sono incompatibili o non puoi modificare la libreria. Quando la scelta non è chiara, ti chiede.
Ha bisogno di figma-use?
Sì. La skill indica che figma-use deve essere caricata per ogni chiamata use_figma: figma-generate-library sa cosa costruire e in che ordine, figma-use conosce le regole della Plugin API. Installando il plugin di Figma le ottieni entrambe.
La skill figma-generate-library è gratuita?
I file della skill si installano gratis, ma non sono open source: il repository non ha un file di licenza e si applicano i Developer Terms di Figma. Serve un account Figma; per scrivere fuori dalle tue bozze serve un seat Full, e Figma dichiara che la scrittura sul canvas è gratuita durante la beta e in seguito diventerà a pagamento in base all'utilizzo.
Cosa succede se una costruzione lunga si interrompe?
La skill scrive in un file JSON un registro di stato con ogni ID creato e fornisce un prompt di continuazione con un ID di esecuzione. In una nuova chat rilegge quel file e analizza il file Figma per nome per riprendere da dove si era fermata, senza duplicare ciò che esiste già.
Altre skill IA
Skill correlate
Skill UI/UX Pro Max
Community · nextlevelbuilderCerca dati UI/UX locali su sistemi di design, palette, tipografia, accessibilità e tecnologie.Skill Figma Use (use_figma)
Ufficiale · FigmaLa 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.Skill Figma Generate Design
Ufficiale · FigmaLa skill di Figma per creare o aggiornare schermate in un file Figma partendo dal tuo codice, con i componenti e le variabili del tuo design system.Skill Theme Factory
Ufficiale · AnthropicDieci temi di colori e font già pronti per slide, documenti e pagine, mostrati in un PDF per sceglierne uno, oppure un nuovo tema su misura.Skill Brand Guidelines
Ufficiale · AnthropicApplica i colori e i font del brand di Anthropic a slide e documenti. Rende al meglio come modello per una skill del tuo brand.Design miniature skill
Community · Frank HeijdenrijkPianifica miniature video sincere e leggibili su mobile, con test comparativo nativo.