Saltar al contenido

Skill Figma Use (use_figma)

La skill base detrás de cada escritura en Figma: las reglas que sigue un agente al ejecutar scripts de la Plugin API en tu archivo mediante use_figma.

Oficial · Figma
AutorFigma
LicenciaNo licence file; Figma Developer Terms apply
Fuentefigma/mcp-server-guide · SKILL.md en GitHub
Sitio del proyectodevelopers.figma.com/docs/figma-mcp-server
Funciona enClaude Code · Codex, Gemini CLI, Cursor, Copilot
Leída en la fuente el

La skill figma-use es la skill base oficial de Figma para su herramienta MCP use_figma, que permite a un agente de IA ejecutar JavaScript sobre la Plugin API de Figma dentro de tu archivo: crear y editar frames, texto, auto layout, componentes, variables y estilos, o revisar la estructura de un archivo. Figma la marca como requisito obligatorio: el agente la carga antes de cada llamada a use_figma.

Es un reglamento más que un flujo de trabajo. Enumera los errores que hacen fallar los scripts del lienzo (fuentes sin cargar, colores en el rango 0–255, cambiar de página de forma incorrecta, olvidar devolver los ID de los nodos) y cómo evitarlos, y remite a las skills de tarea que se apoyan en ella: figma-generate-design para pantallas, figma-generate-library para recursos del sistema de diseño y figma-use-motion para animación. Necesita el servidor MCP remoto de Figma y una cuenta de Figma.

Del SKILL.md de la skill: Use the `use_figma` tool to execute JavaScript in Figma files via the Plugin API.

Esta es una skill oficial de Figma. Como cualquier skill, da instrucciones al agente y puede incluir scripts que este ejecuta, así que instálala desde la fuente enlazada aquí, no desde una copia en otro sitio.

Qué hace

  1. Fija las reglas básicas de cada script de use_figma: JavaScript simple con await de nivel superior, resultados devueltos con return (console.log no se ve) y el ID de cada nodo creado o modificado devuelto para que las llamadas posteriores puedan encontrarlo.
  2. Evita los fallos habituales: cargar la fuente antes de editar cualquier texto, colores como valores de 0 a 1, rellenos y trazos reasignados como arrays nuevos, el tamaño de auto layout definido solo después de añadir el nodo a su padre, y los frames nuevos de nivel superior colocados lejos del origen.
  3. Explica cómo manejar las páginas (cambiar de página como máximo una vez por script y dividir el trabajo en varias páginas en llamadas paralelas) y las diferencias entre los archivos de Figma Design, FigJam y Slides.
  4. Indica al agente qué skill complementaria cargar: figma-generate-design para cualquier cambio visible de diseño, figma-generate-library para componentes y tokens reutilizables, y la skill de transformaciones 3D para perspectiva e inclinación.
  5. Cubre el trabajo con sistemas de diseño (componentes, variables, estilos de texto y de efectos) con referencias propias, y mantiene pequeñas las lecturas grandes devolviendo primero ID y recuentos.
  6. Define la recuperación de errores: si un script fallido se puede reintentar sin riesgo o si el agente debe leer antes el lienzo para ver qué ha cambiado.

Qué obtienes

  • Nada por sí sola: determina cómo escribe el agente los scripts de use_figma. El resultado es lo que pidiera la tarea, creado o editado en tu archivo de Figma.

Cuándo usarla

  • Cualquier tarea de un agente que escriba en un archivo de Figma a través del servidor MCP de Figma: se carga automáticamente antes de use_figma.
  • Ediciones programáticas que a un diseñador le resultarían tediosas: renombrar capas en bloque, vincular colores a variables, arreglar el auto layout, auditar la estructura de un archivo.
  • Estás escribiendo tu propia skill de Figma y quieres las reglas base en las que se apoyan las oficiales.

