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

/figma-create-new-file

@49f948f official
by openaiopenai/skills29k stars
2,023
Run it yourself

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)

  • 7 files
  • 6.9 KB
  • Updated 8 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/openai/skills/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

≈83 tokens for metadata: the name and description. ≈593 when used: this file. ≈129 more on demand in 2 files.

Description uses 4.1% 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 ≈329 characters, or 4.1%.

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_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:

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:

  • 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.

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 third-party reports yet.

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

Last checked against GitHub last month.

Activeupdated 8 months ago

README badge

README badge for openai/skills/figma-create-new-file

Creates a new blank Figma file (design or FigJam) in the user's drafts folder, resolving the plan key via whoami if needed. Use this before calling use_figma or when the user wants to start a fresh design or whiteboarding session.

Generated from the current SKILL.md.

What editor types does this skill support?
The skill supports two editor types: design (the default) and figjam. You specify the type as the first argument, e.g. /figma-create-new-file figjam My Whiteboard.
Where does the new file get created?
The file is created in the user's drafts folder for the selected plan or team.
Do I need to provide a planKey myself?
No. If you don't have a planKey, the skill calls whoami to resolve it automatically. If the user has multiple plans, it will ask which team or organization to use.
What do I do after creating a file?
The tool returns a file_key and file_url. Use the file_key for subsequent tool calls like use_figma, which requires loading the figma-use skill first.

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