xno-skills 3.1.2 → 3.1.3

package/README.md

@@ -3,19 +3,20 @@
 [![npm version](https://img.shields.io/npm/v/xno-skills.svg)](https://www.npmjs.com/package/xno-skills)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![smithery badge](https://smithery.ai/badge/casualsecurityinc/xno-skills)](https://smithery.ai/servers/casualsecurityinc/xno-skills)
 
 A CLI, MCP server, and AI skills for [Nano](https://nano.org/) (XNO). Built on top of [Open Wallet Standard (OWS)](https://github.com/open-wallet-standard/core) for secure key custody.
 
 ![xno-skills CLI preview](assets/xno-skills-cli.png)
 
-## AI Skills
+## Agent Skills
 
-Built-in skills for AI agents (Claude Code, Cursor, etc.):
+Built-in skill for Personal AI Agents (OpenClaw etc.) and humans running AI coding assistants (Claude Code, Cursor, etc.) alike:
 
 ```bash
 npx skills add -g CasualSecurityInc/xno-skills
-# non-interactively: 
-# npx skills add --all -g CasualSecurityInc/xno-skills
+# or non-interactively, i.e. for agent use: 
+npx -y skills add -y --all -g CasualSecurityInc/xno-skills
 ```
 
 > [!IMPORTANT]
@@ -31,7 +32,7 @@ Available skills:
 ## CLI
 
 ```bash
-npm install -g xno-skills@3.1.2
+npm install -g xno-skills@3.1.3
 xno-skills --help
 ```
 
@@ -74,6 +75,7 @@ xno-skills --help
 
 | Command | Description |
 |---|---|
+| `about` | Show version and environment info for troubleshooting |
 | `mcp` | Start the MCP server or view configuration instructions |
 
 All commands support `-j` / `--json` for machine-readable output.
@@ -89,7 +91,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.2", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
     }
   }
 }
@@ -105,7 +107,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
 codex mcp add nano \
   -c sandbox_mode="danger-full-access" \
   -c 'sandbox_permissions=["network-access"]' \
-  -- npx -y -p xno-skills@3.1.2 xno-mcp
+  -- npx -y -p xno-skills@3.1.3 xno-mcp
 ```
 </details>
 
@@ -117,7 +119,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.2", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
     }
   }
 }
@@ -133,7 +135,7 @@ codex mcp add nano \
   "mcp": {
     "nano": {
       "type": "local",
-      "command": ["npx", "-y", "-p", "xno-skills@3.1.2", "xno-mcp"],
+      "command": ["npx", "-y", "-p", "xno-skills@3.1.3", "xno-mcp"],
       "enabled": true
     }
   }
@@ -149,7 +151,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.2", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
     }
   }
 }
@@ -164,7 +166,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.2", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
     }
   }
 }
@@ -180,7 +182,7 @@ codex mcp add nano \
     "nano": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@3.1.2", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@3.1.3", "xno-mcp"]
     }
   }
 }

package/dist/cjs/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "3.1.2";
+    readonly version: "3.1.3";
 };
-export declare const version: "3.1.2";
+export declare const version: "3.1.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "3.1.2"
+    version: "3.1.3"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/dist/esm/.xno-mcp/requests.json

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mozhx80nbfnra6",
+      "id": "mozz60g7gcuhr4",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-05-10T08:13:25.848Z",
-      "updatedAt": "2026-05-10T08:13:25.848Z",
+      "createdAt": "2026-05-10T16:16:09.415Z",
+      "updatedAt": "2026-05-10T16:16:09.415Z",
       "receivedBlocks": []
     },
     {
-      "id": "mozhx81dpyorp3",
+      "id": "mozz60gz5hqxw4",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-05-10T08:13:25.873Z",
-      "updatedAt": "2026-05-10T08:13:25.873Z",
+      "createdAt": "2026-05-10T16:16:09.443Z",
+      "updatedAt": "2026-05-10T16:16:09.443Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "3.1.2";
+    readonly version: "3.1.3";
 };
-export declare const version: "3.1.2";
+export declare const version: "3.1.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "3.1.2"
+    version: "3.1.3"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "description": "XNO CLI - Interact with Nano (XNO)",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/skills/nano/SKILL.md

@@ -46,6 +46,7 @@ triggers:
   - how much nano
 complements:
   - ows  # Open Wallet Standard — wallet lifecycle (create, import, rename, delete)
+requires_network: true
 ---
 
 # Nano (XNO)
@@ -70,21 +71,27 @@ This skill applies **exclusively to the Nano cryptocurrency protocol** (ticker:
 
 When the environment provides `xno-mcp` tools (`wallet.list`, `wallet.send`, `wallet.receive`, `wallet.balance`, `util.convert`, `util.qr`, `util.validate`, `rpc.account_balance`, `payment.create`, etc.) — **always use them first**. They handle signing, PoW, and broadcast automatically via OWS.
 
+If the client supports MCP, set it up as a "stdio" type MCP server:
+
+    npx -y -p xno-skills@3.1.3 -- mcp
+
+MCP is the primary execution path because tools, schemas, and results are structured for the client. Use the included CLI script (`xno-skills`) only as a fallback when MCP is unavailable or the client cannot attach MCP servers. MCP and the CLI target EXACTLY the same underlying code paths — two access paths, not two different products.
+
 ### 2. Fall back to CLI only when MCP is unavailable
 
 If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage, fall back to the `xno-skills` CLI in this priority order:
 
 ```
