Skip to main content
Aomi Skills are Agent Skills — markdown instruction files that teach AI coding assistants (Claude Code, Cursor, VS Code Copilot, Gemini CLI) how to drive the Aomi platform. When a developer installs a skill, their AI agent learns the full command surface, tool patterns, and safety rules without any manual configuration.

Skill Bundles

The aomi-labs/skills repo ships two skill bundles:

aomi-transact

Teaches agents how to use the Aomi CLI for on-chain operations — chat, simulate, sign. The agent learns to:
  • Run natural-language chat sessions against any Aomi App
  • Simulate transactions on forked network state before signing
  • Sign and broadcast transactions through the wallet pipeline
  • Manage sessions, switch models, and configure API keys
  • Handle errors and recovery flows

aomi-build

Teaches agents how to scaffold and build new Aomi Apps from API specs. The agent learns to:
  • Generate Aomi SDK project structure (lib.rs, client.rs, tool.rs)
  • Design tools that wrap REST/GraphQL endpoints
  • Configure preambles, models, and MCP servers
  • Validate builds and run tests

Installation

This downloads both skill definitions into the AI tool’s skills directory. The agent reads the markdown at runtime — no code to compile, no dependencies to install.

Prerequisites

  • @aomi-labs/client v0.1.30 or newer — the CLI runtime that executes all on-chain operations
  • viem — wallet integration for transaction signing
  • aomi-sdk (Rust) — only needed if building custom apps with aomi-build

Protocol Catalog

The aomi-transact skill references 25+ protocol integrations that the Aomi runtime loads dynamically. Each app has its own tool set and credential requirements: Each protocol has its own tool definitions, credential requirements, and usage examples documented in the skill’s reference files. Pass --app <name> to select an app for a chat turn, or set AOMI_APP=<name> for a multi-command shell.

Security

Skills are security-audited against the OWASP AST03 framework. Every PR runs four automated scanners in CI:

FAQ

What AI tools support Aomi Skills?

Claude Code, Cursor, VS Code Copilot, Gemini CLI, and any tool that implements the Agent Skills specification. Install once and your agent knows the full Aomi command surface.

How are skills different from MCP servers?

Skills are markdown instruction files — the agent reads them at runtime to learn procedures and tool patterns. MCP servers are live endpoints that expose tools via the Model Context Protocol. Skills tell the agent how to use Aomi; MCP servers execute live actions like querying a database. They’re complementary — skills can reference MCP-connected tools.

Do skills execute code on my machine?

No. Skills are read-only markdown files. The agent reads them and executes the shell commands described within (e.g., aomi chat, aomi tx sign). The actual execution happens through the Aomi CLI, which runs in your terminal with your permissions.

What are the prerequisites for using a skill?

You need @aomi-labs/client v0.1.30+ and viem for wallet signing. For building custom apps, you also need the Rust aomi-sdk. No other dependencies — the skill definitions are self-contained markdown.

How do I switch between protocols?

Use --app <name> in any aomi chat command, or set AOMI_APP=<name> in your shell for a multi-command session. Run aomi app list to see all available apps from the backend.

What happens when an app needs credentials?

The CLI reports at runtime what credentials are missing. Configure them on your end or run aomi secret add with the value you supply. The skill never invents or pastes credentials on your behalf.

Can I build my own app and add it to the catalog?

Yes. Use the aomi-build skill and the aomi-sdk Rust SDK to scaffold a new app from an API spec. The SDK provides the CoreAppBuilder pattern — define your tools, preamble, and model, then deploy it as a loadable app in the Aomi runtime.

Are skills kept up to date?

The aomi-labs/skills repo is actively maintained. Each PR runs four security scanners, and the skill definitions are updated alongside CLI releases. Run npx skills update to pull the latest versions.

Which chains does Aomi support?

Aomi supports all EVM chains accessible through the configured RPC endpoints, plus Solana and Cosmos via the Para wallet integration. Individual apps may have chain-specific requirements — the app catalog and CLI output indicate supported networks.

Do I need to install both skill bundles?

No. Install both with npx skills add aomi-labs/skills and your agent picks the right one based on context. aomi-transact activates on transaction-related prompts; aomi-build activates on app-building prompts.

SDK for Custom Skills

For protocol teams that want to build their own Aomi App (with custom tools, preamble, and deployment), use the aomi-sdk Rust SDK. The SDK provides the CoreAppBuilder pattern for constructing apps that the Aomi runtime can load and the skills layer can invoke. See Building Apps for the full SDK reference.

Repositories

Next Steps

Last modified on June 4, 2026