Agent Skill · OpenAI

figma-create-new-file

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)

View SKILL.md on GitHub → Source repository Provider profile
Provider: OpenAI Path in repo: skills/.curated/figma-create-new-file/SKILL.md

Skill body

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]

Examples:

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:

Parameter Required Description
planKey Yes The plan key from Step 1
fileName Yes Name for the new file
editorType Yes "design" or "figjam"

Example:

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

Step 3: Use the result

The tool returns:

Use the file_key for subsequent tool calls like use_figma.

Important Notes