use_figma — Skill API Figma Plugin pour FigJam

Ce skill contient un contexte spécifique à FigJam pour l'outil MCP use_figma. Le skill figma-use fournit un contexte fondamental pour l'exécution de plugin API via MCP ainsi que l'API complète du plugin Figma pour les cas d'usage plus avancés non décrits ici.

Incluez toujours figma-use-figjam dans le paramètre skillNames séparé par des virgules lors de l'appel de use_figma pour les opérations FigJam. Si ce skill a été chargé via une ressource MCP, vous DEVEZ préfixer le nom avec resource: (par exemple resource:figma-use-figjam). C'est un paramètre de journalisation utilisé pour suivre l'utilisation des skills — il n'affecte pas l'exécution.

L'URL FigJam est figma.com/board/.... N'appelez PAS figma.createPage() dans FigJam — cela lève TypeError: figma.createPage no such property 'createPage' on the figma global object. createPage() est une API de fichier Design uniquement (figma.com/design/...). Les fichiers FigJam ont une seule page implicite ; organisez le contenu avec des sections à la place (voir create-section).

Inspection des fichiers FigJam

get_figjam est l'outil d'inspection pour les fichiers FigJam. Il retourne l'arborescence complète des nœuds en XML, incluant les IDs des pages, sections, stickies, connecteurs et autres nœuds que vous devez référencer dans les appels use_figma suivants.

Utilisez get_figjam d'abord avant d'écrire du code use_figma qui doit référencer des nœuds existants (IDs de pages, IDs de sections, etc.). N'essayez pas de découvrir les IDs en exécutant un script d'inspection — la sortie console.log de use_figma n'est pas retournée à l'agent (voir figma-use Règle critique #4). Seule la valeur de return est retournée.
get_metadata NE FONCTIONNE PAS sur les fichiers FigJam — c'est mode design uniquement et échouera immédiatement avec « unsupported for FigJam files ».
get_screenshot nécessite un nodeId valide — passer un nodeId vide retourne une erreur « invalid nodeId ». Obtenez les IDs depuis get_figjam d'abord.
Si vous avez oublié de return un ID d'un appel use_figma précédent et en avez besoin maintenant, appelez get_figjam plutôt que de relancer un script d'inspection.

Chargement efficace de la documentation de référence

Chargez uniquement les références dont votre tâche a besoin — mais quand vous devez en charger plusieurs, émettez toutes les lectures dans un seul appel d'outil batch en parallèle, pas séquentiellement entre les tours. Pour une tâche typique de création de board, cela signifie un seul message contenant des lectures pour plan-board-content plus les 3-4 références de types de nœuds spécifiques que vous utiliserez.

Outils différés — Chargement en batch des schémas

Les outils MCP Figma (use_figma, get_figjam, get_screenshot, get_metadata, create_new_file, whoami) apparaissent souvent comme des outils différés qui nécessitent ToolSearch pour charger leurs schémas avant de pouvoir être appelés. Chargez tous les schémas dans un seul appel ToolSearch en utilisant la syntaxe select: au lieu d'un appel par outil :

ToolSearch query="select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file"

Six appels ToolSearch séquentiels, c'est six allers-retours avant que tout travail commence. Un appel batch, c'est un aller-retour.

Mutations de texte — Recette canonique

Chaque mutation de texte FigJam (sticky/forme/libellé/cellule de tableau/texte de connecteur, nœuds de texte autonomes) suit la même recette que les fichiers Design : charger la police → await → muter → retourner les IDs affectés. Sauter le chargement lève Cannot write to node with unloaded font "<family> <style>". Voir figma-use → gotchas.md → Canonical text-edit recipe. Note spécifique à FigJam : les valeurs par défaut des sous-couches varient (sticky → Inter Medium, forme → Inter Medium, connecteur → invalide jusqu'à configuration), chargez donc toujours depuis node.text.fontName plutôt que de coder en dur { family: 'Inter', style: 'Regular' }.

Ajout d'images à un board FigJam

upload_assets est la SEULE manière supportée d'ajouter des images à un fichier FigJam. N'utilisez PAS figma.createImage() ou figma.createImageAsync() depuis l'intérieur de use_figma — ils ne sont pas supportés comme points d'entrée pour l'upload d'images dans FigJam. Appelez upload_assets avec la fileKey FigJam ; l'outil retourne des URLs d'upload à usage unique auxquelles vous POSTez les octets d'image bruts, et l'image est validée et placée automatiquement. Passez nodeId (avec count: 1) pour attacher l'upload à un nœud FigJam existant comme remplissage ; omettez nodeId pour déposer l'image sur le board comme nouvelle couche.

Pour la forme complète de la requête/réponse, voir figma-use → api-reference.md → Images.

Documents de référence

plan-board-content - Lisez ceci pour toute demande de contenu de board — template de board, rétrospective, brainstorm, brise-glace, board de réunion, scaffold
- Couvre la planification du contenu généré du board, y compris le contour séquentiel, les sections, les intentions et le texte hiérarchique
- Délègue à d'autres références pour les détails API spécifiques
create-section — Créer et configurer les sections FigJam (dimensionnement, nommage, couleurs, visibilité du contenu, organisation des nœuds, mises en page en colonnes)
create-sticky — Créer et configurer les stickies FigJam (couleurs, dimensionnement, texte, visibilité de l'auteur, création en batch)
create-connector — Créer et configurer les connecteurs FigJam (extrémités, flèches, types de ligne, libellés, couleurs, câblage de diagramme)
create-text — Créer et configurer les nœuds de texte FigJam (chargement de police, polices et couleurs prédéfinies, dimensionnement, listes, opérations de carte heuristique)
position-figjam-nodes — Positionner, dimensionner et réorganiser les nœuds sur le canevas (y compris dans les sections)
create-shape-with-text — Créer et configurer les formes FigJam avec texte intégré (types de forme, présets de couleur, dimensionnement adapté au texte, mises en page de diagramme)
create-code-block — Créer et configurer les nœuds de bloc de code FigJam (langages, coloration syntaxique, positionnement, intégration dans les sections)
create-table — Créer et configurer les tableaux FigJam (lignes, colonnes, texte de cellule, présets de couleur, redimensionnement)
edit-text — Modifier les nœuds de texte existants (chargement de police, plages stylisées, recherche/remplacement, couleur par défaut FigJam Charcoal)
create-label — Créer et configurer les nœuds de libellé FigJam (petits marqueurs de légende numérotés/lettrés en cercle, séquences, positionnement)
batch-modify — Motifs pour modifier de nombreux nœuds existants à la fois (changements de style en masse, repositionnement, mises à jour de propriétés)
figjam-colors — Palettes de couleurs FigJam canoniques pour chaque type de nœud (sticky, section, connecteur, forme, libellé) plus la règle de notation hex/255 et l'assistant h()