Zum Inhalt springen

Figma-Use-Skill (use_figma)

Der Basis-Skill hinter jedem Schreibzugriff auf Figma: die Regeln, die ein Agent befolgt, wenn er über use_figma Plugin-API-Skripte in deiner Datei ausführt.

Offiziell · Figma
AutorFigma
LizenzNo licence file; Figma Developer Terms apply
Quellefigma/mcp-server-guide · SKILL.md auf GitHub
Projektwebsitedevelopers.figma.com/docs/figma-mcp-server
Funktioniert inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Aus der Quelle gelesen am

Der figma-use-Skill ist Figmas offizieller Grundlagen-Skill für das MCP-Tool use_figma, mit dem ein KI-Agent JavaScript gegen die Figma Plugin API in deiner Datei ausführen kann: Frames, Text, Auto Layout, Komponenten, Variablen und Stile erstellen und bearbeiten oder die Struktur einer Datei untersuchen. Figma kennzeichnet ihn als zwingende Voraussetzung: Der Agent lädt ihn vor jedem use_figma-Aufruf.

Er ist eher ein Regelwerk als ein Ablauf. Er listet die Fehler auf, an denen Canvas-Skripte scheitern (nicht geladene Schriften, Farben im Bereich 0–255, falsch gewechselte Seiten, vergessene Rückgabe der Node-IDs), und wie man sie vermeidet, und er verweist auf die Aufgaben-Skills, die auf ihm aufbauen: figma-generate-design für Screens, figma-generate-library für Designsystem-Elemente, figma-use-motion für Animation. Er braucht den Remote-Figma-MCP-Server und ein Figma-Konto.

Aus der SKILL.md des Skills: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.

Das ist ein offizieller Skill von Figma. Wie jeder Skill gibt er dem Agenten Anweisungen und kann Skripte enthalten, die dieser ausführt. Installiere ihn deshalb aus der hier verlinkten Quelle, nicht aus einer Kopie anderswo.

Was er macht

  1. Legt die Grundregeln für jedes use_figma-Skript fest: einfaches JavaScript mit Top-Level-await, Ergebnisse per return zurückgeben (console.log ist unsichtbar) und jede erstellte oder geänderte Node-ID zurückgeben, damit spätere Aufrufe sie finden.
  2. Verhindert die typischen Fehler: Schrift vor jeder Textänderung laden, Farben als Werte von 0–1, Füllungen und Konturen als neue Arrays zuweisen, die Größenregeln von Auto Layout erst setzen, nachdem ein Node seinem Parent hinzugefügt wurde, neue Frames auf oberster Ebene abseits des Ursprungs platzieren.
  3. Erklärt den Umgang mit Seiten (höchstens ein Seitenwechsel pro Skript, Arbeit über mehrere Seiten auf parallele Aufrufe verteilen) und die Unterschiede zwischen Figma-Design-, FigJam- und Slides-Dateien.
  4. Sagt dem Agenten, welchen Begleit-Skill er laden soll: figma-generate-design für jede sichtbare Designänderung, figma-generate-library für wiederverwendbare Komponenten und Tokens, den Skill für 3D-Transformationen für Perspektive und Neigung.
  5. Deckt Designsystem-Arbeit (Komponenten, Variablen, Text- und Effektstile) mit eigenen Referenzen ab und hält große Leseabfragen klein, indem zuerst IDs und Anzahlen zurückgegeben werden.
  6. Legt die Fehlerbehebung fest: ob ein fehlgeschlagenes Skript gefahrlos wiederholt werden kann oder ob der Agent zuerst die Arbeitsfläche lesen muss, um zu sehen, was sich geändert hat.

Was du bekommst

  • Für sich allein nichts: Er bestimmt, wie der Agent use_figma-Skripte schreibt. Das Ergebnis ist das, was die Aufgabe verlangt hat, erstellt oder bearbeitet in deiner Figma-Datei.

