---
name: figma-create-new-file
description: "Always use this skill when the user wants to create a new Figma Design, FigJam, or Slides file. You MUST invoke this skill BEFORE every `create_new_file` tool call."
disable-model-invocation: false
title: figma-create-new-file
canonical_url: https://skilld.dev/gh/figma/mcp-server-guide/figma-create-new-file
last_updated: 2026-10-01T01:07:19.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> If the user asked to install this Skill, run `npx skilld install figma/mcp-server-guide/figma-create-new-file`. Install writes the Skill files into the project, so every session loads them.

# Create a new file in Figma

Steps to create a new Figma Design, FigJam, or Slides file using the `create_new_file` MCP tool.

## Step 1: Resolve the plan and product

Use the `planKey` the user provided or selected for this task. Otherwise, call `whoami` and inspect the returned plans.

- No plans: inform the user that file creation cannot proceed.
- One plan: use its `key`.
- Multiple plans: show the available plans, ask the user to select one and then use that plan's `key`.

Infer the product (Design, FigJam, or Slides) from the task. If unclear, ask the user to specify.

## Step 2: Call create_new_file

- Call the `create_new_file` tool with the `planKey` and product from Step 1.
  - Use a concise name for the new file if the user doesn't provide one.
- Use the `file_key` from the `create_new_file` tool response for subsequent tool calls like `use_figma`.

## Step 3: (Slides only) Handle the empty grid

A new Slides file contains no slides: `figma.getSlideGrid()` returns `[]`. Before reading properties such as theme tokens from a slide, call `figma.createSlide()` or handle the empty case. The first `createSlide()` call automatically creates row 0 and inserts the slide.