metaskill MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

/metaskill single command — no manual role design
Research phase runs live web searches so output reflects current ecosystem
Generates routing doc, agents, skills, standards, and MCP config in one pass
Three intent modes: full team / single agent / single skill
Default architecture uses Opus tech-lead + Sonnet specialists with review gates

实时演示

实际使用效果

metaskill-skill.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "metaskill-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/xvirobotics/metaskill",
        "~/.claude/skills/metaskill"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "metaskill-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/xvirobotics/metaskill",
        "~/.claude/skills/metaskill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "metaskill-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/xvirobotics/metaskill",
        "~/.claude/skills/metaskill"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "metaskill-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/xvirobotics/metaskill",
        "~/.claude/skills/metaskill"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "metaskill-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/xvirobotics/metaskill",
        "~/.claude/skills/metaskill"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "metaskill-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/xvirobotics/metaskill",
          "~/.claude/skills/metaskill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add metaskill-skill -- git clone https://github.com/xvirobotics/metaskill ~/.claude/skills/metaskill

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： metaskill

Bootstrap an AI agent team for a fullstack project

👤 Founders and solo devs who want structured multi-agent setups ⏱ ~20 min beginner

何时使用： Starting a new project and you'd like proper agent separation instead of one overloaded Claude.

前置条件

Skill cloned — git clone https://github.com/xvirobotics/metaskill ~/.claude/skills/metaskill

步骤

Describe the project

/metaskill fullstack web app with React, TanStack, Postgres, Stripe subscriptions.✓ 已复制

→ Research phase runs web searches; then build phase produces routing + agents + skills
Review the generated team

Walk me through each agent's scope and the routing rules between them.✓ 已复制

→ Clear per-agent responsibility with no overlap
Provide credentials (optional)

Skip credentials for now — I'll add them later.✓ 已复制

→ Skill proceeds to verification without blocking

结果： A working multi-agent setup you can start using immediately.

注意事项

Generated team has too many roles for a 1-person project — Use the single-agent mode instead ('create a single agent for X')

搭配使用： github · filesystem

Create one specialized agent for an existing workflow

👤 Devs who already have a project and want to add one role ⏱ ~10 min beginner

何时使用： You need a 'security reviewer' agent but already have everything else.

步骤

Invoke single-agent mode

/metaskill — a single security reviewer agent for a Node.js API.✓ 已复制

→ Targeted agent file with scope, not a full team

结果： One focused agent integrated into your existing setup.

Generate a single deploy skill without building a whole team

👤 Devs formalizing a workflow ⏱ ~15 min beginner

何时使用： You keep running the same deploy steps manually and want a skill for it.

步骤

Invoke single-skill mode

/metaskill — a deploy-to-staging skill for Cloudflare Workers with rollback on health-check failure.✓ 已复制

→ SKILL.md with triggers and steps

结果： A reusable skill you can install right away.

搭配使用： skillcheck-free-skill

组合

与其他 MCP 搭配，撬动十倍杠杆

metaskill-skill + skillcheck-free-skill

Validate Metaskill's generated SKILL.md files against the agentskills spec before using them

After /metaskill, run SkillCheck on every generated SKILL.md.✓ 已复制

metaskill-skill + github

Commit the generated team structure as a first PR to seed your repo

After generation, commit .claude/ and agent docs in a single 'seed' PR.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
generate_team	project description	Fresh project	0 + web search tokens
generate_single_agent	role description	Existing team, need one more role	0
generate_single_skill	workflow description	Formalizing a repeated workflow	0
verify	generated files	Auto-run after generation	0

成本与限制

运行它的成本

API 配额: Uses web search during research phase
每次调用 Token 数: High for team generation (research + build); lower for single-agent/skill modes
费用: Free — skills are local files. Web search may count against your own MCP's quotas.
提示: Use single-agent mode when you don't need a full team; it's much cheaper.

安全

权限、密钥、影响范围

凭据存储： No credentials in the skill itself. Credentials phase asks for your API keys if you opt-in.

数据出站： Research phase performs web searches

Generated agents are suggestions — review them before granting them MCP tool access.

故障排查

常见错误与修复

Skill not invoked — Claude sets up agents manually

Use '/metaskill' as a literal trigger.

验证： ls ~/.claude/skills/metaskill/SKILL.md

SKILL.md frontmatter wrong

Re-clone; description drives activation.

验证： head ~/.claude/skills/metaskill/SKILL.md

Wrong trigger keywords — generates a skill when you wanted a team

Phrase the project description clearly; 'fullstack web app' triggers team mode, 'a skill for X' triggers skill mode.

替代方案

metaskill 对比其他方案

替代方案	何时用它替代	权衡
Manual agent design	You have strong opinions about role structure	More control, much slower
rootnode-skill	You want Project-level engineering rather than agent-team generation	Different axis — Claude Projects vs Claude Code multi-agent

metaskill