internal/embed/skills/agent-factory/SKILL.md
Spawn durable child Hermes agents from inside Obol Stack. Creates child namespaces, optional profile/env Secrets, Agent CRDs, and optional ServiceOffers for x402-paid child services.
npx skillsauth add obolnetwork/obol-stack agent-factoryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create durable child Hermes agents from a permissioned mother agent.
Use this when the user wants a separate long-lived service agent with isolated Kubernetes namespace, PVC-backed Hermes state, optional child wallet, optional injected environment secrets, and optional x402 ServiceOffer.
python3 scripts/factory.py create medical-advisor \
--model antangelmed \
--skills medical-safety,privacy-filter,citations \
--objective "Answer medical education questions with emergency escalation and no diagnosis." \
--create-wallet \
--price 0.05 \
--pay-to 0xYourProviderWallet \
--network base-sepolia \
--register-name "Medical Advisor"
| Command | Description |
|---------|-------------|
| create <name> | Create/update namespace, profile seed, optional env Secret, Agent CR, and optional ServiceOffer |
| status <name> | Show Agent and ServiceOffer readiness |
| list | List child Agent CRs across namespaces |
| delete <name> | Delete the child ServiceOffer only. Agent/runtime deletion remains an operator action for now |
/data/.hermes.hermes-profile-seed and contains profile.tar.gz.hermes-env Secret.data-ai
Buy from any x402-gated endpoint. Two flows: `pay` for one-shot HTTP services (single authorization, no sidecar), and `buy` for long-running paid inference (pre-authorized batch via PurchaseRequest, exposed as `paid/<remote-model>`). Supports USDC (EIP-3009) and OBOL (Permit2). Zero signer access at runtime — spending is capped by design and nothing moves on-chain until a voucher is spent.
testing
Sell access to services via x402 payment gating. Create ServiceOffer CRDs that automatically health-check upstreams, create payment-gated routes, and optionally pull models and register on ERC-8004. Supports inference, HTTP, and fine-tuning service types.
testing
End-to-end guide for monetizing GPU resources or HTTP services through obol-stack. Covers pre-flight checks, model detection, pricing research, selling via x402, ERC-8004 registration, and verification. Use this skill when the user wants to monetize their machine.
databases
Query Ethereum networks through the local RPC gateway. Use when asked about blocks, balances, transactions, gas prices, token balances, or any eth_* JSON-RPC method. All queries are read-only and routed through the in-cluster eRPC load balancer.