Agent Skills

Aomi publishes two operating procedures in the aomi-labs/skills repository:

Skill	What it teaches
`aomi-transact`	Drive the npm client CLI through Agent chat, Action review, EVM batch simulation, and explicit wallet execution.
`aomi-build`	Turn an API, SDK, or product requirement into a Rust Aomi plugin that you ship as an App.

Skills are markdown instructions and supporting references. Your coding agent reads them and uses the local tools declared by the skill.

Install

Agent Skills clients
OpenAI Codex

Install both skills from the canonical repository:

npx skills add aomi-labs/skills

This path is intended for Agent Skills-compatible clients such as Claude Code, Cursor, Gemini CLI, and VS Code Copilot.

Add the repository as a Codex plugin marketplace, then install the aomi bundle:

codex plugin marketplace add aomi-labs/skills
codex plugin add aomi@aomi-skills

The bundle contains the aomi-transact and aomi-build skills.

The skills and client CLI update independently. Installing or refreshing a skill does not upgrade a globally installed aomi binary. For transaction work, install or update the npm client separately:

npm install -g @aomi-labs/client@latest
aomi --version

aomi-transact requires client 0.6.0 or newer. Its first step checks the detected version and can use npx @aomi-labs/client@latest when no global binary is available.

Transaction workflow

Ask your coding agent for a read or transaction in plain language. The skill turns that request into explicit CLI steps:

aomi chat "swap 1 ETH for USDC" \
  --new-session \
  --public-key 0xYourAddress \
  --chain 1
aomi tx list
aomi tx simulate <action-id>
aomi tx sign <action-id>

The skill treats a quote or chat answer as different from a pending Action. It lists the current Action before signing and simulates dependent EVM execution Actions together. Local CLI execution uses the configured wallet key. Account abstraction is prepared in the backend lane. The --aa and --eoa flags only assert the kind of the pending Action; the skill does not select an AA provider or implementation from the signing command.

Security boundary

The canonical aomi-transact manifest declares risk_tier: L2 because it can sign and broadcast onchain transactions. Its default permissions are narrow:

shell commands are limited to aomi and npx @aomi-labs/client@latest;
file reads and writes are limited to ~/.aomi/, with identity files denied;
network access is limited to chat.aomi.dev in the manifest;
no MCP tools are granted by the skill;
credential setup and transaction signing require an explicit user request;
the procedure lists a pending Action and simulates dependent EVM steps before signing.

The CLI can also contact a user-supplied --rpc-url during wallet execution. Review that endpoint and the prepared Action before authorizing a signing run. The skill never invents or echoes a credential value. aomi secret add sends a temporary secret value to the Aomi backend and stores only its handle locally, so the backend becomes part of the credential’s trust boundary. Persistent per-user App credentials use a separate Account API and never return saved values.

Skills or MCP

	Skills	Aomi MCP
Control plane	Instructions drive local CLI or build tools.	A Streamable HTTP client calls the hosted Agent or Pipeline resource.
Installation	Install the repository or Codex plugin bundle.	Add one MCP URL and complete OAuth.
Transaction review	`aomi-transact` reviews and executes a local CLI Action with a local signer.	Agent MCP hands a pending Action to a human wallet surface.
State	Local CLI records plus backend Agent sessions.	Account-owned Agent sessions or stateless Pipeline calls.
Best fit	Guided transaction procedures and App authoring.	Hosted Agent turns or direct Pipeline discovery from any MCP client.

You can install both. Their credentials and execution boundaries remain separate.

Update

Refresh the skills:

npx skills add aomi-labs/skills

Then update the CLI independently if you use aomi-transact:

npm install -g @aomi-labs/client@latest
aomi --help

Use the repository’s current SKILL.md and references as the authority for the installed procedure. Use Client CLI commands for the installed binary’s command surface.

Try Aomi

Integrate Aomi

Concepts

Security

Payments

Multi-chain Support

Case Studies

Resources

Agent Skills

Install

Transaction workflow

Security boundary

Skills or MCP

Update

​Install

​Transaction workflow

​Security boundary

​Skills or MCP

​Update

Install

Transaction workflow

Security boundary

Skills or MCP

Update