Heim

Skill

MCP-Tools

figma-create-new-file

figma/mcp-server-guide

Zwingende Voraussetzung — Sie MÜSSEN diese Funktion AUFRUFEN, BEVOR Sie jeden create_new_file-Tool-Aufruf tätigen. Rufen Sie create_new_file NIEMALS direkt auf, ohne diese Funktion zuvor zu laden. Auslösen, wann immer der Benutzer eine neue leere Figma-Datei wünscht — ein neues Design, FigJam oder Slides-Datei — oder wenn Sie eine frische Datei benötigen, bevor Sie use_figma aufrufen. Verwendung — /figma-create-new-file [editorType] [fileName] (z. B. /figma-create-new-file figjam Meine Whiteboard, /figma-create-new-file slides Q3-Bericht)

...Alle erweitern

Zeit aktualisiert 27. August 2026

# automation # mcp # file-management # design # MCP ToolsProductivity & Workflow # figma

Über figma-create-new-file

Umschließt das MCP-Tool create_new_file, das eine neue, leere Figma-Datei im Entwurfsordner des Benutzers für einen ausgewählten Plan erstellt. Es wird als zwingende Voraussetzung positioniert, die vor jedem Aufruf von create_new_file geladen werden muss, da sie den Plan-Auflösungs-Entscheidungsbaum, den Editor-Typ-Vertrag sowie die Übergabe nach der Erstellung an use_figma kodiert. Es wird typischerweise vor use_figma verwendet, wenn eine frische Datei erforderlich ist, beispielsweise für ein neues Design, eine FigJam- oder Slides-Datei.

Das Skill akzeptiert optionale Argumente in der Form editorType gefolgt von fileName, wobei editorType design (Standard), figjam oder slides sein kann und fileName standardmäßig auf „Untitled“ festgelegt ist. Der Workflow löst zunächst einen planKey auf: Wenn der Benutzer bereits einen bereitgestellt hat, wird er direkt verwendet; andernfalls wird das Tool whoami aufgerufen und dessen plans-Array überprüft, wobei automatisch der Schlüssel des einzelnen Plans verwendet oder der Benutzer gefragt wird, welches Team oder welche Organisation bei mehreren vorhandenen Plänen genutzt werden soll. Anschließend wird create_new_file mit den erforderlichen Parametern planKey, fileName und editorType aufgerufen, und die zurückgegebenen Werte file_key sowie file_url werden verwendet, wobei file_key an nachfolgende Aufrufe wie use_figma übergeben wird.

Das Verhalten des Editor-Typs ist Teil des Vertrags. Unterstützte Editor-Typen sind design, figjam und slides, und jede Datei wird im Entwurfsordner des ausgewählten Plans erstellt. Für Slides-Dateien gilt eine dokumentierte Einschränkung: Eine neu erstellte Slides-Datei beginnt mit null Zeilen und null Folien, sodass figma.getSlideGrid() ein leeres Array zurückgibt anstatt einer standardmäßigen ersten Folie, und das einzige untergeordnete Element der Seite der leere Knoten SLIDE_GRID ist. Der erste Aufruf von figma.createSlide() erstellt implizit Zeile null und fügt die Folie dort ein, daher sollten nachfolgende use_figma-Skripte, die mindestens eine Folie voraussetzen, den leeren Fall absichern oder zuerst createSlide() aufrufen. Wenn use_figma der nächste Schritt ist, sollte das figma-use-Skill geladen werden, bevor es aufgerufen wird.

Häufig gestellte Fragen (FAQ)

Welche Argumente akzeptiert dieses Skill?

Optionale editorType und fileName. editorType ist design (Standard), figjam oder slides, und fileName wird standardmäßig auf „Untitled“ festgelegt. Beispielsweise erstellt /figma-create-new-file slides Q3 Review eine Slides-Präsentation mit dem Namen „Q3 Review“.

Wie wird der `planKey` aufgelöst?

