Дом
figma-create-new-file
figma/mcp-server-guide
ОБЯЗАТЕЛЬНОЕ предварительное условие — вы ДОЛЖНЫ вызвать этот навык ПЕРЕЗ каждым вызовом инструмента create_new_file. НИКОГДА не вызывайте create_new_file напрямую, не загрузив сначала этот навык. Активируйте его всякий раз, когда пользователь хочет создать новый пустой файл Figma — новый дизайн, FigJam или Slides-файл — или когда вам нужен свежий файл перед вызовом use_figma. Использование — /figma-create-new-file [editorType] [fileName] (например, /figma-create-new-file figjam Моя доска, /figma-create-new-file slides Обзор за Q3)
...Расширить всеО figma-create-new-file
Оборачивает инструмент MCP create_new_file, который создает новый пустой файл Figma в папке черновиков пользователя для выбранного плана. Он позиционируется как обязательное предварительное условие, которое должно быть загружено перед каждым вызовом create_new_file, поскольку он кодирует дерево принятия решений о выборе плана, контракт типа редактора и передачу после создания для использования use_figma. Обычно он используется перед use_figma, когда нужен свежий файл, например новый дизайн, FigJam или файл Slides.
Навык принимает необязательные аргументы в виде editorType, затем fileName, где editorType — это design (по умолчанию), figjam или slides, а fileName по умолчанию равен Untitled. Рабочий процесс сначала определяет planKey: если пользователь уже предоставил его, он используется напрямую; в противном случае вызывается инструмент whoami, и проверяется его массив plans, автоматически используется ключ единственного плана или запрашивается у пользователя, какую команду или организацию использовать, когда существует несколько планов. Затем он вызывает create_new_file с обязательными параметрами planKey, fileName и editorType, а также использует возвращенные file_key и file_url, передавая file_key в последующие вызовы, такие как use_figma.
Поведение типа редактора является частью контракта. Поддерживаемые типы редакторов — design, figjam и slides, и каждый файл создается в папке черновиков выбранного плана. К файлам Slides применяется задокументированное замечание: вновь созданный файл Slides начинается с нулевым количеством строк и нулевым количеством слайдов, поэтому figma.getSlideGrid() возвращает пустой массив вместо первого слайда по умолчанию, а единственным дочерним элементом страницы является пустой узел SLIDE_GRID. Первый вызов figma.createSlide() неявно создает строку ноль и вставляет слайд туда, поэтому последующие скрипты use_figma, которые предполагают наличие хотя бы одного слайда, должны проверять пустой случай или вызывать createSlide() сначала. Когда use_figma является следующим шагом, следует загрузить навык figma-use перед его вызовом.
Часто задаваемые вопросы
Какие аргументы принимает этот навык?
Необязательные editorType и fileName. editorType — это design (по умолчанию), figjam или slides, а fileName по умолчанию равен Untitled. Например, /figma-create-new-file slides Q3 Review создает презентацию Slides с именем Q3 Review.
Как определяется planKey?
Если пользователь уже предоставил planKey, он используется напрямую. В противном случае вызывается инструмент whoami: ключ единственного плана используется автоматически, а наличие нескольких планов побуждает пользователя выбрать, в какой команде или организации создать файл.
Где создается новый файл?
В папке черновиков пользователя для выбранного плана. Инструмент возвращает file_key и file_url, который открывает файл непосредственно в Figma.
Что особенного во вновь созданных файлах Slides?
Файл Slides начинается с нулевым количеством строк и нулевым количеством слайдов, поэтому figma.getSlideGrid() возвращает пустой массив вместо первого слайда по умолчанию. Первый вызов figma.createSlide() неявно создает строку ноль, поэтому следует проверять пустой случай или вызывать createSlide() сначала.
Что делать после создания файла?
Используйте возвращенный file_key для последующих вызовов инструментов, таких как use_figma. Если use_figma является следующим шагом, загрузите навык figma-use перед его вызовом.
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, orslides - 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
whoamicall or in their prompt) → use it directly, skip to Step 2.No planKey available → call the
whoamitool. The response contains aplansarray. Each plan has akey,name,seat, andtier.- Single plan: use its
keyfield automatically. - Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's
key.
- Single plan: use its
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 filefile_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_figmais your next step, load thefigma-useskill 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.
Установить figma-create-new-file
Скачайте и извлеките файлы навыков в директорию .claude/skills/.
Скачать ZIPКлонируйте репозиторий и скопируйте файлы навыка в свой проект.
git clone https://github.com/figma/mcp-server-guide/blob/main/skills/figma-create-new-file/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Копировать
