---
title: "Figma Skill: create_new_file"
aliases: [figma-create-new-file, figma-new-file]
tags: [figma, mcp, skill, claude-code]
sources: [raw/Skill create_new_file — Create a New Figma File.md]
created: 2026-05-15
updated: 2026-05-15
---

# Figma Skill: create\_new\_file

Creates a blank Figma file in the user's drafts folder. Used as a precursor to [[wiki/claude-code/figma-mcp-skills|figma-use]] when no target file exists yet.

## Invocation

```
/figma-create-new-file [editorType] [fileName]
```

| Argument | Default | Values |
|----------|---------|--------|
| `editorType` | `design` | `design`, `figjam` |
| `fileName` | `Untitled` | Any string |

**Examples:**
- `/figma-create-new-file` → design file "Untitled"
- `/figma-create-new-file figjam My Whiteboard`
- `/figma-create-new-file design My New Design`

## Workflow

### Step 1 — Resolve planKey

Required by `create_new_file`. Decision tree:

1. **planKey already known** (from prior `whoami` or user prompt) → use it directly
2. **No planKey** → call `whoami` tool
   - Single plan in response → use its `key` automatically
   - Multiple plans → ask user which team/org, then use corresponding `key`

### Step 2 — Call create\_new\_file

```json
{
  "planKey": "team:123456",
  "fileName": "My New Design",
  "editorType": "design"
}
```

| Parameter | Required |
|-----------|----------|
| `planKey` | Yes |
| `fileName` | Yes |
| `editorType` | Yes |

### Step 3 — Use the result

Response contains:
- `file_key` — use in subsequent [[wiki/claude-code/figma-mcp-skills|use_figma]] calls
- `file_url` — direct link to open file in Figma browser

## Key Takeaways

- File lands in the user's **drafts folder** for the selected plan
- Only `"design"` and `"figjam"` editor types are supported
- `planKey` must be resolved first — requires `whoami` if unknown
- After creation, load [[wiki/claude-code/figma-skill-build-screens|figma-use skill]] before calling `use_figma`
- Install the skill from [github.com/figma/mcp-server-guide](https://github.com/figma/mcp-server-guide)

## Related

- [[wiki/claude-code/figma-mcp-skills|figma-mcp-skills]] — all 8 Figma MCP skills overview
- [[wiki/claude-code/figma-mcp-guide|figma-mcp-guide]] — Figma MCP server overview
- [[wiki/claude-code/figma-skill-build-screens|figma-skill-build-screens]] — next step: building screens in the new file
- [[wiki/claude-code/figma-mcp-code-to-canvas|figma-mcp-code-to-canvas]] — alternative: code → canvas flow
