Agent skill

W3wallets

Interact with browser wallets (MetaMask, Polkadot.js) in Playwright e2e tests.

MITAuto-check passedTesting & QA

Install W3wallets

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/w3wallets .claude/skills/w3wallets && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .claude/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/w3wallets .agents/skills/w3wallets && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .agents/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/w3wallets .cursor/skills/w3wallets && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .cursor/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Maksandre/w3wallets.git --path skills/w3wallets

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/w3wallets .gemini/skills/w3wallets && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .gemini/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/w3wallets .github/skills/w3wallets && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .github/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Maksandre/w3wallets --skill w3wallets -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Maksandre/w3wallets w3wallets --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Maksandre/w3wallets.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/w3wallets .opencode/skills/w3wallets && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "w3wallets" agent skill from https://github.com/Maksandre/w3wallets/tree/main/skills/w3wallets into .opencode/skills/w3wallets/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "w3wallets", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: w3wallets
GitHub stars: 104
Token cost: ~1.7k tokens
SKILL.md length: 379 words
Files: 5 (incl. references)
Skills in repo: 1
Repo updated: Sep 26, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Interact with browser wallets (MetaMask, Polkadot.js) in Playwright e2e tests.

The user needs to set up wallet extensions
SKILL.md covers Quick Start, Setup, withWallets Fixture and Wallet API Overview, plus 6 more sections
Calls npx and npm
Create wallet fixtures

What it does