Cuándo no usarla

  • Construir pantallas completas o bibliotecas de sistemas de diseño: usa figma-generate-design o figma-generate-library, que ya cargan figma-use por su cuenta.
  • Convertir un diseño de Figma en código: eso solo lee el archivo y le corresponde a figma-design-to-code.
  • Solo usas el servidor MCP de escritorio de Figma: no puede escribir en el lienzo, así que use_figma no está disponible ahí.

Qué necesita

  • El servidor MCP remoto de Figma (https://mcp.figma.com/mcp) conectado y con la sesión iniciada; la documentación de Figma indica que escribir en el lienzo solo funciona con el servidor remoto.
  • Una cuenta de Figma con acceso de edición al archivo. Para escribir fuera de tus borradores necesitas un puesto Full; escribir es gratis durante la beta y Figma indica que más adelante será de pago según el uso.
  • Para cambios de diseño visibles, figma-generate-design junto a ella (la skill la hace obligatoria), y figma-generate-library para recursos de biblioteca. El plugin de Figma las instala todas.

Archivos de la skill

Archivo o carpetaPara qué sirve
SKILL.md21 reglas críticas, reglas de páginas, modos del editor, APIs eficientes (node.query, node.set, createAutoLayout, capturas en línea), el flujo de trabajo incremental, la recuperación de errores y una lista de comprobación previa.
references/gotchas.mdTodos los errores conocidos con código incorrecto y correcto, empezando por la receta para cargar fuentes antes de editar texto.
references/common-patterns.mdEstructuras de scripts que funcionan: formas, texto, auto layout, variables, componentes, flujos de varios pasos.
references/component-patterns.mdConjuntos de variantes, propiedades de componente, intercambio de instancias y cómo descubrir componentes existentes.
references/variable-patterns.mdColecciones, modos, ámbitos, alias y vinculación de variables.
references/working-with-design-systems/Nueve guías breves para usar y crear componentes, variables, estilos de texto y estilos de efectos.
references/plugin-api-standalone.d.tsLos tipos completos de la Plugin API (unos 400 KB), en los que se buscan firmas exactas en lugar de leerlos enteros.

Licencia según el repositorio el 2026-11-15: No licence file; Figma Developer Terms apply.

Prompts de ejemplo

Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.

  • En este archivo de Figma, cambia el nombre de las capas que aún tienen nombres por defecto como “Frame 12” por nombres descriptivos según su contenido, y enumera lo que has cambiado.
  • Vincula todos los rellenos azules con valor fijo de la página Pricing a nuestra variable color/brand/primary.
  • Enumera las páginas, los componentes y las colecciones de variables de este archivo para que podamos planificar una limpieza.
  • Convierte las tarjetas del frame Features a auto layout con espaciado de 16 px, manteniendo su aspecto actual.

Cómo instalar figma-use

Instálala con el plugin de Figma o junto con sus complementarias

figma-use rara vez se instala sola. El plugin de Figma para Claude Code añade de una vez el servidor MCP remoto y todas las skills de Figma; después de instalarlo, ejecuta /mcp e inicia sesión en Figma.

Si copias las carpetas a mano, los comandos de abajo copian también figma-generate-design y figma-generate-library, porque figma-use les pasa a ellas el trabajo de diseño visible y el de bibliotecas.

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

Cursor, Gemini CLI y VS Code

La guía de Figma instala el mismo plugin en Cursor (/add-plugin figma en el chat del agente) y como extensión de Gemini CLI (después, /mcp auth figma). En VS Code, añade un servidor MCP HTTP con la misma URL y usa el modo agente de Copilot.

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

No apta para subir a claude.ai ni para la Claude API

La skill solo tiene sentido con la herramienta use_figma del servidor MCP remoto de Figma. El sandbox de skills de la Claude API no tiene acceso a la red y no hemos verificado una configuración para claude.ai.

Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:

Claude Code: desde el marketplace de plugins

  1. Abre Claude Code en una terminal con claude.
  2. Este plugin está en el marketplace oficial de Anthropic, que Claude Code añade por ti la primera vez que lo abres.
  3. Instala el plugin. Claude Code muestra antes sus detalles: comprueba qué va a añadir (skills, hooks, servidores MCP) y elige si es para ti, para todos en este repositorio o solo para ti en este repositorio.
    /plugin install figma@claude-plugins-official
  4. Escribe / y busca /figma:figma-use, o simplemente pide la tarea.

Desde tu shell en lugar de una sesión:

claude plugin install figma@claude-plugins-official

El plugin se instala completo, así que vienen otras skills con él, entre ellas 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: copia la carpeta en tu carpeta de skills

Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz commit).

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 detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /figma-use o simplemente describe la tarea.