Wenn der Benutzer bereits einen planKey angegeben hat, wird er direkt verwendet. Andernfalls wird das Tool whoami aufgerufen: Der Schlüssel eines einzelnen Plans wird automatisch verwendet, während bei mehreren Plänen der Benutzer aufgefordert wird, auszuwählen, in welchem Team oder welcher Organisation die Datei erstellt werden soll.

Wo wird die neue Datei erstellt?

Im Entwurfsordner des Benutzers für den ausgewählten Plan. Das Tool gibt einen file_key und eine file_url zurück, die die Datei direkt in Figma öffnet.

Was ist an neu erstellten Slides-Dateien besonders?

Eine Slides-Datei beginnt mit null Zeilen und null Folien, sodass figma.getSlideGrid() ein leeres Array zurückgibt anstatt einer standardmäßigen ersten Folie. Der erste Aufruf von figma.createSlide() erstellt implizit Zeile null, daher sollte der leere Fall abgesichert oder createSlide() zuerst aufgerufen werden.

Was sollte ich nach der Erstellung der Datei tun?

Verwenden Sie den zurückgegebenen file_key für nachfolgende Tool-Aufrufe wie use_figma. Wenn use_figma der nächste Schritt ist, laden Sie das figma-use-Skill, bevor Sie es aufrufen.

Auf GitHub ansehen

MANDATORY: load this skill before every create_new_file tool call. It encodes the plan-resolution decision tree, the editor-type contract, and the post-creation handoff to use_figma.

Use the create_new_file MCP tool to create a new blank Figma file in the user's drafts folder. This is typically used before use_figma when you need a fresh file to work with.

Skill Arguments

This skill accepts optional arguments: /figma-create-new-file [editorType] [fileName]

editorType: design (default), figjam, or slides
fileName: Name for the new file (defaults to "Untitled")

Examples:

/figma-create-new-file — creates a design file named "Untitled"
/figma-create-new-file figjam My Whiteboard — creates a FigJam file named "My Whiteboard"
/figma-create-new-file design My New Design — creates a design file named "My New Design"
/figma-create-new-file slides Q3 Review — creates a Slides presentation named "Q3 Review"

Parse the arguments from the skill invocation. If editorType is not provided, default to "design". If fileName is not provided, default to "Untitled".

Workflow

Step 1: Resolve the planKey

The create_new_file tool requires a planKey parameter. Follow this decision tree:

User already provided a planKey (e.g. from a previous whoami call or in their prompt) → use it directly, skip to Step 2.
No planKey available → call the whoami tool. The response contains a plans array. Each plan has a key, name, seat, and tier.
- Single plan: use its key field automatically.
- Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's key.

Step 2: Call create_new_file

Call the create_new_file tool with:

Parameter	Required	Description
`planKey`	Yes	The plan key from Step 1
`fileName`	Yes	Name for the new file
`editorType`	Yes	`"design"`, `"figjam"`, or `"slides"`

Example:

{  "planKey": "team:123456",  "fileName": "My New Design",  "editorType": "design"}

Step 3: Use the result

The tool returns:

file_key — the key of the newly created file
file_url — a direct URL to open the file in Figma

Use the file_key for subsequent tool calls like use_figma.

Important Notes

The file is created in the user's drafts folder for the selected plan.
Supported editor types are "design", "figjam", and "slides".
If use_figma is your next step, load the figma-use skill before calling it.

Editor-specific notes

Slides — newly created files have an empty grid

A slides file produced by this tool starts with zero rows and zero slides — figma.getSlideGrid() returns [], not a default first slide. The page's only child is the SLIDE_GRID node itself, which is empty until you create content. The first call to figma.createSlide() implicitly creates row 0 and inserts the new slide there.

If your follow-up use_figma script assumes at least one slide exists (e.g. to read theme tokens off it), guard for the empty case or call createSlide() first. See figma-use-slides → slide-grid for full details.

Alle Dateien

1 Dateien

SKILL.md 3.9k

Ansehen