Most Figma Teams Don't Know You Can Teach the Design Agent Your Own Rules

Figma's Design Agent can now learn your team's conventions as reusable Skills—so it applies your spacing scales, naming rules, and component standards automatically instead of you re-explaining them every time.

July 8, 20267 min read Verified by AI · 3 sources checked
Works with:Figma

01. What It Is

Figma's Design Agent (currently in open beta) can be extended with custom Skills: Markdown files that package a repeatable workflow into reusable instructions the agent follows. Instead of typing out the same design standards in every prompt, you write them once, upload them, and invoke them with a slash command like /skill-name.

Skills follow the Agent Skills specification, so a single .md file can describe how your team names layers, which spacing scale to use, how to structure components, or which library to pull from. Once added, the agent applies that knowledge consistently across runs and projects—turning generic AI into team-aware AI.

Beyond design conventions, Skills can tap MCP connectors to pull live context from external tools like Notion, Slack, GitHub, Asana, Hex, and Atlassian. The same Skills also work across Figma Make and with MCP-connected coding tools such as Claude Code, Cursor, and Codex, so your conventions travel with you.

Why It Matters

Design consistency usually depends on people remembering the rules—or catching mistakes in review. Skills bake those rules into the agent itself, so spacing, naming, and component usage stay consistent without repeated prompting. Publish a Skill to your team or organization and everyone's agent behaves the same way, cutting review cycles and onboarding time. During the open beta the agent is free to use with no AI credits consumed.

Who Can Benefit

  • Design system teams who want conventions enforced automatically instead of policed manually
  • Design leads onboarding new members who need standards applied from day one
  • Product teams juggling multiple projects that must share a consistent visual language
  • Designers who bridge to code via MCP tools like Claude Code, Cursor, or Codex

02. Step-by-Step Guide

  1. 1

    Write your Skill as a Markdown file

    Create a .md file that describes one repeatable workflow—for example, your spacing scale, layer naming conventions, or how to build a card component. Keep it clear and instructional, as the agent reads it as guidance.

  2. 2

    Open a chat with the Design Agent

    In Figma Design, start a chat with the agent and click into the prompt box where you'd normally type your request.

  3. 3

    Add the skill

    Select Skills > Add skill, then either drag in your Skill file or click Upload a file and choose your Markdown (.md) file.

  4. 4

    Review the details

    Confirm the name, description, and content the agent parsed from the file so you know exactly what behavior it will follow.

  5. 5

    Invoke it with a slash command

    In any prompt, type /skill-name to trigger the Skill. The agent applies your packaged instructions and keeps results consistent across runs.

  6. 6

    Publish it team-wide

    Publish the Skill to your team or organization so everyone's agent uses the same conventions automatically.

Pro Tips

  • Keep each Skill focused on one workflow—modular Skills are easier to reuse and combine than one giant catch-all file.
  • Use MCP connectors inside Skills to pull live context from Notion, Slack, GitHub, Asana, Hex, or Atlassian instead of pasting it manually.
  • The same Skills work in Figma Make and with MCP-connected coding tools like Claude Code, Cursor, and Codex—write once, use across your stack.
  • Publish battle-tested Skills to the org so new team members inherit your standards on day one.

Warnings & Limitations

  • Custom Skills require a paid plan (Professional, Organization, or Enterprise). Full seat users can use them in Figma Design; View/Dev/Collab seats are limited to Draft files.
  • When uploaded to Figma Design, custom Skills do not support optional directories such as scripts/, references/, and assets/—this differs from the MCP server implementation.
  • The Figma agent is in open beta and free during beta with no AI credits consumed, but it will move to usage-based pricing after general availability.
  • Skills only accept Markdown (.md) files following the Agent Skills specification.
#figma#design-agent#skills#design-systems#ai-agents#workflow-automation
Share this trick:

Related Tricks