From a79c36789fcb5943b468003f320d7927ab54a7c4 Mon Sep 17 00:00:00 2001 From: Alex Donesky Date: Thu, 18 Jun 2026 16:51:18 -0500 Subject: [PATCH 1/3] docs(skills): add README for the metamask-connect skill Adds install instructions (npx skills add), a layout overview, provenance, and license note. The README renders on the skill's skills.sh profile page and gives integrators the one-line install. --- skills/metamask-connect/README.md | 53 +++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 skills/metamask-connect/README.md diff --git a/skills/metamask-connect/README.md b/skills/metamask-connect/README.md new file mode 100644 index 00000000..ccf01254 --- /dev/null +++ b/skills/metamask-connect/README.md @@ -0,0 +1,53 @@ +# metamask-connect — Agent Skill + +An [agent skill](https://skills.sh) for building dApps that integrate MetaMask via the **MetaMask Connect SDK** — EVM (`@metamask/connect-evm`), Solana (`@metamask/connect-solana`), and multichain (`@metamask/connect-multichain`), plus the wagmi `metaMask()` connector. + +It teaches coding agents (Cursor, Claude Code, Copilot, Codex, etc.) how to set up clients across browser / React / React Native, connect and manage sessions, sign messages, send transactions, run multichain `invokeMethod` across CAIP-2 scopes, migrate from `@metamask/sdk`, and troubleshoot connection/polyfill issues — with guidance source-verified against the published packages. + +## Install + +The skill is distributed straight from this repo with the [`skills` CLI](https://github.com/vercel-labs/skills): + +```bash +# Install just this skill (no prompts), into the agent the CLI detects +npx skills add MetaMask/connect-monorepo --skill metamask-connect -y + +# Or run it interactively to choose agent + scope +npx skills add MetaMask/connect-monorepo --skill metamask-connect + +# Install globally (available across all your projects) +npx skills add MetaMask/connect-monorepo --skill metamask-connect -g -y + +# Preview what's in the repo without installing +npx skills add MetaMask/connect-monorepo --list +``` + +By default the CLI symlinks the skill into your agent's directory (e.g. `.cursor/skills/`); pass `--copy` to copy the files instead. Search the bare term `metamask` with `npx skills find metamask` to locate it in the directory. + +## What's inside + +``` +metamask-connect/ +├── SKILL.md # entry point — routing table the agent reads first +├── references/ # focused, always-on guidance per topic +│ ├── conventions.md # core guardrails (import paths, config, supportedNetworks, errors) +│ ├── evm.md # chain IDs / switchChain +│ ├── solana.md # CAIP-2 genesis hashes, wallet-adapter, platform limits +│ ├── multichain.md # singleton, sessions, invokeMethod, lazy transport +│ ├── events.md # EIP-1193 events, eventHandlers, Solana state changes +│ ├── react-native.md # polyfills / Metro config +│ ├── csp.md # Content Security Policy +│ ├── testing.md # mocking the client +│ └── troubleshooting.md # symptom → cause → fix index +└── workflows/ # step-by-step setup, sign/send, multichain, and migration guides +``` + +The agent reads `SKILL.md` first, then loads the relevant reference(s) and workflow for the task at hand. + +## Provenance + +Generated from the [`metamask-connect-cursor-plugin`](https://github.com/MetaMask/metamask-connect-cursor-plugin)'s `skills/` and always-on `rules/`, and source-verified against the published `@metamask/connect-*` packages in this monorepo. It lives here so it stays in sync with the SDK it documents. + +## License + +This skill is part of the connect-monorepo and is covered by the repository's [`LICENCE`](../../LICENCE). From 89814837319b8626498b6fa283424a9a626b2ff2 Mon Sep 17 00:00:00 2001 From: Alex Donesky Date: Thu, 18 Jun 2026 17:36:12 -0500 Subject: [PATCH 2/3] docs(skills): drop provenance section from skill README --- skills/metamask-connect/README.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/skills/metamask-connect/README.md b/skills/metamask-connect/README.md index ccf01254..ff28fe62 100644 --- a/skills/metamask-connect/README.md +++ b/skills/metamask-connect/README.md @@ -44,10 +44,6 @@ metamask-connect/ The agent reads `SKILL.md` first, then loads the relevant reference(s) and workflow for the task at hand. -## Provenance - -Generated from the [`metamask-connect-cursor-plugin`](https://github.com/MetaMask/metamask-connect-cursor-plugin)'s `skills/` and always-on `rules/`, and source-verified against the published `@metamask/connect-*` packages in this monorepo. It lives here so it stays in sync with the SDK it documents. - ## License This skill is part of the connect-monorepo and is covered by the repository's [`LICENCE`](../../LICENCE). From 9fea36300abcc660fe9fe20251b7cfb0b90df405 Mon Sep 17 00:00:00 2001 From: Alex Donesky Date: Mon, 22 Jun 2026 12:39:40 -0500 Subject: [PATCH 3/3] Update skills/metamask-connect/README.md Co-authored-by: jiexi --- skills/metamask-connect/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/metamask-connect/README.md b/skills/metamask-connect/README.md index ff28fe62..db08a386 100644 --- a/skills/metamask-connect/README.md +++ b/skills/metamask-connect/README.md @@ -2,7 +2,7 @@ An [agent skill](https://skills.sh) for building dApps that integrate MetaMask via the **MetaMask Connect SDK** — EVM (`@metamask/connect-evm`), Solana (`@metamask/connect-solana`), and multichain (`@metamask/connect-multichain`), plus the wagmi `metaMask()` connector. -It teaches coding agents (Cursor, Claude Code, Copilot, Codex, etc.) how to set up clients across browser / React / React Native, connect and manage sessions, sign messages, send transactions, run multichain `invokeMethod` across CAIP-2 scopes, migrate from `@metamask/sdk`, and troubleshoot connection/polyfill issues — with guidance source-verified against the published packages. +It teaches coding agents (Cursor, Claude Code, Copilot, Codex, etc.) how to set up clients across browser / React / React Native / nodejs, connect and manage sessions, sign messages, send transactions, run multichain `invokeMethod` across CAIP-2 scopes, migrate from `@metamask/sdk`, and troubleshoot connection/polyfill issues — with guidance source-verified against the published packages. ## Install