convez.ai
MCP Server
vaquarkhan

web3-agent-skills

vaquarkhan/web3-agent-skills

Ver no GitHub
BomPluginScore · de 0 a 100

Production-grade Agent Skills for Web3 AI agents: 15 workflows, 6 MCP servers, DeFi/NFT/compliance guardrails, and VS Code/JetBrains installers.

Instalação

$npx convez-ai vaquarkhan/web3-agent-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 2 meses
Versão
—
Issues abertas
6
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Web3 Agent Skills

License: MIT Skills MCP Servers Examples Validate

GitHub Releases · VS Code Extension · JetBrains Plugin

Production-grade Agent Skills for Web3 AI agents: 15 domain workflows, 6 MCP servers, chain presets, compliance guardrails, MEV protection, and VS Code / JetBrains installers.

The open skill registry and execution toolkit for Web3 agents — wallets, DeFi, NFTs, DAOs, cross-chain, compliance, and institutional RWA workflows with the same discipline used by production Web3 teams.

Agent Skills Registry Compatibility

  • Every capability lives in a directory containing a SKILL.md
  • Every SKILL.md starts with YAML frontmatter: name and description
  • Supporting materials in references/, knowledge-base/, examples/, hooks/, and scripts/
  • Progressive disclosure: agents load skills on demand

Quick Start

git clone https://github.com/vaquarkhan/web3-agent-skills.git
cd web3-agent-skills
npm install && npm run build
node scripts/link-skills.js
npm test

Install into your project:

scripts/install.sh --tool all --target /path/to/project
# Windows:
pwsh scripts/install.ps1 --tool all --target C:\path\to\project

Bootstrap shortcut:

./bootstrap.sh /path/to/project
pwsh .\bootstrap.ps1 C:\path\to\project

Install Surfaces

VS Code / Cursor / Windsurf / VSCodium

  1. Download .vsix from GitHub Releases
  2. Command Palette → Extensions: Install from VSIX...
  3. Command Palette → Web3 Agent Skills: Install Full Toolkit

See vscode-extension/README.md and tutorials/installing-vscode-and-jetbrains-plugins.md.

JetBrains (IntelliJ, PyCharm, WebStorm, GoLand)

  1. Download .zip from Releases or install from JetBrains Marketplace
  2. Settings → Plugins → Install from Disk...
  3. Tools → Web3 Agent Skills → Install Full Toolkit

See jetbrains-plugin/README.md and docs/jetbrains-setup.md.

Install By Tool

ToolSetup guideInstall path
VS Code / Cursordocs/cursor-setup.mdExtension or scripts/install.sh --tool cursor
JetBrainsdocs/jetbrains-setup.mdPlugin or scripts/install.sh --tool all
Claudedocs/claude-setup.md.claude/commands/ or install script
Copilotdocs/copilot-setup.md.github/copilot-instructions.md
Codex / AGENTS.mddocs/getting-started.mdAGENTS.md + skills-index.md

Core Principles

  • Simulate before every state-changing transaction
  • Screen all addresses against sanctions lists
  • Never expose private keys or seed phrases
  • Contract verification before interaction
  • Exact token approvals over unlimited
  • MEV protection for high-value swaps
  • $10,000 confirmation threshold

Lifecycle Commands

CommandPurpose
/simulateSimulate transaction (required before send)
/auditSecurity audit and rug-pull checks
/screenSanctions screening and Travel Rule
/swapDeFi swap with MEV + slippage guards
/bridgeCross-chain transfer with security review
/reviewGas, compliance, and security review

15 Skills

#SkillPhaseCapabilities
1Wallet Management1HD wallets, ERC-4337, multi-sig, social recovery
2Smart Contract Interaction1ABI, deploy, proxies, multicall
3DeFi Operations1Swap, lend/borrow, stake, LP, flash loans
4NFT Management2Mint/trade, ERC-721/1155, TBA
5DAO Governance4Proposals, voting, treasury, timelocks
6Cross-Chain Bridge3Bridging, messaging, intent routing
7Token Analytics2Whale tracking, DEX volume, PnL
8Security Audit2Vulnerability detection, rug pulls
9Compliance & AML3Sanctions, Travel Rule, MiCA, Howey
10Identity (DID)3DIDs, ENS, ZK-KYC, attestations
11Oracle & Data Feeds4Chainlink, Pyth, VRF, keepers
12Gas Optimization1EIP-1559, nonce, private txs, blobs
13RWA Tokenization4Treasuries, ERC-3643, yield
14Social & Reputation5Lens, Farcaster, reputation
15MEV Protection2Flashbots, TWAP, sandwich protection

Full catalog: skills-index.md

6 MCP Servers

ServerPurpose
blockchain-rpc-serverChain RPC (Alchemy, Infura, QuickNode)
defi-protocol-serverProtocol ABIs, subgraphs, pools
nft-metadata-serverIPFS, Arweave, NFT APIs
price-feed-serverChainlink, Pyth, CoinGecko
compliance-screening-serverChainalysis, sanctions, Travel Rule
ipfs-storage-serverPinata, web3.storage

Templates: mcp/ · Build: npm run build

Examples

ExampleTypeBest for
uniswap-swap-guardrailsRunnableSafe DEX swap with simulation
compliance-screening-transferRunnableSanctions + Travel Rule
nft-mint-ipfsRunnableIPFS metadata + CID validation
defi-yield-vault-blueprintBlueprintERC-4626 vault architecture
cross-chain-bridge-blueprintBlueprintL1→L2 bridge plan
dao-governance-blueprintBlueprintGovernor + timelock

See examples/README.md.

Project Structure

web3-agent-skills/
├── skills/                 # 15 Agent Skills (SKILL.md per domain)
├── tools/mcp-servers/      # 6 MCP tool servers
├── knowledge-base/         # Chains, protocols, standards, regulations
├── guardrails/             # Web3 safety rules
├── agents/                 # Multi-skill orchestration
├── presets/                # Chain-specific operating profiles
├── starter-packs/          # Problem-area bundles
├── examples/               # Runnable scaffolds + blueprints
├── mcp/                    # MCP config templates
├── vscode-extension/       # VS Code / Cursor installer
├── jetbrains-plugin/       # JetBrains IDE installer
├── registry/               # Machine-readable asset index
├── docs/                   # Setup and onboarding guides
├── scripts/                # Install and validation scripts
└── tests/                  # Coverage tests

Supported Chains

Ethereum, Solana, Polygon, Arbitrum, Base, Optimism, Avalanche, BNB, Cosmos, Bitcoin L2s, TON, Sui/Aptos

Per-chain details: knowledge-base/chains/

Guardrails

guardrails/web3-guardrails.yaml:

  • Never expose private keys or seed phrases
  • Block unverified/scam contracts
  • Warn on unlimited token approvals
  • Screen addresses against sanctions lists
  • Require simulation before execution
  • Max value without confirmation: $10,000 USD

Multi-Agent Packaging

  • .cursor/rules/ — Cursor rules
  • .claude/commands/ — Claude slash commands
  • .github/copilot-instructions.md — GitHub Copilot
  • AGENTS.md — Generic agent entry point
  • CLAUDE.md — Claude-specific notes

Related Projects

Contributing

See CONTRIBUTING.md · CHANGELOG.md · SECURITY.md

License

MIT — see LICENSE

Ver o original no GitHub

Bom para

Relacionados