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

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

docx

Official

Create, edit, read, and redline .docx and .dotx files from scripts and XML, with rendering checks.

by Anthropic197.6k stars

pdf

Official

Read, extract, merge, split, rotate, watermark, encrypt, and create PDF files with Python and command-line tools.

by Anthropic197.6k stars

chatgpt-apps

Official

Scaffold and refactor ChatGPT Apps SDK projects that pair an MCP server with a widget UI.

by OpenAI28.8k stars

Build or update full Figma screens using your published design system's components, variables, and styles instead of hardcoded values.

by OpenAI28.8k stars

More from OpenAI

Browse all skills

chatgpt-apps

Official

Scaffold and refactor ChatGPT Apps SDK projects that pair an MCP server with a widget UI.

by OpenAI28.8k stars

Build or update full Figma screens using your published design system's components, variables, and styles instead of hardcoded values.

by OpenAI28.8k stars

Turn a codebase into a structured Figma design system, phase by phase, with your approval at each checkpoint.

by OpenAI28.8k stars

figma-use

Official

Run JavaScript against the Figma Plugin API to create, edit, and inspect nodes in a Figma file.

by OpenAI28.8k stars

hatch-pet

Official

Turn a concept, brand cue, or reference image into a validated Codex pet spritesheet and pet.json package.

by OpenAI28.8k stars

imagegen

Official

Generate or edit raster images inside a coding session, from hero shots to transparent-background cutouts.

by OpenAI28.8k stars