@heyamiko/amiko-cli 0.7.2 → 0.7.3

package/README.md

@@ -200,6 +200,8 @@ openclaw plugins install @heyamiko/amiko-cli
 
 This registers the CLI's skill file so the agent discovers all commands through the normal skill system. Updates to the CLI (`npm update -g @heyamiko/amiko-cli`) also update the skill docs.
 
+> **The skill is documentation, not a tool.** Agents must run `amiko <command>` through their shell/bash execution tool. Weaker models sometimes slugify the skill name (`amiko-cli` → `amiko_cli`) and try to call it as a tool, which fails with `Tool amiko_cli not found`. If you see that error, switch to a model with stronger tool discipline (e.g. Claude Sonnet 4.6) — see `skills/SKILL.md`.
+
 ### Authentication
 
 Agents auto-authenticate via `.amiko.json` — no manual connect needed. The platform writes this file during twin init with wallets, billing config, and twin token.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -7,6 +7,10 @@ metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
 
 # Amiko CLI
 
+## How to invoke
+
+Run `amiko <command>` via your **shell execution tool** (e.g. `bash`). This skill is a documentation reference, not a callable tool. **Do NOT** try to call `amiko_cli`, `amiko-cli`, `amiko`, or this skill's name as a tool — no such tool exists. The only working invocation is the shell command `amiko`.
+
 The `amiko` CLI is installed globally. Auth and payments are automatic via `.amiko.json` — never suggest `amiko login` or `amiko connect`.
 
 ## Critical Rules
@@ -21,13 +25,19 @@ The `amiko` CLI is installed globally. Auth and payments are automatic via `.ami
 
 ### Credits & Wallet
 
-**Credits are NOT tokens.** 10,000 credits = $1.00 USD. The `topup` command's `<amount>` argument is in **credits**, not tokens. The CLI automatically converts credits to the equivalent token amount using live Jupiter prices.
+**Credits are NOT tokens.** 10,000 credits = $1.00 USD. The `topup` command's `<amount>` argument is always in **credits**, not tokens.
+
+**When the user says "top up X AMIKO" or "top up X dollars"** — they mean spend that amount of tokens/dollars. You must convert to credits first:
+- "top up 1 AMIKO" → check AMIKO price (~$0.04), so 1 AMIKO ≈ $0.04 ≈ 400 credits → `amiko credits topup 400 --token AMIKO --yes`
+- "top up $5" → $5 = 50,000 credits → `amiko credits topup 50000 --token AMIKO --yes`
+- "top up 10000 credits" → already in credits → `amiko credits topup 10000 --token AMIKO --yes`
+
+Always clarify with the user: "That's X credits (≈$Y), paying Z AMIKO from your wallet. Proceed?"
 
 ```bash
 amiko credits balance                           # credit balance + wallet balances
-amiko credits topup 10000 --token AMIKO --yes   # buy 10,000 credits (~$1) paying in AMIKO from wallet
-amiko credits topup 50000 --token USDC --yes    # buy 50,000 credits (~$5) paying in USDC from wallet
-amiko credits topup 10000 --token SOL --yes     # buy 10,000 credits (~$1) paying in SOL from wallet
+amiko credits topup 10000 --token AMIKO --yes   # buy 10,000 credits (~$1) paying in AMIKO
+amiko credits topup 50000 --token USDC --yes    # buy 50,000 credits (~$5) paying in USDC
 ```
 
 **How topup works:**