Agent skill

Base

by Tommy-yw in Tommy-yw/RunbookHermes

Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats.

MITAuto-check passed

Install Base

skills CLI
$ npx skills add Tommy-yw/RunbookHermes --skill base -a claude-code

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

GitHub CLI
$ gh skill install Tommy-yw/RunbookHermes base --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/Tommy-yw/RunbookHermes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/optional-skills/blockchain/base .claude/skills/base && 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
base
GitHub stars
546
Token cost
~1.9k tokens
SKILL.md length
760 words
Files
2 (incl. scripts)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats.

  • Works in 9 steps: Setup Check → Wallet Portfolio → Transaction Details → …
  • SKILL.md covers When to Use, Prerequisites, Quick Reference and Procedure, plus 2 more sections
  • Runs Python scripts from its folder; calls python3; reaches mainnet.base.org

What it does

Base is an agent skill from Tommy-yw/RunbookHermes. Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats. Uses Base RPC + CoinGecko. No API key required.

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

It works with Ethereum. The repository describes itself as: Hermes-native AIOps agent for evidence-driven incident response, approval-gated remediation, and runbook learning. The licence is MIT.

Example prompts

  • “/base”

Requirements

  • Python 3

Workflow steps

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

  1. Setup Check
  2. Wallet Portfolio
  3. Transaction Details
  4. Token Info
  5. Gas Analysis
  6. Contract Inspection
  7. Whale Detector
  8. Network Stats
  9. Price Lookup

What it can do on your machine

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

    • python3

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mainnet.base.org

    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

Base loads about 1.9k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 760 words of instructions outside code blocks.

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

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 Tommy-yw/RunbookHermes at commit 7fd2b9a, republished under its MIT licence (© Tommy-yw). 760 words, ~1,946 tokens.

Download SKILL.mdSave it as .claude/skills/base/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
base
description
Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats. Uses Base RPC + CoinGecko. No API key required.
version
0.1.0
author
youssefea
license
MIT

Base Blockchain Skill

Query Base (Ethereum L2) on-chain data enriched with USD pricing via CoinGecko. 8 commands: wallet portfolio, token info, transactions, gas analysis, contract inspection, whale detection, network stats, and price lookup.

No API key needed. Uses only Python standard library (urllib, json, argparse).


When to Use

  • User asks for a Base wallet balance, token holdings, or portfolio value
  • User wants to inspect a specific transaction by hash
  • User wants ERC-20 token metadata, price, supply, or market cap
  • User wants to understand Base gas costs and L1 data fees
  • User wants to inspect a contract (ERC type detection, proxy resolution)
  • User wants to find large ETH transfers (whale detection)
  • User wants Base network health, gas price, or ETH price
  • User asks "what's the price of USDC/AERO/DEGEN/ETH?"

Prerequisites

The helper script uses only Python standard library (urllib, json, argparse). No external packages required.

Pricing data comes from CoinGecko's free API (no key needed, rate-limited to ~10-30 requests/minute). For faster lookups, use --no-prices flag.


Quick Reference

RPC endpoint (default): https://mainnet.base.org Override: export BASE_RPC_URL=https://your-private-rpc.com

Helper script path: ~/.hermes/skills/blockchain/base/scripts/base_client.py

python3 base_client.py wallet   <address> [--limit N] [--all] [--no-prices]
python3 base_client.py tx       <hash>
python3 base_client.py token    <contract_address>
python3 base_client.py gas
python3 base_client.py contract <address>
python3 base_client.py whales   [--min-eth N]
python3 base_client.py stats
python3 base_client.py price    <contract_address_or_symbol>

Procedure

0. Setup Check
bash
python3 --version

# Optional: set a private RPC for better rate limits
export BASE_RPC_URL="https://mainnet.base.org"

# Confirm connectivity
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats
1. Wallet Portfolio

Get ETH balance and ERC-20 token holdings with USD values. Checks ~15 well-known Base tokens (USDC, WETH, AERO, DEGEN, etc.) via on-chain balanceOf calls. Tokens sorted by value, dust filtered.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Flags:

  • --limit N — show top N tokens (default: 20)
  • --all — show all tokens, no dust filter, no limit
  • --no-prices — skip CoinGecko price lookups (faster, RPC-only)

Output includes: ETH balance + USD value, token list with prices sorted by value, dust count, total portfolio value in USD.

Note: Only checks known tokens. Unknown ERC-20s are not discovered. Use the token command with a specific contract address for any token.

