From 955c1e9106f6941c608f15e36d889ca88a5a499d Mon Sep 17 00:00:00 2001 From: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com> Date: Wed, 20 May 2026 14:13:16 +0530 Subject: [PATCH 1/2] Update web3auth skill details --- embedded-wallets/build-with-ai.mdx | 110 ++++++++++---------------- src/components/SkillContent/index.tsx | 2 +- 2 files changed, 41 insertions(+), 71 deletions(-) diff --git a/embedded-wallets/build-with-ai.mdx b/embedded-wallets/build-with-ai.mdx index b2f0ac5c2bf..59832a846a9 100644 --- a/embedded-wallets/build-with-ai.mdx +++ b/embedded-wallets/build-with-ai.mdx @@ -2,22 +2,10 @@ title: Build with AI sidebar_label: Build with AI toc_max_heading_level: 2 -description: 'Build MetaMask Embedded Wallets integrations faster using AI coding assistants — Cursor, Claude, Codex, Antigravity, OpenClaw, and more.' +description: 'Build MetaMask Embedded Wallets integrations faster using AI coding assistants — Cursor, Claude, Codex, Antigravity, and more.' image: 'img/metamaskog.jpg' keywords: - [ - ai, - cursor, - claude, - codex, - antigravity, - openclaw, - mcp, - llm, - coding assistant, - embedded wallets, - web3auth, - ] + [ai, cursor, claude, codex, antigravity, mcp, llm, coding assistant, embedded wallets, web3auth] --- import SkillContent from '@site/src/components/SkillContent' @@ -31,67 +19,72 @@ You'll set up the following: ## Skill -The Skill guides your AI assistant by providing a mental model for MetaMask Embedded Wallets. It includes SDK selection logic, -key derivation rules, authentication concepts, platform quirks, and common mistakes that aren't obvious from -the docs alone. The Skill contains no code. The MCP server provides up-to-date code examples and implementation references. +The Skill guides your AI assistant by providing a mental model for MetaMask Embedded Wallets. +It includes SDK selection logic, key derivation rules, authentication concepts, platform quirks, +and common mistakes that aren't obvious from the docs alone. +The Skill contains no code — the MCP server provides up-to-date code examples and implementation references. :::tip -For the best experience, use the MCP server alongside the skill so that your LLM can fetch live docs and examples rather than relying on static text. +For the best experience, use the MCP server alongside the skill so that your LLM can fetch live +docs and examples rather than relying on static text. ::: -### Cursor +### Universal install (recommended) -Copy the skill into your project: +Run the following in your project directory: ```bash -npx degit Web3Auth/web3auth-mcp/skills/web3auth .cursor/skills/web3auth +npx skills add web3auth/skill ``` -Cursor picks up each `SKILL.md` under `.cursor/skills//` automatically and activates -it when relevant. +The skills CLI detects your active AI agent and installs to the correct directory automatically. +Works with Cursor, Claude Code, Copilot, Kiro, Cline, Codex, Antigravity, and 40+ more agents. +See the [web3auth/skill README](https://github.com/Web3Auth/skill) for global and per-agent install options. -### Claude Code CLI +### Manual install + +If you prefer to install the skill without the CLI, use the following per-tool instructions. -Download the skill and append it to your project's `CLAUDE.md`: +**Cursor** ```bash -npx degit Web3Auth/web3auth-mcp/skills/web3auth /tmp/web3auth-skill -cat /tmp/web3auth-skill/SKILL.md >> CLAUDE.md +npx skills add web3auth/skill -a cursor ``` -### Claude Desktop +Or copy the skill directly into your project: -Open **Claude Desktop → Settings → Custom Instructions** and paste the skill content below directly. +```bash +npx degit Web3Auth/web3auth-mcp/skills/web3auth .cursor/skills/web3auth +``` -### Antigravity +Cursor picks up each `SKILL.md` under `.cursor/skills//` automatically and activates +it when relevant. -Copy the skill into your project: +**Claude Code CLI** ```bash -npx degit Web3Auth/web3auth-mcp/skills/web3auth .agent/skills/web3auth +npx skills add web3auth/skill -a claude-code ``` -Antigravity picks up skills inside `.agent/skills/` automatically. For global installation across all -projects, use `~/.gemini/antigravity/skills/` instead. +**Antigravity** -### OpenClaw - -Open your agent's configuration in the OpenClaw dashboard and paste the skill content below into the -**Custom Instructions** field. +```bash +npx skills add web3auth/skill -a antigravity +``` -For self-hosted instances, add it to your `openclaw.json`: +Or copy the skill directly into your project: -```json -{ - "agent": { - "instructions": "" - } -} +```bash +npx degit Web3Auth/web3auth-mcp/skills/web3auth .agent/skills/web3auth ``` -### Other tools +Antigravity picks up skills inside `.agent/skills/` automatically. +For global installation across all projects, use `~/.gemini/antigravity/skills/` instead. + +**Claude Desktop and other tools** -For any LLM tool with a system prompt or custom instructions field, paste the skill content below directly. +Open **Claude Desktop → Settings → Custom Instructions** (or your tool's equivalent system prompt +or custom instructions field) and paste the skill content below directly.
View `SKILL.md` file @@ -225,29 +218,6 @@ Then add to your agent's configuration: } ``` -### OpenClaw - -For managed instances, go to your **OpenClaw dashboard → Skills → Add custom skill** and enter the MCP -server URL: - -``` -https://mcp.web3auth.io -``` - -For self-hosted instances, add the server to your `openclaw.json`: - -```json -{ - "mcpServers": { - "web3auth": { - "url": "https://mcp.web3auth.io" - } - } -} -``` - -OpenClaw hot-reloads config changes — no restart required. - ## Static docs (llms.txt) If your AI tool doesn't support MCP yet, use the static documentation file instead. This gives your AI diff --git a/src/components/SkillContent/index.tsx b/src/components/SkillContent/index.tsx index 034730f9578..e4d87579d26 100644 --- a/src/components/SkillContent/index.tsx +++ b/src/components/SkillContent/index.tsx @@ -2,7 +2,7 @@ import React from 'react' import { usePluginData } from '@docusaurus/useGlobalData' import CodeBlock from '@theme/CodeBlock' -const SKILL_KEY = 'Web3Auth/web3auth-mcp/refs/heads/main/skills/web3auth/SKILL.md' +const SKILL_KEY = 'Web3Auth/skill/refs/heads/main/SKILL.md' export default function SkillContent(): JSX.Element { const files = usePluginData('docusaurus-plugin-virtual-files') as Record From a25ec0ab9718889af7c9618278c6f9b2f5092800 Mon Sep 17 00:00:00 2001 From: Yashovardhan Agrawal <21066442+yashovardhan@users.noreply.github.com> Date: Wed, 20 May 2026 15:14:38 +0530 Subject: [PATCH 2/2] fix issues --- embedded-wallets/build-with-ai.mdx | 6 +++--- src/utils/qs-file-links.json | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/embedded-wallets/build-with-ai.mdx b/embedded-wallets/build-with-ai.mdx index 59832a846a9..42107df05be 100644 --- a/embedded-wallets/build-with-ai.mdx +++ b/embedded-wallets/build-with-ai.mdx @@ -22,7 +22,7 @@ You'll set up the following: The Skill guides your AI assistant by providing a mental model for MetaMask Embedded Wallets. It includes SDK selection logic, key derivation rules, authentication concepts, platform quirks, and common mistakes that aren't obvious from the docs alone. -The Skill contains no code — the MCP server provides up-to-date code examples and implementation references. +The Skill contains no code. The MCP server provides up-to-date code examples and implementation references. :::tip For the best experience, use the MCP server alongside the skill so that your LLM can fetch live @@ -38,7 +38,7 @@ npx skills add web3auth/skill ``` The skills CLI detects your active AI agent and installs to the correct directory automatically. -Works with Cursor, Claude Code, Copilot, Kiro, Cline, Codex, Antigravity, and 40+ more agents. +Works with Cursor, Claude Code, Copilot, Cline, Codex, Antigravity, and 40+ more agents. See the [web3auth/skill README](https://github.com/Web3Auth/skill) for global and per-agent install options. ### Manual install @@ -254,7 +254,7 @@ chosen and common pitfalls are avoided before a line of code is written. :::tip -Use planning mode (where available) for your initial prompt. Review the plan before generating code — this +Use planning mode (where available) for your initial prompt. Review the plan before generating code; this catches architecture mistakes early and avoids config errors that would change wallet addresses in production. ::: diff --git a/src/utils/qs-file-links.json b/src/utils/qs-file-links.json index 60e7f8938aa..121a9bb1273 100644 --- a/src/utils/qs-file-links.json +++ b/src/utils/qs-file-links.json @@ -74,5 +74,5 @@ "EW_PNP_ANDROID_SETTINGS_GRADLE": "Web3Auth/web3auth-android-examples/main/android-quick-start/settings.gradle", "EW_PNP_ANDROID_STRINGS_XML": "Web3Auth/web3auth-android-examples/main/android-quick-start/app/src/main/res/values/strings.xml", "EW_PNP_ANDROID_ACTIVITY_MAIN_XML": "Web3Auth/web3auth-android-examples/main/android-quick-start/app/src/main/res/layout/activity_main.xml", - "EW_AI_SKILL_MD": "Web3Auth/web3auth-mcp/refs/heads/main/skills/web3auth/SKILL.md" + "EW_AI_SKILL_MD": "Web3Auth/skill/refs/heads/main/SKILL.md" }