Loading the skills library…
Agent skills
Step 1: Resolve the
Figma Create New File
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.
npx skills add figma/mcp-server-guide --skill figma-create-new-fileInstalls from the source repository, including any supporting files.
Instructions
Downloads contain the instructions shown here. Use the install command for the complete skill.
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 planKey and editorType
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
keyasplanKey. - Multiple plans: show the available plans, ask the user to select one and then use that plan's
keyasplanKey.
Infer editorType from the requested file type by choosing from the tool's advertised input enum. If unclear, ask the user to specify the file type.
Step 2: Call create_new_file
Call the create_new_file tool with all three required arguments:
fileName: Required. Choose a concise name if the user does not provide one.planKey: Required. Use theplanKeyresolved in Step 1.editorType: Required. Use theeditorTypeselected in Step 1.projectId: Optional. Set it to create the file in a specific project.
{
"fileName": "Quarterly planning",
"planKey": "team::1234567890",
"editorType": "design"
}
- Use the
file_keyfrom thecreate_new_filetool response for subsequent tool calls likeuse_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.
View raw Markdown
# 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 `planKey` and `editorType`
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` as `planKey`.
- Multiple plans: show the available plans, ask the user to select one and then use that plan's `key` as `planKey`.
Infer `editorType` from the requested file type by choosing from the tool's advertised input enum. If unclear, ask the user to specify the file type.
## Step 2: Call create_new_file
Call the `create_new_file` tool with all three required arguments:
- `fileName`: Required. Choose a concise name if the user does not provide one.
- `planKey`: Required. Use the `planKey` resolved in Step 1.
- `editorType`: Required. Use the `editorType` selected in Step 1.
- `projectId`: Optional. Set it to create the file in a specific project.
```json
{
"fileName": "Quarterly planning",
"planKey": "team::1234567890",
"editorType": "design"
}
```
- 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.