2. Transaction Details

Inspect a full transaction by its hash. Shows ETH value transferred, gas used, fee in ETH/USD, status, and decoded ERC-20/ERC-721 transfers.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  tx 0xabc123...your_tx_hash_here

Output: hash, block, from, to, value (ETH + USD), gas price, gas used, fee, status, contract creation address (if any), token transfers.

3. Token Info

Get ERC-20 token metadata: name, symbol, decimals, total supply, price, market cap, and contract code size.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Output: name, symbol, decimals, total supply, price, market cap. Reads name/symbol/decimals directly from the contract via eth_call.

4. Gas Analysis

Detailed gas analysis with cost estimates for common operations. Shows current gas price, base fee trends over 10 blocks, block utilization, and estimated costs for ETH transfers, ERC-20 transfers, and swaps.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py gas

Output: current gas price, base fee, block utilization, 10-block trend, cost estimates in ETH and USD.

Note: Base is an L2 — actual transaction costs include an L1 data posting fee that depends on calldata size and L1 gas prices. The estimates shown are for L2 execution only.

Show full SKILL.md (318 more words)Show less
5. Contract Inspection

Inspect an address: determine if it's an EOA or contract, detect ERC-20/ERC-721/ERC-1155 interfaces, resolve EIP-1967 proxy implementation addresses.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Output: is_contract, code size, ETH balance, detected interfaces (ERC-20, ERC-721, ERC-1155), ERC-20 metadata, proxy implementation address.

6. Whale Detector

Scan the most recent block for large ETH transfers with USD values.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py \
  whales --min-eth 1.0