En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.

Codex, Gemini CLI, Cursor y GitHub Copilot

Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:

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/
AgenteCarpeta del proyectoTu carpeta de usuarioNotas
OpenAI Codex
.agents/skills/
~/.agents/skills/
Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior).
Instala solo skills de confianza. Anthropic aconseja usar solo skills de fuentes de confianza y leer todos los archivos de cualquier otra skill antes de usarla: una skill puede indicar al agente que ejecute comandos, lea archivos o envíe datos de formas que su descripción no menciona.

Fuentes de estos pasos

Comprobado con la documentación de cada proveedor el 2026-11-14:

Cómo es un script del lienzo seguro

Cada script es lo bastante pequeño como para reintentarlo: empieza cambiando una vez a su página, carga las fuentes que toca, hace sus cambios y devuelve los ID que ha creado o modificado. El trabajo relacionado se puede agrupar en una sola llamada cuando reintentarlo no haría daño; se divide en los límites de página o tras un fallo real.

Las comprobaciones se basan en los datos que devuelve el script (ID, recuentos, nombres, tamaños), y normalmente en una captura después de componer y otra después de un arreglo visual, en lugar de una captura tras cada paso.

Archivos grandes sin respuestas enormes

Las lecturas amplias devuelven solo ID, nombres, tipos y recuentos; los detalles de los ID elegidos se piden en una llamada posterior, y cada inventario (variables, estilos, componentes, páginas) se devuelve por separado. La skill indica al agente que mida el tamaño de una respuesta antes de devolverla, en lugar de recortarla sin avisar.

Preguntas sobre figma-use

¿Qué es use_figma?

use_figma es la herramienta de escritura de uso general del servidor MCP de Figma. El agente envía un fragmento de JavaScript, Figma lo ejecuta sobre la Plugin API en tu archivo y devuelve lo que devuelva el script. Funciona en archivos de Figma Design, FigJam, Slides y Specs, y solo en el servidor remoto.

¿Necesito figma-use si ya tengo figma-generate-design?

Sí. Tanto figma-generate-design como figma-generate-library exigen figma-use antes de cualquier script del lienzo, porque figma-use contiene las reglas de la Plugin API en las que se basan. El plugin de Figma las instala juntas.

¿Por qué Figma la llama requisito obligatorio?

Los scripts del lienzo fallan de formas difíciles de depurar: una edición de texto da error si su fuente no está cargada, un color de 255 está fuera de rango, un cambio de página con el setter equivocado da error, y un script que no devuelve los ID de los nodos deja a ciegas a la siguiente llamada. La skill da esas reglas por adelantado para que el agente no las aprenda a base de prueba y error.

¿Puede editar pizarras de FigJam y Figma Slides?

use_figma funciona en los tres editores, pero cada uno admite tipos de nodo distintos. figma-use cubre Figma Design y las diferencias; para FigJam y Slides, Figma ofrece las skills figma-use-figjam y figma-use-slides.

¿La skill figma-use es gratis?

Los archivos se pueden instalar gratis, pero no son de código abierto: no hay archivo de licencia y se aplican los Developer Terms de Figma. Necesitas una cuenta de Figma y un puesto Full para escribir fuera de tus borradores, y Figma indica que escribir en el lienzo es gratis durante la beta y que más adelante será una función de pago según el uso.

Más skills de IA

Skills relacionadas

Categorías de skills