{
  "markdown": "# Aomi Skills\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE) ![Works with Claude Code · Cursor · Gemini · Copilot](https://img.shields.io/badge/Works%20with-Claude%20Code%20%C2%B7%20Cursor%20%C2%B7%20Gemini%20%C2%B7%20Copilot-6E56CF)\n\n> 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.\n\n## What are Aomi Skills?\n\nAomi 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.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| [aomi-build](aomi-build/SKILL.md) | Build Aomi apps and plugins from APIs, specs, SDK docs, runtime interfaces, and product requirements |\n| [aomi-transact](aomi-transact/SKILL.md) | Build and execute EVM transactions through a conversational AI agent via the `aomi` CLI |\n\n## Use Cases\n\n- **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.\n- **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`).\n- **Explore on-chain state without a dashboard** — query balances, prices, routes, and quotes right from your AI assistant.\n- **Orchestrate multi-step DeFi flows with batch simulation** — simulate approve → swap or bridge → settle sequences before signing, catching reverts before they cost gas.\n\n## Installation\n\n```bash\nnpx skills add aomi-labs/skills\n```\n\nWorks with Claude Code, Cursor, Gemini CLI, VS Code Copilot, and any [Agent Skills](https://agentskills.io)-compatible tool.\n\n### OpenAI Codex\n\nAdd this repo as a Codex plugin marketplace, then install the `aomi` bundle:\n\n```bash\ncodex plugin marketplace add aomi-labs/skills\n```\n\nThe `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).\n\n## Prerequisites\n\n```bash\nnpm install -g @aomi-labs/client\n```\n\nThe 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.\n\n## Usage\n\nOnce installed, ask your agent:\n\n- \"Use aomi: What's the price of ETH?\"\n- \"Swap 1 ETH for USDC on Uniswap\"\n- \"Send 0.1 ETH to vitalik.eth\"\n\nThe agent handles the full flow: chat with the backend, review pending transactions, sign and broadcast on-chain.\n\n## Security\n\n`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).\n\nThe 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.\n\n## FAQ\n\n**Which AI coding tools support Aomi Skills?**\nAny 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.\n\n**Do I need an Aomi account or API key?**\nFor 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`.\n\n**How is this different from an MCP server?**\nAgent 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.\n\n**Can I use these skills without signing transactions?**\nYes. `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.\n\n**Which chains does `aomi-transact` support?**\nEthereum, 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.\n\n**How do I update to the latest version of the skills?**\nRe-run `npx skills add aomi-labs/skills`. Re-running pulls the latest skill definitions from `main` and overwrites the local copies.\n\n**Does that also update the `aomi` CLI?**\nNo — 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.\n\n## Resources\n\n- [@aomi-labs/client on npm](https://www.npmjs.com/package/@aomi-labs/client)\n- [Aomi](https://github.com/aomi-labs/aomi)\n- [Agent Skills Spec](https://agentskills.io)\n\n## About Aomi\n\nAomi 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.\n\n**Links:**\n- 🌐 Website: [aomi.dev](https://aomi.dev)\n- 🤖 Agents: [aomi.dev/agents](https://aomi.dev/agents)\n- 𝕏 Twitter: [x.com/aomi_labs](https://x.com/aomi_labs)\n- 💻 GitHub: [github.com/aomi-labs](https://github.com/aomi-labs)\n- 📦 Packages:\n  - [@aomi-labs/react](https://www.npmjs.com/package/@aomi-labs/react)\n  - [aomi-sdk](https://crates.io/crates/aomi-sdk)\n",
  "bytes": 7642,
  "sha": "dca06450e3f659fb46c454047360ef6fa753719e21aeac649d9f9b4160475871",
  "repo_slug": "aomi-labs/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aomi_labs_skills_aomi_transact_f53c2a2c/readme"
}