Skill Figma Use (use_figma)
Le skill de base derrière chaque écriture dans Figma : les règles qu’un agent suit quand il exécute des scripts Plugin API dans votre fichier via use_figma.
Officiel · Figma| Auteur | Figma |
|---|---|
| Licence | No licence file; Figma Developer Terms apply |
| Source | figma/mcp-server-guide · SKILL.md sur GitHub |
| Site du projet | developers.figma.com/docs/figma-mcp-server |
| Fonctionne dans | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lu à la source le |
Le skill figma-use est le skill de base officiel de Figma pour son outil MCP use_figma, qui permet à un agent IA d’exécuter du JavaScript sur la Plugin API de Figma dans votre fichier : créer et modifier des cadres, du texte, de l’auto layout, des composants, des variables et des styles, ou inspecter la structure d’un fichier. Figma le désigne comme prérequis obligatoire : l’agent le charge avant chaque appel à use_figma.
C’est un recueil de règles plutôt qu’un déroulé. Il liste les erreurs qui font échouer les scripts de canevas (polices non chargées, couleurs sur l’échelle 0–255, mauvaise façon de changer de page, ID de nœuds non renvoyés) et comment les éviter, et il renvoie aux skills de tâche construits par-dessus : figma-generate-design pour les écrans, figma-generate-library pour les éléments de design system, figma-use-motion pour l’animation. Il nécessite le serveur MCP distant de Figma et un compte Figma.
Extrait du SKILL.md du skill : Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.
Ce qu’il fait
- Fixe les règles de base de chaque script use_figma : du JavaScript simple avec await au niveau supérieur, des résultats renvoyés avec return (console.log n’est pas visible), et l’ID de chaque nœud créé ou modifié renvoyé pour que les appels suivants le retrouvent.
- Évite les échecs courants : charger une police avant toute modification de texte, couleurs en valeurs de 0 à 1, remplissages et contours réaffectés sous forme de nouveaux tableaux, dimensionnement auto layout défini seulement après l’ajout du nœud à son parent, nouveaux cadres de premier niveau placés loin de l’origine.
- Explique la gestion des pages (changer de page au plus une fois par script, et répartir le travail sur plusieurs pages en appels parallèles) et les différences entre les fichiers Figma Design, FigJam et Slides.
- Indique à l’agent quel skill compagnon charger : figma-generate-design pour tout changement visible du design, figma-generate-library pour les composants et tokens réutilisables, le skill de transformations 3D pour la perspective et l’inclinaison.
- Couvre le travail de design system (composants, variables, styles de texte et d’effet) avec des références dédiées, et garde les lectures volumineuses légères en renvoyant d’abord des ID et des décomptes.
- Définit la reprise après erreur : déterminer si un script en échec peut être relancé sans risque, ou si l’agent doit d’abord lire le canevas pour voir ce qui a changé.
Ce que vous obtenez
- Rien en lui-même : il détermine la façon dont l’agent écrit les scripts use_figma. Le résultat est ce que la tâche demandait, créé ou modifié dans votre fichier Figma.
Quand l’utiliser
- Toute tâche d’agent qui écrit dans un fichier Figma via le serveur MCP de Figma : il est chargé automatiquement avant use_figma.
- Des modifications par programme qu’un designer trouverait fastidieuses : renommer des calques en masse, lier des couleurs à des variables, corriger l’auto layout, auditer la structure d’un fichier.
- Vous écrivez votre propre skill Figma et voulez les règles de base sur lesquelles reposent les skills officiels.
Quand ne pas l’utiliser
- Construire des écrans entiers ou des bibliothèques de design system : utilisez figma-generate-design ou figma-generate-library, qui chargent eux-mêmes figma-use.
- Transformer une maquette Figma en code : cela ne fait que lire le fichier, et c’est le rôle de figma-design-to-code.
- Vous n’utilisez que le serveur MCP de bureau de Figma : il ne peut pas écrire sur le canevas, donc use_figma n’y est pas disponible.
Ce qu’il faut
- Le serveur MCP distant de Figma (https://mcp.figma.com/mcp) connecté et authentifié ; la documentation de Figma indique que l’écriture sur le canevas ne fonctionne qu’avec le serveur distant.
- Un compte Figma avec accès en modification au fichier. Écrire en dehors de vos brouillons nécessite un siège Full ; l’écriture est gratuite pendant la bêta et Figma indique qu’elle deviendra ensuite payante à l’usage.
- Pour les changements de design visibles, figma-generate-design à côté (le skill le rend obligatoire), et figma-generate-library pour les éléments de bibliothèque. Le plugin Figma les installe tous.
Fichiers du skill
| Fichier ou dossier | À quoi il sert |
|---|---|
SKILL.md | 21 règles essentielles, les règles de pages, les modes d’éditeur, des API efficaces (node.query, node.set, createAutoLayout, captures d’écran intégrées), le déroulé incrémental, la reprise après erreur et une checklist avant exécution. |
references/gotchas.md | Chaque piège connu avec le code incorrect et le code correct, à commencer par la recette de chargement des polices pour les modifications de texte. |
references/common-patterns.md | Des squelettes de scripts fonctionnels : formes, texte, auto layout, variables, composants, déroulés en plusieurs étapes. |
references/component-patterns.md | Ensembles de variantes, propriétés de composant, échange d’instance (instance swap) et découverte des composants existants. |
references/variable-patterns.md | Collections, modes, portées, alias et liaison de variables. |
references/working-with-design-systems/ | Neuf courts guides pour utiliser et créer des composants, des variables, des styles de texte et des styles d’effet. |
references/plugin-api-standalone.d.ts | Les typages complets de la Plugin API (environ 400 Ko), où l’on cherche les signatures exactes plutôt que de tout lire. |
Licence trouvée dans le dépôt le 2026-11-15 : No licence file; Figma Developer Terms apply.
Exemples de prompts
Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.
- Dans ce fichier Figma, renomme les calques qui ont encore des noms par défaut comme « Frame 12 » avec des noms descriptifs selon leur contenu, et liste ce que tu as changé.
- Lie tous les remplissages bleus codés en dur de la page Pricing à notre variable color/brand/primary.
- Liste les pages, composants et collections de variables de ce fichier pour qu’on puisse planifier un nettoyage.
- Passe les cartes du cadre Features en auto layout avec des espacements de 16 px, en gardant leur aspect actuel.
Comment installer figma-use
L’installer avec le plugin Figma, ou avec ses compagnons
figma-use est rarement installé seul. Le plugin de Figma pour Claude Code ajoute en une fois le serveur MCP distant et tous les skills de Figma ; après l’installation, lancez /mcp et connectez-vous à Figma.
Si vous copiez les dossiers à la main, les commandes ci-dessous copient aussi figma-generate-design et figma-generate-library, car figma-use leur confie le travail de design visible et le travail de bibliothèque.
claude plugin install figma@claude-plugins-official
# or, by hand:
claude mcp add --transport http figma https://mcp.figma.com/mcpCursor, Gemini CLI et VS Code
Le guide de Figma installe le même plugin dans Cursor (/add-plugin figma dans le chat de l’agent) et comme extension dans Gemini CLI (puis /mcp auth figma). Dans VS Code, ajoutez un serveur MCP HTTP avec la même URL et utilisez le mode agent de Copilot.
/add-plugin figma
gemini extensions install https://github.com/figma/mcp-server-guidePas pour l’import sur claude.ai ni la Claude API
Le skill n’a de sens qu’avec l’outil use_figma du serveur MCP distant de Figma. Le bac à sable des skills de la Claude API n’a pas d’accès réseau et nous n’avons pas vérifié de configuration claude.ai.
Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :
Claude Code : depuis la marketplace de plugins
- Lancez Claude Code dans un terminal avec
claude. - Ce plugin se trouve dans la marketplace officielle d’Anthropic, que Claude Code ajoute pour vous au premier lancement.
- Installez le plugin. Claude Code affiche d’abord ses détails : vérifiez ce qu’il va ajouter (skills, hooks, serveurs MCP), puis choisissez s’il est pour vous, pour toutes les personnes de ce dépôt, ou pour vous seul dans ce dépôt.
/plugin install figma@claude-plugins-official - Tapez / et cherchez
/figma:figma-use, ou demandez simplement la tâche.
Depuis votre shell plutôt que dans une session :
claude plugin install figma@claude-plugins-officialLe plugin s’installe en bloc : d’autres skills sont donc installés avec lui, dont 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 : copier le dossier dans votre dossier de skills
Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).
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 détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /figma-use ou décrivez simplement la tâche.
Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.
Codex, Gemini CLI, Cursor et GitHub Copilot
Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le 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/| Agent | Dossier du projet | Votre dossier utilisateur | Remarques |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure). |
Sources de ces étapes
Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :
À quoi ressemble un script de canevas sûr
Chaque script est assez petit pour être relancé, commence par passer une seule fois sur sa page, charge les polices qu’il utilise, effectue ses modifications et renvoie les ID qu’il a créés ou modifiés. Des tâches liées peuvent être regroupées en un seul appel quand une relance serait sans conséquence ; le travail est découpé aux changements de page ou après un vrai échec.
Les vérifications reposent sur les éléments que le script renvoie (ID, décomptes, noms, tailles), plus normalement une capture d’écran après la composition et une après une correction visuelle, au lieu d’une capture après chaque étape.
De gros fichiers sans réponses énormes
Les lectures larges ne renvoient que des ID, noms, types et décomptes ; les détails sont récupérés pour les ID choisis dans un appel suivant, et chaque inventaire (variables, styles, composants, pages) est renvoyé séparément. Le skill demande à l’agent de mesurer la taille d’une réponse avant de la renvoyer plutôt que de la tronquer sans prévenir.
Questions sur figma-use
Qu’est-ce que use_figma ?
use_figma est l’outil d’écriture polyvalent du serveur MCP de Figma. L’agent envoie un extrait de JavaScript, Figma l’exécute sur la Plugin API dans votre fichier et renvoie ce que le script renvoie. Il fonctionne dans les fichiers Figma Design, FigJam, Slides et Specs, et seulement sur le serveur distant.
Ai-je besoin de figma-use si j’ai déjà figma-generate-design ?
Oui. figma-generate-design et figma-generate-library exigent tous deux figma-use avant tout script de canevas, car figma-use contient les règles de la Plugin API sur lesquelles ils s’appuient. Le plugin de Figma les installe ensemble.
Pourquoi Figma le présente-t-il comme un prérequis obligatoire ?
Les scripts de canevas échouent de façons difficiles à déboguer : une modification de texte lève une erreur si sa police n’est pas chargée, une couleur à 255 est hors limites, un changement de page avec le mauvais setter lève une erreur, et un script qui ne renvoie pas les ID de nœuds laisse l’appel suivant à l’aveugle. Le skill pose ces règles d’entrée pour que l’agent ne les apprenne pas par essais et erreurs.
Peut-il modifier des tableaux FigJam et des présentations Figma Slides ?
use_figma fonctionne dans les trois éditeurs, mais chacun autorise des types de nœuds différents. figma-use couvre Figma Design et ces différences ; pour FigJam et Slides, Figma propose les skills figma-use-figjam et figma-use-slides.
Le skill figma-use est-il gratuit ?
Les fichiers sont gratuits à installer, mais ils ne sont pas open source : il n’y a pas de fichier de licence et les Developer Terms de Figma s’appliquent. Il faut un compte Figma, un siège Full pour écrire en dehors de vos brouillons, et Figma indique que l’écriture sur le canevas est gratuite pendant la bêta et deviendra ensuite une fonctionnalité payante à l’usage.
Plus de skills IA
Skills similaires
Skill Figma Generate Design
Officiel · FigmaLe skill de Figma pour créer ou mettre à jour des écrans dans un fichier Figma à partir de votre code, avec les composants et variables de votre design system.Skill Figma Generate Library
Officiel · FigmaLe skill de Figma pour construire un design system dans Figma à partir de votre code : variables, modes clair et sombre, styles et composants avec variantes.Skill Figma Use Motion
Officiel · FigmaLe skill de Figma pour animer des calques dans un fichier Figma avec l’IA : keyframes, styles d’animation, easing, apparitions de texte et durée de la timeline.Skill Figma Design to Code
Officiel · FigmaLe skill de Figma pour transformer un cadre Figma en code dans votre projet, en réutilisant vos composants et assets au lieu de coller du balisage généré.Conception de miniatures skill
Communauté · Frank HeijdenrijkPréparez des miniatures vidéo fidèles et lisibles sur mobile, puis un test comparatif natif.Conception et modèles skill
Communauté · Frank HeijdenrijkDéfinissez un kit de marque réutilisable, une famille de modèles et un processus de production graphique récurrent.