MetaMask生态系统的代理技能、规则和领域知识。

有两个受众共享这个仓库：

1. dApp / Web3 开发者 — 技能 domains/web3-tools/ 教授 AI 代理如何使用MetaMask开发库（gator-cli， smart-accounts-kit，OpenCode 插件等）。把它们放进你的 编辑器/代理，它会正确操作工具。
2. MetaMask 产品工程师 — 技能属于domains/perps/， domains/testing/、domains/pr-workflow/、domains/agentic/等承载约定 并回顾metamask-extension、metamask-mobile和core的启发式方法。 这些文件通过一个小型CLI安装到消费者仓库中。

单一真实来源，多操作员输出（Claude码，光标， Codex/OpenAI），公开正典，私密叠加层可选。

私有叠加层： 仅内部技能（Consensys 全域工具， 进行中的实验，非公共产品）分别存在于一个独立的环境中 私人仓库，Consensys/skills。 有权限的工程师可以把这些技能叠加到公共技能之上。 参见联邦。

快速开始

对于dApp / Web3开发者（使用单一技能）

把你的代理指向这个仓库，加载与你技能匹配的技能 工具。

MetaMask/skills

Agent skills, rules, and domain knowledge for the MetaMask ecosystem.

Two audiences share this repo:

1. dApp / Web3 developers — skills under domains/web3-tools/ teach AI agents how to use MetaMask developer libraries (gator-cli, smart-accounts-kit, OpenCode plugin, etc.). Drop them into your editor/agent and it will operate the tooling correctly.
2. MetaMask product engineers — skills under domains/perps/, domains/testing/, domains/pr-workflow/, domains/agentic/, etc. carry the conventions and review heuristics for metamask-extension, metamask-mobile, and core. These install into consumer repos via a small CLI.

Single source of truth, multi-operator output (Claude Code, Cursor, Codex/OpenAI), public canonical, private overlay optional.

Private overlay: internal-only skills (Consensys-wide tooling, in-progress experiments, non-public products) live in a separate private repo, Consensys/skills. Engineers with access can layer those skills on top of the public set. See Federation.

Quickstart

For dApp / Web3 developers (use a single skill)

Point your agent at this repo and load the skill that matches your tooling. For example, to use the gator-cli skill in Claude Code:

# One-time clone:
git clone https://github.com/MetaMask/skills ~/dev/metamask/skills

# Copy or symlink the skill you want into your project (or ~/.claude/skills):
cp -r ~/dev/metamask/skills/domains/web3-tools/skills/gator-cli/* \
     ~/.claude/skills/gator-cli/

Or use the installer to drop all web3-tools/ skills at once:

~/dev/metamask/skills/tools/install \
  --repo metamask-extension --target . --domain web3-tools

Package CLI

@metamask/skills is also an npm package and exposes the shared consumer CLI:

metamask-skills list          # discover installable skills for the current repo
metamask-skills search test   # search skill names and descriptions
metamask-skills describe testing/mobile-testing
metamask-skills sync          # infer repo + target, refresh cache, install skills
metamask-skills postinstall   # refresh cache; sync by default (SKILLS_AUTO_UPDATE=0 opts out)
metamask-skills install       # lower-level installer wrapper

The discovery commands make opt-in selection self-serve. Developers can find a skill, inspect it, then save their selection. On Mobile, install one skill — mobile-testing — for unit, component-view, integration, Appium E2E, and test-layer placement (see domains/testing/knowledge/testing-layers.md):

metamask-skills list --domain testing
metamask-skills describe testing/mobile-testing
metamask-skills sync --include testing/mobile-testing --save

Consumer repos should prefer this CLI over copying sync/postinstall scripts. That keeps cache behavior, .skills.local parsing, maturity filtering, and