Read-only EVM client: wallets, tokens, gas across 8 chains. An agent skill from Luciole-Studio/Misaka-Agent.

MITAuto-check passedBackend & APIs

Install Evm

skills CLI
$ npx skills add Luciole-Studio/Misaka-Agent --skill evm -a claude-code

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

GitHub CLI
$ gh skill install Luciole-Studio/Misaka-Agent evm --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/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/misaka/core/skills/assets/optional/blockchain/evm .claude/skills/evm && 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/

Facts

Skill name
evm
GitHub stars
139
Used in
2 other repos
Token cost
~2.1k tokens
SKILL.md length
634 words
Files
2 (incl. scripts)
Skills in repo
76
Repo updated
First seen
Licence
MIT

At a glance

Read-only EVM client: wallets, tokens, gas across 8 chains. An agent skill from Luciole-Studio/Misaka-Agent.

  • Works in 10 steps: Setup Check → Wallet Portfolio → Multi-Chain Scan → …
  • Tasks that involve Smart contracts
  • SKILL.md covers When to Use, Prerequisites, Quick Reference and Procedure, plus 3 more sections
  • Runs Python scripts from its folder; calls python

What it does

Evm is an agent skill from Luciole-Studio/Misaka-Agent. Read-only EVM client: wallets, tokens, gas across 8 chains.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/evm_client.py`).

It sits in Backend & APIs, covering Smart contracts. It works with Ethereum. The repository describes itself as: A multi-agent research system for the humanities and social sciences. The licence is MIT.

When your agent uses it

  • Tasks that involve Smart contracts

Example prompts

  • “/evm”

Requirements

  • Python 3

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Setup Check
  2. Wallet Portfolio
  3. Multi-Chain Scan
  4. Compare (Gas + Prices)
  5. Transaction Details & Decode
  6. ENS Resolution
  7. Allowance Checker (Security)
  8. Contract Inspector
  9. Whale Detection
  10. Gas Tracker

What it can do on your machine

Read from SKILL.md and the folder at commit b94464a. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Evm loads about 2.1k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 634 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from Luciole-Studio/Misaka-Agent at commit b94464a, republished under its MIT licence (© Luciole-Studio). 634 words, ~2,092 tokens.

Download SKILL.mdSave it as .claude/skills/evm/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
evm
description
Read-only EVM client: wallets, tokens, gas across 8 chains.
version
1.0.0
author
Mibayy (@Mibayy), youssefea (@youssefea), ethernet8023 (@ethernet8023), Hermes Agent
license
MIT
platforms
linux, macos, windows

EVM Blockchain Skill

Query EVM-compatible blockchain data across 8 chains with USD pricing. 14 commands: wallet portfolio, token info, transactions, activity, gas tracker, network stats, price lookup, multi-chain scan, whale detection, ENS resolution, allowance checker, contract inspector, and transaction decoder.

Supports 8 chains: Ethereum, BNB Chain (BSC), Base, Arbitrum One, Polygon, Optimism, Avalanche (C-Chain), zkSync Era.

No API key needed. Zero external dependencies — Python standard library only (urllib, json, argparse, threading).

Supersedes the standalone base skill. Base-specific tokens (AERO, DEGEN, TOSHI, BRETT, WELL, cbETH, cbBTC, wstETH, rETH) and all Base RPC functionality previously living under optional-skills/blockchain/base/ have been folded into this skill. Pass --chain base to any command for Base coverage.


When to Use

  • User asks for a wallet balance or portfolio on any EVM chain
  • User wants to check the same wallet across ALL chains at once
  • User wants to inspect a transaction by hash (or decode what it did)
  • User wants ERC-20 token metadata, price, supply, or market cap
  • User wants recent transaction history for an address
  • User wants current gas prices or to compare fees across chains
  • User wants to find large whale transfers in recent blocks
  • User asks to resolve an ENS name (vitalik.eth) or reverse-lookup an address
  • User wants to check if a contract has dangerous token approvals
  • User wants to inspect a smart contract (proxy? ERC-20? ERC-721? bytecode size?)
  • User wants to compare gas costs across chains before a transaction

Prerequisites

Python 3.8+ standard library only. No pip installs required. Pricing: CoinGecko free API (rate-limited, ~10-30 req/min). ENS: ensideas.com public API. Tx decoding: 4byte.directory public API.

Override RPC endpoint: export EVM_RPC_URL=https://your-rpc.com

Helper script path: ~/.hermes/skills/blockchain/evm/scripts/evm_client.py


Quick Reference

SCRIPT=~/.hermes/skills/blockchain/evm/scripts/evm_client.py

# Network & prices
python $SCRIPT stats                            # Ethereum stats
python $SCRIPT stats --chain arbitrum           # Arbitrum stats
python $SCRIPT compare                          # Gas + prices ALL 8 chains

# Wallet
python $SCRIPT wallet 0xd8dA...96045            # Portfolio (ETH + ERC-20)
python $SCRIPT wallet 0xd8dA...96045 --chain bsc
python $SCRIPT multichain 0xd8dA...96045        # Same wallet on ALL chains

# Tokens & prices
python $SCRIPT price ETH
python $SCRIPT price 0xdAC1...1ec7              # By contract address
python $SCRIPT token 0xdAC1...1ec7              # ERC-20 metadata + market cap

# Transactions
python $SCRIPT tx 0x5c50...f060                 # Transaction details
python $SCRIPT decode 0x5c50...f060             # Decode input data (4byte.directory)
python $SCRIPT activity 0xd8dA...96045          # Recent transactions

# Gas
python $SCRIPT gas                              # Gas prices + cost estimates
python $SCRIPT gas --chain optimism

# Security
python $SCRIPT allowance 0xd8dA...96045         # Dangerous ERC-20 approvals
python $SCRIPT contract 0xdAC1...1ec7           # Contract inspection (proxy? standards?)

# ENS
python $SCRIPT ens vitalik.eth                  # Name -> address + profile
python $SCRIPT ens 0xd8dA...96045               # Address -> ENS name

# Whale detection
python $SCRIPT whale                            # Large transfers (last 20 blocks, >$10k)
python $SCRIPT whale --blocks 50 --min-usd 100000 --chain arbitrum

Procedure

0. Setup Check
bash
python --version   # 3.8+ required
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats
1. Wallet Portfolio

Native balance + known ERC-20 tokens, sorted by USD value.

bash
python $SCRIPT wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
python $SCRIPT wallet 0xd8dA... --chain bsc --no-prices   # faster
2. Multi-Chain Scan

Scans all 8 chains simultaneously for the same address using threads.

bash
python $SCRIPT multichain 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Output: per-chain native balance + token holdings + grand total USD.

3. Compare (Gas + Prices)

All 8 chains queried in parallel. Shows cheapest/most expensive chain.

bash
python $SCRIPT compare
4. Transaction Details & Decode
bash
python $SCRIPT tx 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060
python $SCRIPT decode 0x5c504ed...   # Shows human-readable function signature

Decode uses 4byte.directory to translate 0xa9059cbb -> transfer(address,uint256).

5. ENS Resolution
bash
python $SCRIPT ens vitalik.eth          # -> 0xd8dA... + avatar + social links
python $SCRIPT ens 0xd8dA...96045       # -> vitalik.eth
6. Allowance Checker (Security)

Checks ERC-20 approvals granted to known DEX/bridge contracts.

bash
python $SCRIPT allowance 0xYourWallet

Flags UNLIMITED approvals as HIGH risk.

7. Contract Inspector
bash
python $SCRIPT contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48   # USDC (proxy)
python $SCRIPT contract 0xdAC17F958D2ee523a2206206994597C13D831ec7   # USDT (ERC-20)

Detects: proxy (EIP-1967/EIP-1167), ERC-20, ERC-721, ERC-165. Shows bytecode size and implementation address for proxies.

8. Whale Detection
bash
python $SCRIPT whale                                    # ETH, last 20 blocks, >$10k
python $SCRIPT whale --blocks 50 --min-usd 50000 --chain bsc
Show full SKILL.md (256 more words)Show less
9. Gas Tracker
bash
python $SCRIPT gas
python $SCRIPT gas --chain polygon

Shows gwei price + USD cost for: transfer, ERC-20 transfer, approve, swap, NFT mint, NFT transfer.


Supported Chains

KeyNameNativeChain ID
ethereumEthereumETH1
bscBNB ChainBNB56
baseBaseETH8453
arbitrumArbitrum OneETH42161
polygonPolygonPOL137
optimismOptimismETH10
avalancheAvalanche CAVAX43114
zksynczkSync EraETH324

Pitfalls

  • CoinGecko free tier: ~10-30 req/min. Use --no-prices for faster wallet scans.
  • Public RPCs may throttle. Set EVM_RPC_URL to a private endpoint for production.
  • wallet and allowance only check known token list (~30 tokens per chain). Use a block explorer for complete token discovery.
  • activity scans recent blocks only (max 200). For full history, use Etherscan API.
  • multichain runs 8 parallel threads — can trigger rate limits on public RPCs.
  • ENS resolution depends on a single public endpoint (ensideas.com / ens.vitalik.ca) with no fallback. If that endpoint is down, ens will fail — re-run later or use a block explorer.
  • Tx decoding depends on a single public endpoint (4byte.directory) with no fallback. Selectors not in their database show up as unknown.
  • L2 gas estimates are L2-execution only. On rollups like Base, Arbitrum, Optimism, and zkSync, the actual transaction cost also includes an L1 data-posting fee that depends on calldata size and current L1 gas prices. The gas command does not estimate that L1 component. For Base specifically, see the network's L1 fee oracle (contract 0x420000000000000000000000000000000000000F).
  • Address / tx-hash inputs are validated for 0x-prefix + correct length + hex, but EIP-55 checksum casing is not enforced (RPC endpoints accept any-case hex).

Verification

bash
# Should print current block, gas price, ETH price
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py stats

# Should resolve vitalik.eth to 0xd8dA...
python ~/.hermes/skills/blockchain/evm/scripts/evm_client.py ens vitalik.eth

© Luciole-Studio, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in misaka/core/skills/assets/optional/blockchain/evm of Luciole-Studio/Misaka-Agent.

  • SKILL.md
  • scripts/evm_client.py

Open the folder on GitHubat commit b94464a

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in Luciole-Studio/Misaka-Agent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Evm 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.

Evm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Evm this skillLuciole-Studio/Misaka-Agent1392 repos~2.1kAutomated safety check: PassMIT
Deposit QrSuperior-Trade/superior-skills2141 repos~1.1kAutomated safety check: PassMIT
Explorer Contract Verificationsablier-labs/evm-monorepo353—~1.9kAutomated safety check: PassCustom licence
Developing Smart ContractsLFDT-Lineth/lineth-monorepo126—~1.4kAutomated safety check: PassAGPL-3.0
Squash BugbotLFDT-Lineth/lineth-monorepo126—~3.3kAutomated safety check: PassApache-2.0
Ops Indexer Queryboundless-xyz/boundless193—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    214 GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed
  • Explorer Contract Verification

    sablier-labs/evm-monorepo

    Verify smart contracts on Etherscan, Routescan, and Blockscout block explorers.

    353 GitHub stars~1.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Developing Smart Contracts

    LFDT-Lineth/lineth-monorepo

    Solidity smart contract development guidelines for Lineth blockchain.

    126 GitHub stars~1.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Squash Bugbot

    LFDT-Lineth/lineth-monorepo

    Triage unresolved bot review comments on a GitHub PR. An agent skill from LFDT-Lineth/lineth-monorepo.

    126 GitHub stars~3.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Ops Indexer Query

    boundless-xyz/boundless

    Internal — for Boundless team members only. An agent skill from boundless-xyz/boundless.

    193 GitHub stars~3.5k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • External Call Safety

    quillai-network/quillshield_skills

    Detects unsafe external call patterns and token integration vulnerabilities in smart contracts.

    129 GitHub stars~3.1k tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed

More from Luciole-Studio/Misaka-Agent

All 76 skills in this repo
  • Kanban Video Orchestrator

    Luciole-Studio/Misaka-Agent

    Plan and run multi-agent video production pipelines. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 2 repos~2.4k tokens
    Auto-check: notes
  • Ast Grep

    Luciole-Studio/Misaka-Agent

    AST-aware structural code search and rewrite via ast-grep. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Drug Discovery

    Luciole-Studio/Misaka-Agent

    Drug discovery: ChEMBL search, drug-likeness, interactions. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Fitness Nutrition

    Luciole-Studio/Misaka-Agent

    Workout planning, macros, and body metrics via wger/USDA. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Hyperframes

    Luciole-Studio/Misaka-Agent

    Render MP4/WebM videos from HTML compositions. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check passed
  • Osint Investigation

    Luciole-Studio/Misaka-Agent

    Follow the money via public records and sanctions data. An agent skill from Luciole-Studio/Misaka-Agent.

    139 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed

Works with

Categories

Questions about Evm

What does Evm do?

Read-only EVM client: wallets, tokens, gas across 8 chains. An agent skill from Luciole-Studio/Misaka-Agent. Evm is an agent skill from Luciole-Studio/Misaka-Agent. Read-only EVM client: wallets, tokens, gas across 8 chains.

When should I use Evm?

Evm fits situations like: tasks that involve Smart contracts.

How do I install Evm in Claude Code?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill evm -a claude-code`. Or copy the skill folder (misaka/core/skills/assets/optional/blockchain/evm in Luciole-Studio/Misaka-Agent) into .claude/skills/evm in your project. Claude Code loads it when a task matches its description.

How do I install Evm in Codex?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill evm -a codex`. Or copy the skill folder (misaka/core/skills/assets/optional/blockchain/evm in Luciole-Studio/Misaka-Agent) into .agents/skills/evm in your project. Codex loads it when a task matches its description.

Can I use Evm 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 Luciole-Studio/Misaka-Agent --skill evm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/evm, .gemini/skills/evm, .github/skills/evm and .opencode/skills/evm in your project.

What does Evm need to run?

Going by SKILL.md and its folder, Evm needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Evm access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Evm 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Evm use?

Evm 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 Evm use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Evm?

Skills that share tags, products or a category with Evm: Deposit Qr (Superior-Trade/superior-skills, 214 stars), Explorer Contract Verification (sablier-labs/evm-monorepo, 353 stars), Developing Smart Contracts (LFDT-Lineth/lineth-monorepo, 126 stars) and Squash Bugbot (LFDT-Lineth/lineth-monorepo, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Evm?

Luciole-Studio (a GitHub organization) maintains it in Luciole-Studio/Misaka-Agent, which has 139 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on October 8, 2026.

Source: Luciole-Studio/Misaka-Agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.