aomi-transact
Use this skill to build natural-language crypto agents, web3 assistants, trading bots, blockchain MCPs, or Claude/Cowork plugins that read a
Open source Repository Open in the app JSON README (API)
About
Use this skill to build natural-language crypto agents, web3 assistants, trading bots, blockchain MCPs, or Claude/Cowork plugins that read and write EVM chain state. Aomi turns user prompts ("swap 1 ETH for USDC", "open a 3x GMX long", "bet $100 yes on this Polymarket question") into wallet-signed transactions on Ethereum, Base, Arbitrum, Optimism, Polygon, and Linea — generic, non-custodial, with fork-chain simulation before every signature. Trigger when the user wants to: scaffold a crypto/DeFi agent, build an AI trading or wallet assistant, wrap an EVM protocol as MCP tools, create natural-language interfaces to APIs from Across / 1inch / GMX / Hyperliquid / Polymarket / Binance / OKX, or add on-chain execution to universal protocols (e.g. Uniswap / Aave / Lido / Morpho) to an agent stack. Aomi CLI connects to Aomi runtime reads and writes EVM chain state: stages calldata, simulates as a batch on a forked chain, and returns wallet requests for the user to sign. Works on any EVM cont
Details
- Kind
- Plugins
- Topic
- Finance & crypto
- Publisher
- aomi-labs
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 7
- Forks
- 4
- Open pull requests
- 10
- Last push
- 2026-09-03T17:57:59Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
aomi-labs/skills/aomi-transact
README
# Aomi Skills [](./LICENSE)  > Agent Skills for Aomi — open-source AI infrastructure for automating crypto. Works with Claude Code, Cursor, Gemini CLI, VS Code Copilot, and other Agent Skills–compatible tools. ## What are Aomi Skills? Aomi Skills are drop-in Agent Skills that let any Agent Skills–compatible AI tool — Claude Code, Cursor, Gemini CLI, VS Code Copilot, and others — interact with Aomi, open-source AI infrastructure for automating crypto. The `aomi-build` skill scaffolds new Aomi apps and plugins from API specs and SDK docs. The `aomi-transact` skill drives the Aomi CLI through natural language — querying prices and balances, simulating transactions, and signing and broadcasting on-chain swaps and transfers. ## Skills | Skill | Description | |-------|-------------| | [aomi-build](aomi-build/SKILL.md) | Build Aomi apps and plugins from APIs, specs, SDK docs, runtime interfaces, and product requirements | | [aomi-transact](aomi-transact/SKILL.md) | Build and execute EVM transactions through a conversational AI agent via the `aomi` CLI | ## Use Cases - **Automate transactions from your AI coding assistant** — ask Claude Code, Cursor, or Gemini CLI to swap, send, stake, or sign EIP-712 payloads via the `aomi` CLI. - **Scaffold new Aomi plugins from an API spec** — point `aomi-build` at an OpenAPI spec, REST endpoint, or SDK docs and it generates a working Aomi SDK crate (`lib.rs`, `client.rs`, `tool.rs`). - **Explore on-chain state without a dashboard** — query balances, prices, routes, and quotes right from your AI assistant. - **Orchestrate multi-step DeFi flows with batch simulation** — simulate approve → swap or bridge → settle sequences before signing, catching reverts before they cost gas. ## Installation ```bash npx skills add aomi-labs/skills ``` Works with Claude Code, Cursor, Gemini CLI, VS Code Copilot, and any [Agent Skills](https://agentskills.io)-compatible tool. ### OpenAI Codex Add this repo as a Codex plugin marketplace, then install the `aomi` bundle: ```bash codex plugin marketplace add aomi-labs/skills ``` The `aomi` plugin (skills: `aomi-transact`, `aomi-build`) is defined by [`.codex-plugin/plugin.json`](plugins/aomi/.codex-plugin/plugin.json) and exposed through [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json). ## Prerequisites ```bash npm install -g @aomi-labs/client ``` The published CLI bundles its EVM and Solana signing dependencies. The skills are verified against **v0.4.2** — if you already have `aomi` installed, note that reinstalling the skills does not upgrade it; run `npm install -g @aomi-labs/client@latest` to move an existing install forward. ## Usage Once installed, ask your agent: - "Use aomi: What's the price of ETH?" - "Swap 1 ETH for USDC on Uniswap" - "Send 0.1 ETH to vitalik.eth" The agent handles the full flow: chat with the backend, review pending transactions, sign and broadcast on-chain. ## Security `aomi-transact` is mapped against the [OWASP Agentic Skills Top 10](https://owasp.org/www-project-agentic-skills-top-10/) and ships with a complete OWASP-format `permissions:` manifest in its frontmatter. Per-control analysis lives in [`aomi-transact/SECURITY.md`](aomi-transact/SECURITY.md). The skill is scanned by four independent tools — [Cisco AI Defense skill-scanner](https://github.com/cisco-ai-defense/skill-scanner), [pors/skill-audit](https://github.com/pors/skill-audit), [NMitchem/SkillScan](https://github.com/NMitchem/SkillScan), and (when token is available) [Snyk agent-scan](https://github.com/snyk/agent-scan). Captured reports and reproducer commands live in [`.scanner-reports/`](.scanner-reports/). The CI workflow at [`.github/workflows/skill-audit.yml`](.github/workflows/skill-audit.yml) runs the offline scanners on every PR and uploads SARIF to the GitHub Security tab. ## FAQ **Which AI coding tools support Aomi Skills?** Any Agent Skills–compatible tool: Claude Code, Cursor, Gemini CLI, VS Code Copilot, and others. Install once with `npx skills add aomi-labs/skills` and the skills become available in whichever tool you're using. **Do I need an Aomi account or API key?** For the default app and most public data queries, no. For non-default apps and private flows, you'll need an `AOMI_API_KEY` — pass it with `--api-key` or set it as an environment variable. Provider-specific credentials (e.g., exchange keys, bundler keys) can be injected per-session via `aomi secret add`. **How is this different from an MCP server?** Agent Skills are lightweight instructions and tool references that live inside your AI tool's context. MCP servers are long-running external processes exposing a protocol. The `aomi-transact` skill drives the `aomi` CLI — each command starts, runs, and exits — so there's no server to manage. You can use Aomi Skills alongside MCP servers; they don't conflict. **Can I use these skills without signing transactions?** Yes. `aomi-transact` has a read-only mode — `aomi chat "what's the price of ETH?"`, `aomi tx list`, `aomi tx simulate`, balance and portfolio queries all work without any signing key. A signing key is only needed when you want to broadcast a transaction on-chain. **Which chains does `aomi-transact` support?** Ethereum, Polygon, Arbitrum, Base, Base Sepolia, Optimism, Sepolia, Linea Mainnet, Linea Sepolia, Monad, Monad Testnet, Robinhood Chain, MegaETH, and local Anvil are present in the current chain metadata (verified against `@aomi-labs/client` v0.4.2). Solana is supported for sign-only flows via `--solana-private-key` and `--cluster`. Set the active chain with `--chain <id>` or the `AOMI_CHAIN_ID` env var. Each signing invocation needs an RPC URL that matches the target chain. **How do I update to the latest version of the skills?** Re-run `npx skills add aomi-labs/skills`. Re-running pulls the latest skill definitions from `main` and overwrites the local copies. **Does that also update the `aomi` CLI?** No — they update independently. `npx skills add` only refreshes the skill markdown; a globally installed `aomi` binary stays at whatever version you installed. Upgrade it separately with `npm install -g @aomi-labs/client@latest`, or skip the global install and let the skill invoke `npx @aomi-labs/client@latest`, which resolves the newest published version on each run. The skills check `aomi --version` on first use and tell you when the installed CLI is older than the surface they document. ## Resources - [@aomi-labs/client on npm](https://www.npmjs.com/package/@aomi-labs/client) - [Aomi](https://github.com/aomi-labs/aomi) - [Agent Skills Spec](https://agentskills.io) ## About Aomi Aomi Labs builds native harness around blockchains functioning like Claude Code on-chain. We specialize in executions against arbitrary protocol with non-custodial workflow, account abstraction, and full security with simulations. Aomi also host agentic applications deployed and owned by developers, companies, and agents. Aomi provides E2E integration with UI, Skills and SDKs. **Links:** - 🌐 Website: [aomi.dev](https://aomi.dev) - 🤖 Agents: [aomi.dev/agents](https://aomi.dev/agents) - 𝕏 Twitter: [x.com/aomi_labs](https://x.com/aomi_labs) - 💻 GitHub: [github.com/aomi-labs](https://github.com/aomi-labs) - 📦 Packages: - [@aomi-labs/react](https://www.npmjs.com/package/@aomi-labs/react) - [aomi-sdk](https://crates.io/crates/aomi-sdk)