Maison

Skill

Outils MCP

figma-create-new-file

figma/mcp-server-guide

Prérequis obligatoire — vous DEVEZ invoquer cette compétence AVANT chaque appel à l’outil create_new_file. N’appellez JAMAIS create_new_file directement sans avoir d’abord chargé cette compétence. Déclenchez-la chaque fois que l’utilisateur souhaite un nouveau fichier Figma vierge — un nouveau design, un fichier FigJam ou Slides — ou lorsque vous avez besoin d’un fichier frais avant d’appeler use_figma. Utilisation — /figma-create-new-file [editorType] [fileName] (par ex. /figma-create-new-file figjam Mon Tableau Blanc, /figma-create-new-file slides Revue T3)

...Développer tout

Heure mise à jour 27 août 2026

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

À propos de figma-create-new-file

Enveloppe l'outil MCP create_new_file, qui crée un nouveau fichier Figma vierge dans le dossier brouillons de l'utilisateur pour un plan sélectionné. Il est présenté comme une condition préalable obligatoire qui doit être chargée avant chaque appel à create_new_file, car il encode l'arbre décisionnel de résolution du plan, le contrat de type d'éditeur et la remise en main post-création à utiliser avec use_figma. Il est généralement utilisé avant use_figma lorsqu'un fichier frais est nécessaire, par exemple pour un nouveau design, un fichier FigJam ou Slides.

L'habilité accepte des arguments facultatifs sous la forme editorType puis fileName, où editorType est design (par défaut), figjam ou slides, et fileName par défaut est Untitled. Le workflow résout d'abord un planKey : si l'utilisateur en a déjà fourni un, il est utilisé directement ; sinon, l'outil whoami est appelé et son tableau plans est inspecté, utilisant automatiquement la clé du plan unique ou demandant à l'utilisateur quelle équipe ou organisation utiliser lorsque plusieurs plans existent. Il appelle ensuite create_new_file avec les paramètres requis planKey, fileName et editorType, et utilise le file_key et l'file_url retournés, en passant file_key aux appels ultérieurs tels que use_figma.

Le comportement de type d'éditeur fait partie du contrat. Les types d'éditeur pris en charge sont design, figjam et slides, et chaque fichier est créé dans le dossier brouillons du plan sélectionné. Une mise en garde documentée s'applique aux fichiers Slides : un fichier Slides nouvellement créé commence avec zéro ligne et zéro diapositive, de sorte que figma.getSlideGrid() renvoie un tableau vide au lieu d'une première diapositive par défaut, et l'unique enfant de la page est le nœud SLIDE_GRID vide. Le premier appel à figma.createSlide() crée implicitement la ligne zéro et insère la diapositive à cet endroit, de sorte que les scripts use_figma ultérieurs qui supposent au moins une diapositive doivent gérer le cas vide ou appeler createSlide() en premier. Lorsque use_figma est l'étape suivante, l'habilité figma-use doit être chargée avant de l'appeler.

FAQ

Quels arguments cette habilité accepte-t-elle ?

editorType et fileName facultatifs. editorType est design (par défaut), figjam ou slides, et fileName par défaut est Untitled. Par exemple, /figma-create-new-file slides Q3 Review crée une présentation Slides nommée Q3 Review.

Comment le planKey est-il résolu ?

Si l'utilisateur a déjà fourni un planKey, il est utilisé directement. Sinon, l'outil whoami est appelé : la clé d'un plan unique est utilisée automatiquement, tandis que plusieurs plans invitent l'utilisateur à choisir dans quelle équipe ou organisation créer le fichier.

Où le nouveau fichier est-il créé ?

Dans le dossier brouillons de l'utilisateur pour le plan sélectionné. L'outil renvoie un file_key et un file_url qui ouvre le fichier directement dans Figma.

Qu'y a-t-il de spécial dans les fichiers Slides nouvellement créés ?

Un fichier Slides commence avec zéro ligne et zéro diapositive, de sorte que figma.getSlideGrid() renvoie un tableau vide au lieu d'une première diapositive par défaut. Le premier appel à figma.createSlide() crée implicitement la ligne zéro, il faut donc gérer le cas vide ou appeler createSlide() en premier.

Que dois-je faire après la création du fichier ?

Utilisez le file_key renvoyé pour les appels d'outils ultérieurs tels que use_figma. Si use_figma est l'étape suivante, chargez l'habilité figma-use avant de l'appeler.

Voir sur GitHub

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.