Index of every page on this site: llms.txt
All skills
figma avatar

/figma-create-new-file

@43a06ff official
by figmafigma/mcp-server-guide2.2k stars
218
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/figma/mcp-server-guide/figma-create-new-file

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈47 tokens for metadata: the name and description. ≈398 when used: this file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈188 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.
{
  "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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill provides standard procedural instructions for an AI agent to create new Figma, FigJam, or Slides files using integrated tools. No security risks were detected.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 43a06ff. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago
disable-model-invocation
false

README badge

README badge for figma/mcp-server-guide/figma-create-new-file

This skill prepares an agent to create new Figma files (design, FigJam, or Slides) by resolving the team/plan context and encoding the `create_new_file` tool contract. It must be loaded before any `create_new_file` call and handles planKey resolution via `whoami` if needed, then returns the file key and URL for downstream tools like `use_figma`.

Generated from the current SKILL.md.

Do I need to load this skill before calling create_new_file?
Yes. This is mandatory. You must load this skill before every create_new_file tool call.
What editor types are supported?
Three types: design (default), figjam, and slides.
What happens if I don't provide a planKey?
The skill calls whoami to retrieve available plans. If there is one plan, it uses that automatically. If multiple plans exist, it asks you to choose which team or organization to create the file in.
Where is the new file created?
The file is created in the drafts folder for the selected plan.
What should I know about newly created Slides files?
New slides files start empty with zero slides. If your follow-up use_figma script expects at least one slide, call createSlide() first or guard for the empty case.

Generated from the current SKILL.md. These answers refresh after source changes.