Wann er passt

  • Jede Agent-Aufgabe, die über den Figma-MCP-Server in eine Figma-Datei schreibt: Er wird vor use_figma automatisch geladen.
  • Programmatische Änderungen, die für Designer mühsam wären: Ebenen massenhaft umbenennen, Farben an Variablen binden, Auto Layout korrigieren, die Struktur einer Datei prüfen.
  • Du schreibst einen eigenen Figma-Skill und willst die Grundregeln, auf denen die offiziellen aufbauen.

Wann er nicht passt

  • Ganze Screens oder Designsystem-Bibliotheken bauen: Nimm figma-generate-design oder figma-generate-library, die figma-use selbst laden.
  • Ein Figma-Design in Code umsetzen: Dabei wird die Datei nur gelesen, und das ist die Aufgabe von figma-design-to-code.
  • Du nutzt nur den Desktop-MCP-Server von Figma: Er kann nicht auf die Arbeitsfläche schreiben, daher ist use_figma dort nicht verfügbar.

Was er braucht

  • Den Remote-Figma-MCP-Server (https://mcp.figma.com/mcp), verbunden und angemeldet; laut Figmas Dokumentation funktioniert das Schreiben auf die Arbeitsfläche nur mit dem Remote-Server.
  • Ein Figma-Konto mit Bearbeitungszugriff auf die Datei. Schreiben außerhalb deiner Entwürfe erfordert einen Full Seat; während der Beta ist das Schreiben kostenlos, und laut Figma wird es später nutzungsbasiert und kostenpflichtig.
  • Für sichtbare Designänderungen zusätzlich figma-generate-design (der Skill schreibt ihn zwingend vor) und figma-generate-library für Bibliothekselemente. Das Figma-Plugin installiert sie alle.

Dateien im Skill

Datei oder OrdnerWofür sie da ist
SKILL.md21 kritische Regeln, Seitenregeln, Editor-Modi, effiziente APIs (node.query, node.set, createAutoLayout, Inline-Screenshots), der schrittweise Ablauf, die Fehlerbehebung und eine Checkliste vor dem Start.
references/gotchas.mdJede bekannte Fehlerquelle mit falschem und richtigem Code, angefangen mit dem Rezept zum Laden von Schriften für Textänderungen.
references/common-patterns.mdFunktionierende Skriptgerüste: Formen, Text, Auto Layout, Variablen, Komponenten, mehrstufige Abläufe.
references/component-patterns.mdVariantensets, Komponenteneigenschaften, Instance Swap und das Finden vorhandener Komponenten.
references/variable-patterns.mdSammlungen, Modi, Scopes, Aliase und das Binden von Variablen.
references/working-with-design-systems/Neun kurze Anleitungen zum Verwenden und Erstellen von Komponenten, Variablen, Textstilen und Effektstilen.
references/plugin-api-standalone.d.tsDie vollständigen Typdefinitionen der Plugin API (etwa 400 KB), die nach genauen Signaturen durchsucht statt komplett gelesen werden.

Lizenz laut Repository am 2026-11-15: No licence file; Figma Developer Terms apply.

Beispiel-Prompts

Gib nach der Installation einen dieser Prompts ein; wenn du den Skill beim Namen nennst, wird er sicher verwendet.

  • Benenne in dieser Figma-Datei Ebenen, die noch Standardnamen wie „Frame 12“ haben, anhand ihres Inhalts aussagekräftig um und liste auf, was du geändert hast.
  • Binde alle fest codierten blauen Füllungen auf der Seite Pricing an unsere Variable color/brand/primary.
  • Liste die Seiten, Komponenten und Variablensammlungen in dieser Datei auf, damit wir ein Aufräumen planen können.
  • Stelle die Karten im Frame Features auf Auto Layout mit 16 px Abstand um und behalte ihr aktuelles Aussehen bei.

So installierst du figma-use

Mit dem Figma-Plugin installieren oder zusammen mit seinen Begleit-Skills

figma-use wird selten allein installiert. Figmas Plugin für Claude Code fügt den Remote-MCP-Server und alle Skills von Figma auf einmal hinzu; führe nach der Installation /mcp aus und melde dich bei Figma an.

Wenn du Ordner von Hand kopierst, kopieren die Befehle unten auch figma-generate-design und figma-generate-library, weil figma-use sichtbare Designarbeit und Bibliotheksarbeit an sie weitergibt.

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

Cursor, Gemini CLI und VS Code

Figmas Anleitung installiert dasselbe Plugin in Cursor (/add-plugin figma im Agent-Chat) und als Erweiterung für Gemini CLI (danach /mcp auth figma). In VS Code fügst du einen HTTP-MCP-Server mit derselben URL hinzu und nutzt den Agent-Modus von Copilot.

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

Nicht für Uploads auf claude.ai oder die Claude API

Der Skill ergibt nur mit dem Tool use_figma aus Figmas Remote-MCP-Server Sinn. Die Skills-Sandbox der Claude API hat keinen Netzwerkzugang, und eine Einrichtung auf claude.ai haben wir nicht geprüft.

Ein Skill ist ein Ordner mit einer SKILL.md-Datei. Du installierst ihn einmal; der Agent liest zu Beginn jeder Sitzung seine kurze Beschreibung und lädt die vollständigen Anweisungen nur, wenn eine Anfrage dazu passt. Wähle die Umgebung, die du nutzt:

Claude Code: aus dem Plugin-Marketplace

  1. Starte Claude Code in einem Terminal mit claude.
  2. Dieses Plugin ist im offiziellen Marketplace von Anthropic, den Claude Code beim ersten Start automatisch hinzufügt.
  3. Installiere das Plugin. Claude Code zeigt zuerst seine Details: Prüfe, was es hinzufügt (Skills, Hooks, MCP-Server), und wähle dann, ob es für dich, für alle in diesem Repository oder nur für dich in diesem Repository gilt.
    /plugin install figma@claude-plugins-official
  4. Tippe / und suche nach /figma:figma-use, oder bitte einfach um die Aufgabe.

Alternativ aus deiner Shell statt aus einer Sitzung:

claude plugin install figma@claude-plugins-official

Das Plugin wird als Ganzes installiert, daher kommen weitere Skills mit, darunter 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: den Ordner in deinen Skills-Ordner kopieren

Lege den Ordner des Skills in ~/.claude/skills/ ab, um ihn in jedem Projekt auf diesem Computer zu nutzen, oder in .claude/skills/ innerhalb eines Repositorys, um ihn mit allen zu teilen, die dort arbeiten (committe ihn).

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 erkennt neue oder geänderte Skills in diesen Ordnern noch während der Sitzung. Falls der Skills-Ordner beim Start der Sitzung noch nicht existierte, führe einmal /reload-skills aus. Tippe dann /figma-use oder beschreib einfach die Aufgabe.

Unter Windows führst du die Befehle in Git Bash oder WSL aus oder kopierst den Ordner mit dem Datei-Explorer an dieselbe Stelle.

Codex, Gemini CLI, Cursor und GitHub Copilot

Diese Agenten lesen dieselben SKILL.md-Ordner. Der einzige Projektordner, den alle vier akzeptieren, ist .agents/skills/; daher kopiert dieser Befehl den Skill dorthin:

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/
AgentProjektordnerDein BenutzerordnerHinweise
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tippe $ oder führe /skills aus, um einen Skill auszuwählen; Codex wählt auch selbst einen, wenn deine Aufgabe passt.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oder installiere ihn mit gemini skills install <git URL> --path <folder> --consent aus Git. Google hat Gemini CLI für Nutzer der kostenlosen Stufe und von Google One am 18. Juni 2026 durch Antigravity CLI ersetzt; Antigravity nutzt .agents/skills/ im Projekt und ~/.gemini/config/skills/ für dich.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tippe im Agent-Chat /, um einen Skill auszuwählen. Cursor liest auch die .claude/skills/-Ordner von Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funktioniert in Copilot CLI, im Cloud-Agenten und im Agent-Modus in VS Code, Visual Studio und JetBrains (IDE-Unterstützung hängt von der Version ab). Oder führe gh skill install OWNER/REPOSITORY SKILL aus (Public Preview, GitHub CLI 2.90.0 oder neuer).
Installiere nur Skills, denen du vertraust. Anthropic rät, Skills nur aus vertrauenswürdigen Quellen zu verwenden und bei allen anderen Skills vor der Nutzung jede Datei zu lesen: Ein Skill kann den Agenten anweisen, Befehle auszuführen, Dateien zu lesen oder Daten auf eine Weise zu senden, die seine Beschreibung nicht erwähnt.

Quellen für diese Schritte

Am 2026-11-14 mit der Dokumentation des jeweiligen Anbieters abgeglichen:

So sieht ein sicheres Canvas-Skript aus

Jedes Skript ist klein genug, um es zu wiederholen, wechselt zu Beginn einmal auf seine Seite, lädt die Schriften, die es verwendet, nimmt seine Änderungen vor und gibt die IDs zurück, die es erstellt oder geändert hat. Zusammengehörige Arbeit kann in einem Aufruf gebündelt werden, wenn eine Wiederholung unschädlich wäre; aufgeteilt wird an Seitengrenzen oder nach einem echten Fehler.

Geprüft wird anhand dessen, was das Skript zurückgibt (IDs, Anzahlen, Namen, Größen), plus normalerweise einem Screenshot nach dem Zusammensetzen und einem nach einer visuellen Korrektur, statt eines Screenshots nach jedem Schritt.

Große Dateien ohne riesige Antworten

Breite Leseabfragen geben nur IDs, Namen, Typen und Anzahlen zurück; Details werden in einem späteren Aufruf für ausgewählte IDs abgerufen, und jede Bestandsliste (Variablen, Stile, Komponenten, Seiten) wird separat zurückgegeben. Der Skill weist den Agenten an, die Größe einer Antwort zu messen, bevor er sie zurückgibt, statt sie stillschweigend abzuschneiden.

Fragen zu figma-use

Was ist use_figma?

use_figma ist das universelle Schreib-Tool des Figma-MCP-Servers. Der Agent schickt ein JavaScript-Snippet, Figma führt es gegen die Plugin API in deiner Datei aus und gibt zurück, was das Skript zurückgibt. Es funktioniert in Dateien von Figma Design, FigJam, Slides und Specs und nur auf dem Remote-Server.

Brauche ich figma-use, wenn ich schon figma-generate-design habe?

Ja. figma-generate-design und figma-generate-library setzen beide vor jedem Canvas-Skript figma-use voraus, weil figma-use die Regeln der Plugin API enthält, auf die sie sich stützen. Figmas Plugin installiert sie zusammen.

Warum nennt Figma ihn eine zwingende Voraussetzung?

Canvas-Skripte scheitern auf schwer nachvollziehbare Weise: Eine Textänderung wirft einen Fehler, wenn ihre Schrift nicht geladen ist, ein Farbwert von 255 liegt außerhalb des Bereichs, ein Seitenwechsel mit dem falschen Setter wirft einen Fehler, und ein Skript, das keine Node-IDs zurückgibt, lässt den nächsten Aufruf im Dunkeln. Der Skill gibt diese Regeln von Anfang an vor, damit der Agent sie nicht durch Ausprobieren lernen muss.

Kann er FigJam-Boards und Figma Slides bearbeiten?

use_figma funktioniert in allen drei Editoren, aber jeder erlaubt andere Node-Typen. figma-use deckt Figma Design und die Unterschiede ab; für FigJam und Slides bietet Figma die Skills figma-use-figjam und figma-use-slides.

Ist der figma-use-Skill kostenlos?

Die Dateien kannst du kostenlos installieren, sie sind aber nicht Open Source: Es gibt keine Lizenzdatei, und es gelten Figmas Developer Terms. Du brauchst ein Figma-Konto und einen Full Seat, um außerhalb deiner Entwürfe zu schreiben, und laut Figma ist das Schreiben auf die Arbeitsfläche während der Beta kostenlos und wird später eine nutzungsbasierte, kostenpflichtige Funktion.

Weitere KI-Skills

Ähnliche Skills

Skill-Kategorien