figma-enginner-installer

用于一键安装 Figma-Engineer skill，并自动配置 figma-developer-mcp（支持 codex 与 cc/claude）。

Skill 详细介绍

• Figma-Engineer 项目地址（详细说明）：
  • https://github.com/liuzeyu4201/Figma-Engineer.git

功能概览

安装器会自动执行三步：

1. 检查目标目录读写权限。
2. 安装 skill：复制 Figma-Engineer 文件夹到目标目录。
3. 配置并校验 MCP：添加 figma MCP，并执行 mcp get figma 检查。

安装

npm i -g figma-enginner-installer

命令格式

注意: 在启动下载器前先获取 Figma API Key。获取api-key 方法参见:Figma-Context-MCP 或查看 Figma-Engineer 项目文档。

安装命令:

figma-enginner-installer -agent <codex|cc> -api-key <FIGMA_API_KEY> [-i <skill_dir>]

参数说明

• -agent（必填）
  • 可选值：codex 或 cc
  • 兼容别名：claude、claudecode（会映射到 cc）
• -api-key（必填）
  • Figma API Key
• -i（可选）
  • skill 安装目录
  • 不传则使用 agent 全局目录
    • codex：~/.agents/skills
    • cc：~/.claude/skills

使用示例

macOS/Linux

figma-enginner-installer -agent codex -api-key YOUR_KEY
figma-enginner-installer -agent cc -api-key YOUR_KEY
figma-enginner-installer -agent codex -api-key YOUR_KEY -i /custom/skills/path

Windows (PowerShell/CMD)

figma-enginner-installer -agent codex -api-key YOUR_KEY
figma-enginner-installer -agent cc -api-key YOUR_KEY
figma-enginner-installer -agent codex -api-key YOUR_KEY -i "C:\skills"

说明：Windows 下安装器会自动使用 codex.cmd / claude.cmd / npx.cmd。

MCP 配置行为

安装器内部会执行（YOUR-KEY 替换为 -api-key）：

• codex
  • codex mcp add figma --command npx --args "-y figma-developer-mcp --figma-api-key=YOUR-KEY --stdio"
  • 如果本机 codex 版本使用新语法，会自动回退到 codex mcp add figma -- npx -y ... 格式
• cc/claude
  • claude mcp add figma --command npx --args "-y figma-developer-mcp --figma-api-key=YOUR-KEY --stdio"

安装后校验

• cc/claude
  • claude mcp get figma
  • claude skills get figma
• codex
  • codex mcp get figma
  • codex 暂无统一 skill 查询命令，安装器会提示你手动确认 skill 目录

常见错误

• 缺少参数
  • Missing required option: -agent
  • Missing required option: -api-key
• agent 非法
  • Invalid -agent value. Only codex or cc is allowed.
• 目录无权限
  • No read/write permission for target directory: ...
• 本机未安装 codex/claude
  • 会显示命令执行失败，请先安装对应 CLI 并确保在 PATH 中

卸载

1. 删除安装的 skill 目录中的 Figma-Engineer 文件夹。
2. 使用对应 CLI 删除 MCP（如有需要）：
   • codex mcp remove figma
   • claude mcp remove figma