cross-explorer
A Claude Code skill that drives the CROSS Chain block explorer read-only:
talks to the Blockscout v2 API hosted at https://www.crossscan.io
(mainnet, chainId 612055) and https://testnet.crossscan.io (testnet,
chainId 612044), and emits deep links into the
https://explorer.crosstoken.io UI.
Read-only skill — no PRIVATE_KEY ever required, no on-chain calls.
- Stack: Node.js ≥ 20, zero npm dependencies (uses the built-in
fetch + WHATWG URL only)
- Backend: Blockscout v2 API at
crossscan.io
- UI: deep links into
explorer.crosstoken.io/{chainId}/{kind}/{id}
- Subcommands:
stats, latest, block, tx, address, contract,
token, search, parse-url
- Distribution: standalone Claude skill and wrapped as a Claude Code
plugin
Install — Recommended (via Marketplace)
/plugin marketplace add github.com/to-nexus/cross-skills-suite
/plugin install cross-explorer@cross-skills-suite
Part of the CROSS Skills Suite —
installs alongside cross-crossd, cross-rewards, cross-dex-trade,
cross-prediction.
Install — Standalone
git clone <this-repo> /tmp/skill-cross-explorer
bash /tmp/skill-cross-explorer/install.sh
The installer symlinks skills/cross-explorer/ into
$HOME/.claude/skills/cross-explorer/ and runs a (no-op) npm install to
prove the Node toolchain is wired. The skill itself has zero runtime
dependencies, so a missing/blocked npm install is non-fatal.
Manual alternative:
cp -r skills/cross-explorer ~/.claude/skills/
Configuration
This skill does not require a private key, wallet address, or .env
file. Optional knobs (only needed for testnet or self-hosted Blockscout):
| Variable | Default | Notes |
|---|
EXPLORER_NETWORK | mainnet | mainnet or testnet |
MAINNET_BASE_URL | https://www.crossscan.io | Override for mirrors |
TESTNET_BASE_URL | https://testnet.crossscan.io | Override for mirrors |
DEBUG | unset | Set to 1 for verbose stderr |
Quick start
Inside Claude Code, just describe the action in plain language:
- "CROSS chain stats"
- "look up tx
0xb4faf...72fd on crossscan"
- "block 32388665 details with txs"
- "address
0x0A57…aecD balance and recent transfers"
Direct CLI:
cd ~/.claude/skills/cross-explorer
node scripts/stats.mjs
node scripts/latest.mjs
node scripts/block.mjs 32388665 --with-txs
node scripts/tx.mjs 0xb4faf72fd... --include logs,transfers
node scripts/parse-url.mjs https://explorer.crosstoken.io/612055/tx/0xb4faf...
All commands emit a single JSON envelope on stdout.
Documentation
License
MIT — read the disclaimer at the bottom of the LICENSE file. This
skill is read-only and never holds funds, but it can return stale or
upstream-degraded data; treat the output as informational, not as a
substitute for an authoritative on-chain query.