W3wallets is an agent skill from Maksandre/w3wallets. Interact with browser wallets (MetaMask, Polkadot.js) in Playwright e2e tests. Use when the user needs to set up wallet extensions, create wallet fixtures, approve/deny transactions, manage wallet caching, or any Web3 wallet interaction in tests.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/caching.md`, `references/custom-wallets.md` and `references/metamask-api.md`).

It sits in Testing & QA, covering Browser testing, End-to-end testing and Crypto and DeFi analysis. It works with Playwright and Ethereum. The repository describes itself as: Web3 wallet automation for Playwright testing. The licence is MIT.

When your agent uses it

The user needs to set up wallet extensions
Create wallet fixtures
Approve/deny transactions
Manage wallet caching

Example prompts

“/w3wallets”

Requirements

Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 9fda5f8. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- npx
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

W3wallets loads about 1.7k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 379 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~64
When it runs · the whole SKILL.md, loaded when a task matches: ~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~5.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Maksandre/w3wallets at commit 9fda5f8, republished under its MIT licence (© Maksandre). 379 words, ~1,702 tokens.

Download SKILL.mdSave it as .claude/skills/w3wallets/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: w3wallets
description: Interact with browser wallets (MetaMask, Polkadot.js) in Playwright e2e tests. Use when the user needs to set up wallet extensions, create wallet fixtures, approve/deny transactions, manage wallet caching, or any Web3 wallet interaction in tests.
metadata.author: Maksandre
metadata.version: 1.0
license: MIT

w3wallets

A Playwright library for browser wallet interactions (MetaMask, Polkadot.js) in e2e tests.

Quick Start

bash

# 1. Install the library
npm install -D w3wallets

# 2. Download the wallet extension
npx w3wallets metamask

# 3. Create a fixture and write a test

// fixtures.ts
import { test as base } from "@playwright/test";
import { withWallets, metamask } from "w3wallets";

export const test = withWallets(base, metamask);

// my-test.spec.ts
import { test } from "./fixtures";

test("connect wallet", async ({ page, metamask }) => {
  await metamask.onboard("your twelve word mnemonic phrase here ...");
  await page.goto("http://localhost:3000");
  await page.getByRole("button", { name: "Connect Wallet" }).click();
  await metamask.approve();
});

Setup

Download wallet extensions with the CLI:

bash

npx w3wallets metamask      # downloads MetaMask
npx w3wallets polkadotjs    # downloads Polkadot.js
npx w3wallets <extension-id> # downloads any Chrome extension by ID

Extensions are stored in .w3wallets/ at the project root. Add .w3wallets/ to .gitignore.

withWallets Fixture

withWallets(base, ...walletConfigs) extends Playwright's test with wallet fixtures. Each wallet config adds a typed fixture by its name.

import { test as base } from "@playwright/test";
import { withWallets, metamask, polkadotJS } from "w3wallets";

// Single wallet
const test = withWallets(base, metamask);
// test("...", async ({ metamask }) => { ... });

// Multiple wallets
const test = withWallets(base, metamask, polkadotJS);
// test("...", async ({ metamask, polkadotJS }) => { ... });

Each fixture provides a wallet instance with its own extension page. The context fixture is a persistent Chromium context with extensions loaded.

Wallet API Overview

MetaMask

Method	Description
`onboard(mnemonic, password?)`	Import wallet with recovery phrase
`approve()`	Confirm the pending transaction/connection
`deny()`	Reject the pending transaction/connection
`lock()`	Lock the wallet
`unlock(password?)`	Unlock the wallet (handles post-unlock screens)
`switchNetwork(name, category?)`	Switch to a network by name (`category` is deprecated and ignored)
`switchAccount(name)`	Switch to an account by name
`addNetwork(settings)`	Add a custom network via settings page
`addCustomNetwork(settings)`	Add a custom network via the networks modal
`enableTestNetworks()`	Toggle test networks visibility
`importAccount(privateKey)`	Import an account by private key
`accountNameIs(name)`	Assert the active account name

NetworkSettings: { name: string, rpc: string, chainId: number, currencySymbol: string }

Polkadot.js

Method	Description
`onboard(seed, password?, name?)`	Import account from seed phrase
`approve()`	Approve connection or sign transaction
`deny()`	Reject connection or cancel signing
`selectAllAccounts()`	Select all accounts for connection
`selectAccount(accountId)`	Select a specific account by ID
`enterPassword(password?)`	Enter password for signing

Full API details: MetaMask reference | Polkadot.js reference

Common Patterns

Show full SKILL.md (154 more words)Show less

The Two-Page Dance

Wallet interactions involve two pages: your dApp page and the wallet extension page. The library handles navigation to the extension automatically.

// 1. Trigger action on dApp page
await page.getByRole("button", { name: "Connect Wallet" }).click();

// 2. Approve in wallet (library navigates to extension page internally)
await metamask.approve();

// 3. Continue on dApp page
await page.bringToFront(); // bring dApp page back to focus if needed

Connect, Sign, Approve, Deny

// Connect
await page.getByRole("button", { name: "Connect" }).click();
await metamask.approve();

// Sign a message
await page.getByRole("button", { name: "Sign" }).click();
await metamask.approve();

// Deny a transaction
await page.getByRole("button", { name: "Send" }).click();
await metamask.deny();

Switch Network

await metamask.switchNetwork("Sepolia");
await metamask.switchNetwork("My Custom Network");

Caching

Wallet onboarding (seed import, password setup) takes 15-30 seconds. Caching reduces this to ~2 seconds by restoring a pre-onboarded browser profile.

Quick setup:

// wallets-cache/default.cache.ts
import { prepareWallet, metamask } from "w3wallets";

export default prepareWallet(metamask, async (wallet) => {
  await wallet.onboard("your twelve word mnemonic ...", "MyPassword123!");
});

bash

npx w3wallets cache wallets-cache          # build cache
npx w3wallets cache wallets-cache --force  # rebuild

// fixtures.ts — use cached wallet
import { test as base } from "@playwright/test";
import { withWallets } from "w3wallets";
import cachedMetamask from "./wallets-cache/default.cache";

const test = withWallets(base, cachedMetamask);

// Fixture: unlock instead of onboard
test.extend({
  metamask: async ({ metamask }, use) => {
    await metamask.unlock(); // ~2s instead of ~20s
    await use(metamask);
  },
});

Full caching guide: references/caching.md

Configuration

Environment variables:

Variable	Description	Default
`W3WALLETS_ACTION_TIMEOUT`	Timeout for actions (click, fill, goto) in ms	`30000`
`W3WALLETS_EXPECT_TIMEOUT`	Timeout for expect assertions in ms	Playwright default (5000)
`W3WALLETS_DEBUG`	Enable debug logging (`"true"`)	disabled

bash

W3WALLETS_DEBUG=true npx playwright test

Waiting Best Practices

Prefer waiting for UI effects: await expect(element).toBeVisible()
Use page.waitForResponse / page.waitForRequest for API calls when no reliable UI indicator exists
Avoid page.waitForTimeout — only use during debugging or as a last resort

Custom Wallets

You can add support for any Chrome extension wallet by extending the Wallet base class. See references/custom-wallets.md.

References

Files

SKILL.md and 4 other files (references) in skills/w3wallets of Maksandre/w3wallets.

SKILL.md
references/caching.md
references/custom-wallets.md
references/metamask-api.md
references/polkadotjs-api.md

Open the folder on GitHubat commit 9fda5f8

Compare with similar skills

W3wallets next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

W3wallets compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
W3wallets this skillMaksandre/w3wallets	104	—	~1.7k	Automated safety check: Pass	MIT	11 days ago
Web Application Testinganthropics/skills	180k	51 repos	~966	Automated safety check: Pass	Apache-2.0	2 days ago
playwright-cli Browser Automationgithub/gh-aw	5.3k	23 repos	~2.8k	Automated safety check: Pass	MIT	today
Write and Verify Playwright Testsappsmithorg/appsmith	41k	—	~2.9k	Automated safety check: Notes	Apache-2.0	today
Cucumber and Playwright E2E Testslanggenius/dify	158k	—	~682	Automated safety check: Pass	Custom licence	today
E2E Testinglangflow-ai/langflow	156k	—	~3.3k	Automated safety check: Pass	MIT	today

Similar skills

Web Application Testing
anthropics/skills
Official
Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.
180k GitHub starsUsed in 51 repos~966 tokens
Testing & QAAuto-check passed
playwright-cli Browser Automation
github/gh-aw
Official
Drives a real browser from the command line with playwright-cli to open pages, interact, mock requests, save state and work with Playwright tests.
5.3k GitHub starsUsed in 23 repos~2.8k tokens
Testing & QAAuto-check passed
Write and Verify Playwright Tests
appsmithorg/appsmith
Writes a Playwright end-to-end test from a prompt, runs it against a live Appsmith deployment and retries with fixes up to three times until it passes.
41k GitHub stars~2.9k tokensUpdated today
Testing & QAAuto-check: notes
Cucumber and Playwright E2E Tests
langgenius/dify
Guides changes and reviews of the Cucumber and Playwright end-to-end suite under `e2e/`: feature files, step definitions, support code, tags, locators and assertions.
158k GitHub stars~682 tokensUpdated today
Testing & QAAuto-check passed
E2E Testing
langflow-ai/langflow
Write and review Playwright E2E tests for Langflow. An agent skill from langflow-ai/langflow.
156k GitHub stars~3.3k tokensUpdated today
Testing & QAAuto-check passed
Handsontable Playwright E2E Tests
handsontable/handsontable
Guides writing and changing Playwright end-to-end tests for Handsontable using page objects, data-testid hooks and deterministic waits.
22k GitHub stars~1.7k tokensUpdated today
Testing & QAAuto-check passed

Works with

Questions about W3wallets

What does W3wallets do?

Interact with browser wallets (MetaMask, Polkadot.js) in Playwright e2e tests. W3wallets is an agent skill from Maksandre/w3wallets.js) in Playwright e2e tests.

When should I use W3wallets?

W3wallets fits situations like: the user needs to set up wallet extensions; create wallet fixtures; approve/deny transactions; manage wallet caching.

How do I install W3wallets in Claude Code?

Run `npx skills add Maksandre/w3wallets --skill w3wallets -a claude-code`. Or copy the skill folder (skills/w3wallets in Maksandre/w3wallets) into .claude/skills/w3wallets in your project. Claude Code loads it when a task matches its description.

How do I install W3wallets in Codex?

Run `npx skills add Maksandre/w3wallets --skill w3wallets -a codex`. Or copy the skill folder (skills/w3wallets in Maksandre/w3wallets) into .agents/skills/w3wallets in your project. Codex loads it when a task matches its description.

Can I use W3wallets in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Maksandre/w3wallets --skill w3wallets -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/w3wallets, .gemini/skills/w3wallets, .github/skills/w3wallets and .opencode/skills/w3wallets in your project.

What does W3wallets need to run?

Going by SKILL.md and its folder, W3wallets needs the command-line tools its instructions call (npx and npm). Our summary lists: Node.js.

Does W3wallets access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is W3wallets safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does W3wallets use?

W3wallets is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does W3wallets use?

About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to W3wallets?

Skills that share tags, products or a category with W3wallets: Web Application Testing (anthropics/skills, 180k stars), playwright-cli Browser Automation (github/gh-aw, 5.3k stars), Write and Verify Playwright Tests (appsmithorg/appsmith, 41k stars) and Cucumber and Playwright E2E Tests (langgenius/dify, 158k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains W3wallets?

Maksandre (a GitHub user) maintains it in Maksandre/w3wallets, which has 104 GitHub stars. The repository was last updated on September 26, 2026.

Source: Maksandre/w3wallets on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install W3wallets

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

w3wallets

Quick Start

Setup

withWallets Fixture

Wallet API Overview

MetaMask

Polkadot.js

Common Patterns

The Two-Page Dance

Connect, Sign, Approve, Deny

Switch Network

Caching

Configuration

Waiting Best Practices

Custom Wallets

References

Files

Compare with similar skills

Similar skills

Web Application Testing

playwright-cli Browser Automation

Write and Verify Playwright Tests

Cucumber and Playwright E2E Tests

E2E Testing

Handsontable Playwright E2E Tests

Related

Questions about W3wallets