-
Notifications
You must be signed in to change notification settings - Fork 13
Add Figma MCP skill #80
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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 | ||
| ``` | ||
|
|
||
| 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
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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:
Currently both files are nearly identical. README.md should include what SKILL.md lacks:
The PR description mentions "Future updates will include usage examples" - but these should be in the initial PR to be actually useful. |
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,59 @@ | ||
| --- | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 |
||
| 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 | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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:
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
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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:
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 | ||
There was a problem hiding this comment.
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.