Design & media

figma-create-new-file

Try it

Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam file, or when you need a new file before calling use_figma. Handles plan resolution via whoami if needed.

What it does

Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam file, or when you need a new file before calling use_figma. Handles plan resolution via whoami if needed. Usage — /figma-create-new-file [editorType] [fileName] (e.g. /figma-create-new-file figjam My Whiteboard)

The skill document

create_new_file — Create a New Figma File

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) or figjam
  • 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"

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:

  1. User already provided a planKey (e.g. from a previous whoami call or in their prompt) → use it directly, skip to Step 2.

  2. No planKey available → call the whoami tool. The response contains a plans array. Each plan has a key, name, seat, and tier.

    • Single plan: use its key field automatically.
    • Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's key.

Step 2: Call create_new_file

Call the create_new_file tool with:

ParameterRequiredDescription
planKeyYesThe plan key from Step 1
fileNameYesName for the new file
editorTypeYes"design" or "figjam"

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 file
  • file_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.
  • Only "design" and "figjam" editor types are supported.
  • If use_figma is your next step, load the figma-use skill before calling it.

Related skills

docx

Official

Create, read, edit, and validate Word documents (.docx) and templates (.dotx) with correct formatting and tracked changes.

by Anthropic197.1k stars

pdf

Official

Read, create, merge, split, encrypt, and extract content from PDF files using Python and CLI tools.

by Anthropic197.1k stars

chatgpt-apps

Official

Scaffolds ChatGPT Apps SDK projects with MCP servers and widget UIs grounded in current official documentation.

by OpenAI28.8k stars

Builds or updates full Figma screens using published design system components, variables, and styles instead of hardcoded primitives.

by OpenAI28.8k stars

Orchestrates multi-phase Figma design system builds from codebases with mandatory validation checkpoints.

by OpenAI28.8k stars

hatch-pet

Official

Generates Codex-compatible animated pet spritesheets and packaging from concepts, brand cues, or reference images.

by OpenAI28.8k stars

More from OpenAI

Browse all skills

chatgpt-apps

Official

Scaffolds ChatGPT Apps SDK projects with MCP servers and widget UIs grounded in current official documentation.

by OpenAI28.8k stars

Builds or updates full Figma screens using published design system components, variables, and styles instead of hardcoded primitives.

by OpenAI28.8k stars

Orchestrates multi-phase Figma design system builds from codebases with mandatory validation checkpoints.

by OpenAI28.8k stars

figma-use

Official

Enforces mandatory Figma Plugin API rules and incremental workflows for safe script execution.

by OpenAI28.8k stars

hatch-pet

Official

Generates Codex-compatible animated pet spritesheets and packaging from concepts, brand cues, or reference images.

by OpenAI28.8k stars

imagegen

Official

Generate or edit raster images for projects, including photos, mockups, sprites, and transparent cutouts.

by OpenAI28.8k stars