create_new_file — Créer un nouveau fichier Figma

OBLIGATOIRE : charger cette skill avant chaque appel à l'outil create_new_file. Elle encode l'arbre de décision de résolution du plan, le contrat de type d'éditeur, et le transfert post-création vers use_figma.

Utilisez l'outil MCP create_new_file pour créer un nouveau fichier Figma vierge dans le dossier des brouillons de l'utilisateur. Ceci est généralement utilisé avant use_figma quand vous avez besoin d'un fichier vierge pour travailler.

Arguments de la skill

Cette skill accepte des arguments optionnels : /figma-create-new-file [editorType] [fileName]

• editorType : design (par défaut), figjam, ou slides
• fileName : Nom du nouveau fichier (par défaut « Untitled »)

Exemples :

• /figma-create-new-file — crée un fichier design nommé « Untitled »
• /figma-create-new-file figjam My Whiteboard — crée un fichier FigJam nommé « My Whiteboard »
• /figma-create-new-file design My New Design — crée un fichier design nommé « My New Design »
• /figma-create-new-file slides Q3 Review — crée une présentation Slides nommée « Q3 Review »

Analysez les arguments depuis l'invocation de la skill. Si editorType n'est pas fourni, utilisez par défaut "design". Si fileName n'est pas fourni, utilisez par défaut "Untitled".

Workflow

Étape 1 : Résoudre la planKey

L'outil create_new_file requiert un paramètre planKey. Suivez cet arbre de décision :

1. L'utilisateur a déjà fourni une planKey (par exemple via un appel whoami précédent ou dans son prompt) → utilisez-la directement, passez à l'étape 2.

2. Aucune planKey disponible → appelez l'outil whoami. La réponse contient un tableau plans. Chaque plan possède une key, un name, un seat, et un tier.

   • Un seul plan : utilisez son champ key automatiquement.
   • Plusieurs plans : demandez à l'utilisateur dans quelle équipe ou organisation il veut créer le fichier, puis utilisez la key du plan correspondant.

Étape 2 : Appeler create_new_file

Appelez l'outil create_new_file avec :

Exemple :

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

Étape 3 : Utiliser le résultat

L'outil retourne :

• file_key — la clé du fichier nouvellement créé
• file_url — une URL directe pour ouvrir le fichier dans Figma

Utilisez la file_key pour les appels d'outils suivants comme use_figma.

Notes importantes

• Le fichier est créé dans le dossier des brouillons pour le plan sélectionné.
• Les types d'éditeur supportés sont "design", "figjam", et "slides".
• Si use_figma est votre prochaine étape, chargez la skill figma-use avant de l'appeler.

Notes spécifiques à l'éditeur

Slides — les fichiers nouvellement créés ont une grille vide

Un fichier slides produit par cet outil démarre avec zéro rangées et zéro slides — figma.getSlideGrid() retourne [], et non une première slide par défaut. Le seul enfant de la page est le nœud SLIDE_GRID lui-même, qui reste vide jusqu'à ce que vous créiez du contenu. Le premier appel à figma.createSlide() crée implicitement la rangée 0 et y insère la nouvelle slide.

Si votre script use_figma suivant suppose qu'au moins une slide existe (par exemple pour lire des tokens de thème dessus), protégez-vous pour le cas vide ou appelez createSlide() d'abord. Consultez figma-use-slides → slide-grid pour plus de détails.