Note: scans the latest block only — point-in-time snapshot, not historical. Default threshold is 1.0 ETH (lower than Solana's default since ETH values are higher).

7. Network Stats

Live Base network health: latest block, chain ID, gas price, base fee, block utilization, transaction count, and ETH price.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats
8. Price Lookup

Quick price check for any token by contract address or known symbol.

bash
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price ETH
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price USDC
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price AERO
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price DEGEN
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py price 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Known symbols: ETH, WETH, USDC, cbETH, AERO, DEGEN, TOSHI, BRETT, WELL, wstETH, rETH, cbBTC.


Pitfalls

  • CoinGecko rate-limits — free tier allows ~10-30 requests/minute. Price lookups use 1 request per token. Use --no-prices for speed.
  • Public RPC rate-limits — Base's public RPC limits requests. For production use, set BASE_RPC_URL to a private endpoint (Alchemy, QuickNode, Infura).
  • Wallet shows known tokens only — unlike Solana, EVM chains have no built-in "get all tokens" RPC. The wallet command checks ~15 popular Base tokens via balanceOf. Unknown ERC-20s won't appear. Use the token command for any specific contract.
  • Token names read from contract — if a contract doesn't implement name() or symbol(), these fields may be empty. Known tokens have hardcoded labels as fallback.
  • Gas estimates are L2 only — Base transaction costs include an L1 data posting fee (depends on calldata size and L1 gas prices). The gas command estimates L2 execution cost only.
  • Whale detector scans latest block only — not historical. Results vary by the moment you query. Default threshold is 1.0 ETH.
  • Proxy detection — only EIP-1967 proxies are detected. Other proxy patterns (EIP-1167 minimal proxy, custom storage slots) are not checked.
  • Retry on 429 — both RPC and CoinGecko calls retry up to 2 times with exponential backoff on rate-limit errors.

Verification

bash
# Should print Base chain ID (8453), latest block, gas price, and ETH price
python3 ~/.hermes/skills/blockchain/base/scripts/base_client.py stats

© Tommy-yw, 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 optional-skills/blockchain/base of Tommy-yw/RunbookHermes.

  • SKILL.md
  • scripts/base_client.py

Open the folder on GitHubat commit 7fd2b9a

Compare with similar skills

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

Base compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Base this skillTommy-yw/RunbookHermes546—~1.9kAutomated safety check: PassMIT
Wagmi Feature Developmentwevm/wagmi6.8k—~3.8kAutomated safety check: PassMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills3581 repos~5.7kAutomated safety check: PassNone
Release Roundethereumjs/ethereumjs-monorepo2.8k—~2kAutomated safety check: PassNone
NEAR Intents Swap Integrationinternet-court/internet-court-skill6.4k2 repos~939Automated safety check: PassCustom licence
Update Est Fixturesethereumjs/ethereumjs-monorepo2.8k—~3.3kAutomated safety check: PassNone

Similar skills

  • Walks through adding a Wagmi feature across its layers: a Viem-based core action, TanStack Query options, and React and Vue bindings.

    6.8k GitHub stars~3.8k tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    358 GitHub starsUsed in 1 repo~5.7k tokens
    Business, Finance & HRAuto-check passed
  • Release Round

    ethereumjs/ethereumjs-monorepo

    Runs a coordinated EthereumJS npm release round in six human-gated phases — intent and readiness, CHANGELOG, version bump, publish (human executes), post-publish verification, and announcements.

    2.8k GitHub stars~2k tokensUpdated 20 days ago
    DevelopmentAuto-check passed
  • NEAR Intents Swap Integration

    internet-court/internet-court-skill

    Builds cross-chain token swaps and bridge flows with the NEAR Intents 1Click API: quotes, deposit addresses, per-chain deposits and status polling.

    6.4k GitHub starsUsed in 2 repos~939 tokens
    Backend & APIsAuto-check passed
  • Update Est Fixtures

    ethereumjs/ethereumjs-monorepo

    Updates EthereumJS execution-spec test fixtures from an ethereum/execution-specs release, then (after a human merge) points the monorepo submodule, updates VM npm scripts, reports a first test run…

    2.8k GitHub stars~3.3k tokensUpdated 20 days ago
    DevelopmentAuto-check passed
  • Swapper Deposit

    swapperfinance/swapper-toolkit

    Deposit and bridge funds into a wallet or protocol using Swapper Finance.

    852 GitHub stars~1.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed

More from Tommy-yw/RunbookHermes

All 38 skills in this repo
  • Fastmcp

    Tommy-yw/RunbookHermes

    Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

    546 GitHub starsUsed in 4 repos~2.1k tokens
    Auto-check passed
  • Drug Discovery

    Tommy-yw/RunbookHermes

    Pharmaceutical research assistant for drug discovery workflows.

    546 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Youtube Content

    Tommy-yw/RunbookHermes

    Fetch YouTube video transcripts and transform them into structured content (chapters, summaries, threads, blog posts).

    546 GitHub starsUsed in 1 repo~785 tokens
    Auto-check passed
  • Oss Forensics

    Tommy-yw/RunbookHermes

    Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories.

    546 GitHub starsUsed in 3 repos~5k tokens
    Auto-check passed
  • P5js

    Tommy-yw/RunbookHermes

    Production pipeline for interactive and generative visual art using p5.js.

    546 GitHub starsUsed in 1 repo~6.8k tokens
    Auto-check passed
  • 1password

    Tommy-yw/RunbookHermes

    Set up and use 1Password CLI (op). An agent skill from Tommy-yw/RunbookHermes.

    546 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check: notes

Works with

Questions about Base

What does Base do?

Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats. Base is an agent skill from Tommy-yw/RunbookHermes. Query Base (Ethereum L2) blockchain data with USD pricing — wallet balances, token info, transaction details, gas analysis, contract inspection, whale detection, and live network stats.

How do I install Base in Claude Code?

Run `npx skills add Tommy-yw/RunbookHermes --skill base -a claude-code`. Or copy the skill folder (optional-skills/blockchain/base in Tommy-yw/RunbookHermes) into .claude/skills/base in your project. Claude Code loads it when a task matches its description.

How do I install Base in Codex?

Run `npx skills add Tommy-yw/RunbookHermes --skill base -a codex`. Or copy the skill folder (optional-skills/blockchain/base in Tommy-yw/RunbookHermes) into .agents/skills/base in your project. Codex loads it when a task matches its description.

Can I use Base 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 Tommy-yw/RunbookHermes --skill base -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/base, .gemini/skills/base, .github/skills/base and .opencode/skills/base in your project.

What does Base need to run?

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

Does Base access the network?

SKILL.md names 1 domain. In commands or code: mainnet.base.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Base 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 Base use?

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

About 1.9k tokens (SKILL.md is roughly 7.8k 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 Base?

Skills that share tags, products or a category with Base: Wagmi Feature Development (wevm/wagmi, 6.8k stars), Minara Crypto Trading and Wallet (Minara-AI/minara-skills, 358 stars), Release Round (ethereumjs/ethereumjs-monorepo, 2.8k stars) and NEAR Intents Swap Integration (internet-court/internet-court-skill, 6.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Base?

Tommy-yw (a GitHub user) maintains it in Tommy-yw/RunbookHermes, which has 546 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on May 18, 2026.

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