Update skills for agents onchain

CLAUDE.md

@@ -778,14 +778,51 @@ Skills are delivered by writing directly to the host filesystem at `$DATA_DIR/op
 
 **Advantages over ConfigMap approach**: No 1MB size limit, works before pod readiness, survives pod restarts, supports binary files and scripts.
 
-### Default Skills
+### Default Skills (22 skills)
+
+The stack ships 22 embedded skills organized into categories. All are installed automatically on first deploy.
+
+#### Infrastructure Skills
+
+| Skill | Contents | Purpose |
+|-------|----------|---------|
+| `ethereum-networks` | `SKILL.md`, `scripts/rpc.sh`, `scripts/rpc.py`, `references/erc20-methods.md`, `references/common-contracts.md` | Read-only Ethereum queries via cast/eRPC — blocks, balances, contract reads, ERC-20 lookups, ENS resolution |
+| `local-ethereum-wallet` | `SKILL.md`, `scripts/signer.py`, `scripts/tx-helper.sh`, `references/web3signer-api.md` | Sign and send transactions via Web3Signer — ETH transfers, contract calls, EIP-712 typed data |
+| `obol-stack` | `SKILL.md`, `scripts/kube.py` | Kubernetes cluster diagnostics — pods, logs, events, deployments via ServiceAccount API |
+| `distributed-validators` | `SKILL.md`, `references/api-examples.md` | Obol DVT cluster monitoring, operator audit, exit coordination via Obol API |
+
+#### Agent Identity & Commerce Skills
+
+| Skill | Contents | Purpose |
+|-------|----------|---------|
+| `agent-identity` | `SKILL.md`, `scripts/identity.sh`, `references/erc8004-methods.md`, `references/abis/{Identity,Reputation,Validation}Registry.json` | Full ERC-8004 lifecycle — register, update URI/metadata, give/query reputation, request validation, pin to IPFS. Wraps cast + signer.py |
+| `standards` | `SKILL.md` | ERC-8004, x402, EIP-3009, EIP-7702, ERC-4337 — spec details, integration patterns, cast-based examples |
+| `orchestration` | `SKILL.md` | End-to-end dApp build (SE2) + AI agent commerce cycle (ERC-8004 + x402 discover → trust → pay → rate) |
+| `ship` | `SKILL.md` | Architecture planning — what goes onchain vs offchain, contract count, chain selection, agent service patterns |
+
+#### Ethereum Development Skills
+
+| Skill | Contents | Purpose |
+|-------|----------|---------|
+| `addresses` | `SKILL.md` | Verified contract addresses — DeFi, tokens, bridges, ERC-8004 registries across all major chains |
+| `building-blocks` | `SKILL.md` | OpenZeppelin patterns, DEX integration, oracle usage, access control |
+| `concepts` | `SKILL.md` | Mental model — state machines, incentive design, gas mechanics, EOAs vs contracts |
+| `gas` | `SKILL.md` | Gas optimization patterns, L2 fee structures, estimation |
+| `indexing` | `SKILL.md` | The Graph, Dune, event indexing for onchain data |
+| `l2s` | `SKILL.md` | L2 comparison — Base, Arbitrum, Optimism, zkSync with gas costs and use cases |
+| `security` | `SKILL.md` | Smart contract vulnerability patterns, reentrancy, flash loans, MEV protection |
+| `testing` | `SKILL.md` | Foundry testing — unit, fuzz, fork, invariant tests |
+| `tools` | `SKILL.md` | Development tooling — Foundry, Hardhat, Scaffold-ETH 2, verification |
+| `wallets` | `SKILL.md` | Wallet management — EOAs, Safe multisig, EIP-7702, key safety for AI agents |
+
+#### Frontend & UX Skills
 
 | Skill | Contents | Purpose |
 |-------|----------|---------|
-| `hello` | `SKILL.md` | Smoke test — confirms skills pipeline works |
-| `obol-blockchain` | `SKILL.md`, `scripts/rpc.py`, `references/erc20-methods.md`, `references/common-contracts.md` | Ethereum JSON-RPC queries, ERC-20 token ops, ENS resolution, gas estimation via the eRPC gateway |
-| `obol-k8s` | `SKILL.md`, `scripts/kube.py` | Kubernetes cluster diagnostics — pods, logs, events, deployments via ServiceAccount API |
-| `obol-dvt` | `SKILL.md`, `references/api-examples.md` | Obol DVT cluster monitoring, operator audit, exit coordination via Obol API |
+| `frontend-playbook` | `SKILL.md` | Frontend deployment — IPFS, Vercel, ENS subdomains |
+| `frontend-ux` | `SKILL.md` | Web3 UX patterns — wallet connection, transaction flows, error handling |
+| `qa` | `SKILL.md` | Quality assurance — testing strategy, coverage, CI/CD patterns |
+| `why` | `SKILL.md` | Why build on Ethereum — the AI agent angle with ERC-8004 and x402 |
 
 ### Skill Delivery Flow
 
@@ -1089,14 +1126,18 @@ obol network delete ethereum-<generated-name> --force
   - `aztec/helmfile.yaml.gotmpl`
 - `internal/embed/defaults/` - Default stack resources
 - `internal/embed/infrastructure/` - Infrastructure resources (llmspy, Traefik)
-- `internal/embed/skills/` - Default OpenClaw skills (hello, obol-blockchain, obol-k8s, obol-dvt) embedded in obol binary
+- `internal/embed/skills/` - 22 embedded OpenClaw skills (SKILL.md files + scripts + references)
 
-**Skills system**:
+**Skills system (key files)**:
 - `internal/openclaw/resolve.go` - Smart instance resolution (0/1/2+ instances)
-- `internal/embed/skills/hello/SKILL.md` - Hello world smoke-test skill
-- `internal/embed/skills/obol-blockchain/` - Ethereum JSON-RPC, ERC-20, ENS via eRPC (SKILL.md + scripts/rpc.py + references/)
-- `internal/embed/skills/obol-k8s/` - Kubernetes cluster diagnostics (SKILL.md + scripts/kube.py)
-- `internal/embed/skills/obol-dvt/` - DVT cluster monitoring via Obol API (SKILL.md + references/api-examples.md)
+- `internal/embed/skills/agent-identity/` - ERC-8004 lifecycle (SKILL.md + scripts/identity.sh + references/abis/ + references/erc8004-methods.md)
+- `internal/embed/skills/ethereum-networks/` - Read-only blockchain queries via cast/eRPC (SKILL.md + scripts/rpc.sh + scripts/rpc.py + references/)
+- `internal/embed/skills/local-ethereum-wallet/` - Transaction signing via Web3Signer (SKILL.md + scripts/signer.py + scripts/tx-helper.sh + references/)
+- `internal/embed/skills/obol-stack/` - Kubernetes cluster diagnostics (SKILL.md + scripts/kube.py)
+- `internal/embed/skills/distributed-validators/` - DVT cluster monitoring via Obol API (SKILL.md + references/api-examples.md)
+- `internal/embed/skills/standards/` - ERC-8004, x402, EIP-3009, EIP-7702 spec reference
+- `internal/embed/skills/orchestration/` - dApp build system + agent commerce cycle
+- `internal/embed/skills/addresses/` - Verified contract addresses across chains
 - `internal/embed/embed_skills_test.go` - Unit tests for skill embedding
 - `internal/openclaw/skills_injection_test.go` - Unit tests for skill staging and injection
 - `tests/skills_smoke_test.py` - In-pod Python smoke tests for all rich skills

README.md

@@ -163,14 +163,49 @@ When only one OpenClaw instance is installed, the instance ID is optional — it
 
 ### Skills
 
-OpenClaw ships with four embedded skills that are installed automatically on first deploy:
+OpenClaw ships with 22 embedded skills that are installed automatically on first deploy. Skills give the agent domain-specific capabilities — from querying blockchains to registering onchain identities.
+
+#### Infrastructure
+
+| Skill | Purpose |
+|-------|---------|
+| `ethereum-networks` | Read-only Ethereum queries via cast — blocks, balances, contract reads, ERC-20, ENS |
+| `local-ethereum-wallet` | Sign and send transactions via Web3Signer — ETH transfers, contract calls, EIP-712 |
+| `obol-stack` | Kubernetes cluster diagnostics — pods, logs, events, deployments |
+| `distributed-validators` | Obol DVT cluster monitoring, operator audit, exit coordination |
+
+#### Agent Identity & Commerce
+
+| Skill | Purpose |
+|-------|---------|
+| `agent-identity` | **ERC-8004 lifecycle** — register, update URI/metadata, give/query reputation, request validation, IPFS pinning. Full ABIs included |
+| `standards` | ERC-8004, x402, EIP-3009, EIP-7702 — specs, integration patterns, cast-based examples |
+| `orchestration` | dApp build system + AI agent commerce cycle (ERC-8004 discover → trust → pay → rate) |
+| `ship` | Architecture planning — onchain vs offchain, contract count, chain selection, agent service setup |
+
+#### Ethereum Development
+
+| Skill | Purpose |
+|-------|---------|
+| `addresses` | Verified contract addresses — DeFi, tokens, bridges, ERC-8004 registries across chains |
+| `building-blocks` | OpenZeppelin patterns, DEX integration, oracles, access control |
+| `concepts` | Mental model — state machines, incentives, gas, EOAs vs contracts |
+| `gas` | Gas optimization, L2 fee structures |
+| `indexing` | The Graph, Dune, event indexing |
+| `l2s` | L2 comparison — Base, Arbitrum, Optimism, zkSync |
+| `security` | Vulnerability patterns, reentrancy, flash loans, MEV |
+| `testing` | Foundry testing — unit, fuzz, fork, invariant |
+| `tools` | Foundry, Hardhat, Scaffold-ETH 2 |
+| `wallets` | EOAs, Safe multisig, EIP-7702, key safety for AI agents |
+
+#### Frontend & QA
 
 | Skill | Purpose |
 |-------|---------|
-| `hello` | Smoke test — confirms skills pipeline works |
-| `obol-blockchain` | Ethereum JSON-RPC queries, ERC-20 token ops, ENS resolution via the eRPC gateway |
-| `obol-k8s` | Kubernetes cluster diagnostics — pods, logs, events, deployments |
-| `obol-dvt` | Obol DVT cluster monitoring, operator audit, exit coordination |
+| `frontend-playbook` | Deployment — IPFS, Vercel, ENS subdomains |
+| `frontend-ux` | Web3 UX — wallet flows, transaction states, error handling |
+| `qa` | Testing strategy, coverage, CI/CD |
+| `why` | Why Ethereum — the AI agent angle with ERC-8004 and x402 |
 
 Manage skills at runtime:
 

internal/embed/skills/addresses/SKILL.md

@@ -549,9 +549,12 @@ Source: [docs.morpho.org](https://docs.morpho.org/get-started/resources/addresse
 |----------|---------|--------|
 | IdentityRegistry | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | ✅ Verified |
 | ReputationRegistry | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` | ✅ Verified |
+| ValidationRegistry | Same CREATE2 pattern — set via `ERC8004_VALIDATION_REGISTRY` env var | ⏳ Deploying |
 
 Verified on: Mainnet, Arbitrum, Base, Optimism (CREATE2 — same address on all chains).
 
+See `agent-identity/references/erc8004-methods.md` for the full function reference and `agent-identity/references/abis/` for JSON ABIs.
+
 ---
 
 ## Major Tokens (Mainnet)