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