Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 62 additions & 0 deletions skills/figma/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Figma MCP

Access Figma designs using the Figma MCP server. Read design files, extract components, get design tokens, and inspect layer properties.

## Triggers

This skill is activated by the following keywords:

- `figma`
- `figma design`
- `figma mcp`

## Details

The Figma MCP server provides tools to interact with Figma designs directly from OpenHands. It uses OAuth authentication to securely access your Figma account.

## Installation

To install the Figma MCP server, run the following command in your terminal:

```bash
openhands mcp add figma --transport http --auth oauth https://figma.com/mcp/sse

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 Critical: See comment on SKILL.md line 19 - these two installation commands are different and one will be wrong. The URL and authentication flags must match between both files.

```

This will:
1. Add the Figma MCP server to your OpenHands configuration
2. Configure OAuth authentication (you'll be prompted to authorize when first used)
3. Enable the server immediately

After installation, restart your OpenHands session to apply the changes.

## Verification

To verify the installation:

```bash
openhands mcp list
```

You should see the Figma server listed with status "enabled".

## Managing the Server

```bash
# Disable the Figma MCP server
openhands mcp disable figma

# Re-enable the Figma MCP server
openhands mcp enable figma

# Remove the Figma MCP server
openhands mcp remove figma

# Get details about the Figma server
openhands mcp get figma
```

## Documentation

- Figma MCP Server: https://developers.figma.com/docs/figma-mcp-server
- Remote Server Installation: https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/
- Figma API: https://www.figma.com/developers/api
Comment on lines +1 to +62

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Suggestion: README.md and SKILL.md have ~90% duplicate content. Per the repository conventions (see AGENTS.md), these should be complementary:

  • SKILL.md: Concise, progressive disclosure for agent decision-making
  • README.md: Extended examples, detailed workflows, usage patterns

Currently both files are nearly identical. README.md should include what SKILL.md lacks:

  • Actual usage examples of Figma MCP tools (what tools does it provide?)
  • Common workflows (e.g., extracting design tokens, reading component specs)
  • Best practices for working with Figma designs
  • Troubleshooting common issues

The PR description mentions "Future updates will include usage examples" - but these should be in the initial PR to be actually useful.

59 changes: 59 additions & 0 deletions skills/figma/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 Important: According to the repository agent notes, new skills should be added to .plugin/marketplace.json. This file is not included in the PR diff. Is this skill registered in the marketplace catalog?

name: figma
description: Access Figma designs using the Figma MCP server. Read design files, extract components, get design tokens, and inspect layer properties.
triggers:
- figma
- figma design
- figma mcp
---

# Figma MCP

The Figma MCP server provides tools to interact with Figma designs directly from OpenHands. It uses OAuth authentication to securely access your Figma account.

## Installation

To install the Figma MCP server, run the following command in your terminal:

```bash
openhands mcp add figma --transport http https://mcp.figma.com/mcp

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔴 Critical: This installation command conflicts with the one in README.md (line 22), which uses:

  • Different URL: https://figma.com/mcp/sse vs https://mcp.figma.com/mcp
  • Different flags: --auth oauth is present in README but missing here

Which one is correct? Having two different commands will confuse users and one will fail. This needs to be fixed before merge.

```

This will:
1. Add the Figma MCP server to your OpenHands configuration
2. You'll be prompted to authorize via Figma OAuth when first used
3. Enable the server immediately

After installation, restart your OpenHands session to apply the changes.

## Verification

To verify the installation:

```bash
openhands mcp list
```

You should see the Figma server listed with status "enabled".

## Managing the Server

```bash
# Disable the Figma MCP server
openhands mcp disable figma

# Re-enable the Figma MCP server
openhands mcp enable figma

# Remove the Figma MCP server
openhands mcp remove figma

# Get details about the Figma server
openhands mcp get figma
```

## Documentation

- Figma MCP Server: https://developers.figma.com/docs/figma-mcp-server
- Remote Server Installation: https://developers.figma.com/docs/figma-mcp-server/remote-server-installation/
Comment on lines +10 to +58

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 Important: This skill violates the progressive disclosure pattern required by the AgentSkills standard.

SKILL.md should be concise - just enough for an agent to decide whether to use it. Currently this includes:

  • Full installation verification steps
  • All management commands (disable/enable/remove/get)
  • Multiple documentation links
  • Detailed setup instructions

Fix: Move the detailed content (verification, management commands, docs) to README.md only. Keep SKILL.md minimal:

# Figma MCP

Access Figma designs using the Figma MCP server with OAuth authentication.

## Installation

[Single correct installation command]

For detailed usage, verification steps, and management commands, see README.md.

## Documentation
- [Figma MCP Server](https://developers.figma.com/docs/figma-mcp-server)

- Figma API: https://www.figma.com/developers/api
Loading