-1. bunx -y xno-skills@3.1.2 <command>
-2. pnpm dlx xno-skills@3.1.2 <command>
-3. npx -y xno-skills@3.1.2 <command>
+1. bunx -y xno-skills@3.1.3 <command>
+2. pnpm dlx xno-skills@3.1.3 <command>
+3. npx -y xno-skills@3.1.3 <command>
 ```
 
 Do **not** assume `xno-skills` is installed globally. Always use one of the above forms with `@latest` to get critical bugfixes and to prevent interactive prompts from freezing.
 
 Before guessing a subcommand, run `--help`:
 ```bash
-bunx -y xno-skills@3.1.2 --help
+bunx -y xno-skills@3.1.3 --help
 ```
 
 ### 3. Wallet lifecycle → `ows` skill only
@@ -108,7 +115,7 @@ For wallet **create, import, rename, or delete**: delegate to the `ows` skill. D
 - **Proactivity on pending funds**: If you see pending funds during any balance check, call `wallet.receive` immediately. Do not wait for the user to ask.
 - **Persistence on "Account not found"**: This is normal for a brand-new, unopened account. Continue — `wallet.receive` will automatically build an open block (sets `previous` to zeros), sign it via OWS, generate PoW, and broadcast. Never conclude you are unauthorized or that OWS cannot sign Nano blocks.
 - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
-- **Supply chain**: Only use `xno-skills@3.1.2` and `@open-wallet-standard/core`. No other npm packages.
+- **Supply chain**: Only use `xno-skills@3.1.3` and `@open-wallet-standard/core`. No other npm packages.
 - **Stop-loss**: If you have made 5 tool calls without completing the operation, stop and report what you tried, what failed, and ask for guidance. Hard limits: max 3 retries of the same failing tool; max 2 `config.set` RPC endpoint switches.
 
 ---
@@ -139,8 +146,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.2 balance --wallet "my-wallet"
-bunx -y xno-skills@3.1.2 rpc account-balance <address>
+bunx -y xno-skills@3.1.3 balance --wallet "my-wallet"
+bunx -y xno-skills@3.1.3 rpc account-balance <address>
 ```
 
 Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -170,7 +177,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.2 receive --wallet "my-wallet"
+bunx -y xno-skills@3.1.3 receive --wallet "my-wallet"
 ```
 
 Full options: [receive](references/receive.md)
@@ -202,7 +209,7 @@ The account must be opened (have a receive block) and have sufficient balance.
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@3.1.2 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
+bunx -y xno-skills@3.1.3 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
 ```
 
 Full options: [send](references/send.md)
@@ -314,7 +321,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
 
 **Via CLI (required args only):**
 ```bash
-bunx -y xno-skills@3.1.2 qr nano_1abc...
+bunx -y xno-skills@3.1.3 qr nano_1abc...
 ```
 
 Full options: [qr](references/qr.md)
@@ -341,7 +348,7 @@ All validation is **offline** — no network required.
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@3.1.2 validate nano_1abc...
+bunx -y xno-skills@3.1.3 validate nano_1abc...
 ```
 
 Full options: [validate](references/validate.md)
@@ -368,10 +375,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@3.1.2 convert 1 xno       # all units
-bunx -y xno-skills@3.1.2 convert 1 knano
-bunx -y xno-skills@3.1.2 convert 1000000000000000000000000000000 raw
-bunx -y xno-skills@3.1.2 convert 1 xno --json
+bunx -y xno-skills@3.1.3 convert 1 xno       # all units
+bunx -y xno-skills@3.1.3 convert 1 knano
+bunx -y xno-skills@3.1.3 convert 1000000000000000000000000000000 raw
+bunx -y xno-skills@3.1.3 convert 1 xno --json
 ```
 
 Full options: [convert](references/convert.md)
@@ -397,20 +404,20 @@ Present the user with this command to run locally:
 
 ```bash
 # Sign — run this yourself, replacing the placeholder with your actual key
-bunx -y xno-skills@3.1.2 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
+bunx -y xno-skills@3.1.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
 
 # Sign with JSON output
-bunx -y xno-skills@3.1.2 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
+bunx -y xno-skills@3.1.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
 ```
 
 For verify, the agent *can* run this directly (no secret material involved):
 
 ```bash
 # Verify
-bunx -y xno-skills@3.1.2 verify <nano_address> "<message>" <signature-hex>
+bunx -y xno-skills@3.1.3 verify <nano_address> "<message>" <signature-hex>
 
 # Verify with JSON output
-bunx -y xno-skills@3.1.2 verify <nano_address> "<message>" <signature-hex> --json
+bunx -y xno-skills@3.1.3 verify <nano_address> "<message>" <signature-hex> --json
 ```
 
 **NOMS standard (ORIS-001)**: Signatures are computed over a binary payload with a magic header, ensuring a valid signature cannot be misinterpreted as a Nano transaction block.
@@ -486,7 +493,7 @@ Never use `curl` to probe this.
 { "name": "wallet.change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
 ```
 ```bash
-bunx -y xno-skills@3.1.2 change-rep --wallet "my-wallet" --representative "nano_..."
+bunx -y xno-skills@3.1.3 change-rep --wallet "my-wallet" --representative "nano_..."
 ```
 
 Full options: [change-rep](references/change-rep.md)
@@ -622,7 +629,7 @@ Public nodes that support `work_generate` (not guaranteed — depends on node op
 
 To probe whether an RPC endpoint supports remote `work_generate`:
 ```bash
-bunx -y xno-skills@3.1.2 rpc probe-caps <url>
+bunx -y xno-skills@3.1.3 rpc probe-caps <url>
 ```
 
 Reset to local-only after resolving: