xno-skills 1.4.0 → 1.4.2

package/README.md

@@ -16,15 +16,30 @@ This repository includes built-in skills for AI agents (Claude Code, Cursor, etc
 npx skills add CasualSecurityInc/xno-skills
 ```
 
-Available skills:
-- `create-wallet`: Wallet creation/import guidance (BIP39 default; legacy supported; safe `--stdin` workflows).
-- `convert-units`: High-precision unit conversion reference.
-- `generate-qr`: Terminal-friendly Nano payment QR codes (address + optional amount).
-- `validate-address`: Address format and checksum verification guide.
-- `check-balance`: Check balance/pending via Nano node RPC.
-- `mcp-wallet`: Use `xno-mcp` as a private “wallet” custody blackbox (addresses only; no seed leakage).
-- `request-payment`: Request XNO from operator (payment request workflow with tracking, QR, receive, report).
-- `return-funds`: Return XNO to sender (source attribution, ambiguity guards, safe refund).
+Available skills (v1.4.0+):
+- `nano-check-balance`: Check balance/pending via Nano node RPC.
+- `nano-convert-units`: High-precision unit conversion reference.
+- `nano-create-wallet`: Wallet creation/import guidance (BIP39/Legacy support).
+- `nano-generate-qr`: Terminal-friendly Nano payment QR codes.
+- `nano-mcp-wallet`: Use `xno-mcp` as a private “wallet” custody blackbox.
+- `nano-request-payment`: Request XNO from operator (payment request workflow).
+- `nano-return-funds`: Return XNO to sender safely.
+- `nano-sign-message`: Sign off-chain messages (NOMS/ORIS-001).
+- `nano-validate-address`: Address format and checksum verification.
+- `nano-verify-message`: Verify off-chain message signatures.
+- `nano-block-lattice-expert`: Deep protocol wisdom and 2026 operational facts.
+
+### Migration (from < v1.4.0)
+
+If you have old skills installed without the `nano-` prefix, you should remove them and re-add the repo to avoid name collisions and "ghost" skills:
+
+```bash
+# 1. Remove old generic names
+npx skills remove -g check-balance convert-units create-wallet generate-qr mcp-wallet request-payment return-funds sign-message validate-address verify-message
+
+# 2. Add the new prefixed skills
+npx skills add -g CasualSecurityInc/xno-skills
+```
 
 ## MCP Server
 
@@ -37,27 +52,24 @@ To use it, add the following to your MCP client configuration:
   "mcpServers": {
     "xno": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "xno-skills@latest", "xno-mcp"]
     }
   }
 }
 ```
 
 Exposed tools:
-- `wallet_create` / `wallet_list` / `wallet_addresses`: Named “wallets” (custody inside MCP; return addresses only).
-- `wallet_balance` / `wallet_probe_balances`: Balance/pending checks for wallet accounts via RPC.
-- `wallet_receive` / `wallet_send`: Receive pending blocks and send funds (sign + work + `process` via RPC).
-- `config_get` / `config_set`: Store defaults (RPC URL, work URL, timeouts, default representative; optional wallet persistence).
-- `wallet_set_allowance` / `wallet_get_allowance`: Spending limits per wallet (per-tx cap, window budget, destination whitelist).
-- `wallet_history`: Persistent transaction log (sends, receives, linked payment requests).
-- `payment_request_create` / `payment_request_status` / `payment_request_receive` / `payment_request_list`: Payment request lifecycle.
-- `payment_request_refund`: Safe refund with source attribution and ambiguity guards.
-- `generate_qr`: Generate QR codes for Nano addresses/payment URIs.
-- `generate_wallet`: Generate a wallet (default: BIP39 derivation).
-- `derive_address`: Derive an address (supports `bip39` + `legacy`, with `auto` preference).
-- `probe_mnemonic`: Probe both derivations via RPC (helps resolve 24-word ambiguity).
-- `convert_units`: Converts between XNO and raw units.
-- `validate_address`: Validates address format and checksum.
+- `wallet_list`: List available wallets.
+- `wallet_balance`: Check balance/pending for a wallet account.
+- `wallet_receive` / `wallet_send`: Receive pending blocks or send funds.
+- `payment_request_create` / `payment_request_status` / `payment_request_receive` / `payment_request_list` / `payment_request_refund`: Full payment request lifecycle.
+- `wallet_history`: Persistent transaction log.
+- `config_get` / `config_set`: Manage server settings (RPC URL, representative, etc.).
+- `convert_units`: High-precision unit conversion.
+- `validate_address`: Offline address validation.
+- `rpc_account_balance`: Direct RPC balance check for any address.
+- `generate_qr`: Generate ASCII QR codes.
+- `sign_message` / `verify_message`: Sign and verify off-chain messages (NOMS).
 
 ## Installation
 

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -5,7 +5,7 @@ exports.version = exports.pkg = void 0;
 // Keep this in sync by running "npm run build" (prebuild hook).
 exports.pkg = {
     name: "xno-skills",
-    version: "1.4.0"
+    version: "1.4.2"
 };
 exports.version = exports.pkg.version;
 //# sourceMappingURL=version.js.map

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

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mofi5c6tddu5mz",
+      "id": "mofiqe8g7gaair",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_1link1111111111111111111111111111111111111111111111111111111",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-04-26T08:24:20.981Z",
-      "updatedAt": "2026-04-26T08:24:20.981Z",
+      "createdAt": "2026-04-26T08:40:43.408Z",
+      "updatedAt": "2026-04-26T08:40:43.408Z",
       "receivedBlocks": []
     },
     {
-      "id": "mofi5c7yacpxf9",
+      "id": "mofiqe95or7usb",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_1link1111111111111111111111111111111111111111111111111111111",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-04-26T08:24:21.022Z",
-      "updatedAt": "2026-04-26T08:24:21.022Z",
+      "createdAt": "2026-04-26T08:40:43.433Z",
+      "updatedAt": "2026-04-26T08:40:43.433Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "1.4.0";
+    readonly version: "1.4.2";
 };
-export declare const version: "1.4.0";
+export declare const version: "1.4.2";
 //# 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: "1.4.0"
+    version: "1.4.2"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "XNO CLI - Interact with the Nano cryptocurrency",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/skills/nano-convert-units/SKILL.md

@@ -231,5 +231,5 @@ npx xno-skills convert 1 raw --to XNO          # 0.00000000000000000000000000000
 
 ## Related Skills
 
-- **create-wallet** - Generate XNO wallet with seed phrase
-- **validate-address** - Validate XNO addresses (BIP-44, legacy)
+- **nano-create-wallet** - Generate XNO wallet with seed phrase
+- **nano-validate-address** - Validate XNO addresses (BIP-44, legacy)

package/skills/nano-create-wallet/SKILL.md

@@ -64,7 +64,7 @@ Nano funds show as **pending** until the recipient publishes a receive block.
 
 ## Related skills
 
-- `mcp-wallet` – Use OWS wallets via the `xno-mcp` service (recommended for agents)
-- `generate-qr` – Make a QR for the address
-- `validate-address` – Verify a Nano address before sending
-- `check-balance` – Verify balance/pending via RPC
+- `nano-mcp-wallet` – Use OWS wallets via the `xno-mcp` service (recommended for agents)
+- `nano-generate-qr` – Make a QR for the address
+- `nano-validate-address` – Verify a Nano address before sending
+- `nano-check-balance` – Verify balance/pending via RPC

package/skills/nano-generate-qr/SKILL.md

@@ -72,4 +72,4 @@ In interactive flows, ask for:
 - The receiving address (or confirm it).
 - Optional amount in XNO.
 
-If the user asks to send XNO “to the agent” or “to you”, initialize or import a wallet via the MCP server (`mcp-wallet` skill) and generate a QR code for its active address. Remember that you must subsequently call `wallet_receive` from the `mcp-wallet` skill to actually pocket the funds once they send them.
+If the user asks to send XNO “to the agent” or “to you”, initialize or import a wallet via the MCP server (`nano-mcp-wallet` skill) and generate a QR code for its active address. Remember that you must subsequently call `wallet_receive` from the `nano-mcp-wallet` skill to actually pocket the funds once they send them.

package/skills/nano-mcp-wallet/SKILL.md

@@ -91,7 +91,7 @@ By default, the wallet uses **automatic PoW selection** from `@openrai/nano-core
 Call MCP tool:
 - `wallet_list` to see which wallets exist in your OWS vault.
 
-To create a new wallet, use the `ows` CLI (outside of MCP) or the `create-wallet` skill instructions.
+To create a new wallet, use the `ows` CLI (outside of MCP) or the `nano-create-wallet` skill instructions.
 
 ## 2. Reading Balances (MCP Resources & Tools)
 

package/skills/nano-request-payment/SKILL.md

@@ -48,7 +48,7 @@ This returns:
 Tell the operator:
 - How much you need and why
 - The `nano:` address to send to
-- Offer to generate a QR code (use `generate-qr` skill or the `generate_qr` MCP tool if available)
+- Offer to generate a QR code (use `nano-generate-qr` skill or the `generate_qr` MCP tool if available)
 
 Example message:
 > I need 0.1 XNO for [reason]. Please send to:
@@ -81,7 +81,7 @@ Once funds are received, confirm to the operator:
 
 ## Related Skills
 
-- `mcp-wallet` — wallet custody operations
-- `check-balance` — manual balance checking
-- `generate-qr` — QR code generation for payment addresses
-- `return-funds` — returning funds to the operator
+- `nano-mcp-wallet` — wallet custody operations
+- `nano-check-balance` — manual balance checking
+- `nano-generate-qr` — QR code generation for payment addresses
+- `nano-return-funds` — returning funds to the operator

package/skills/nano-return-funds/SKILL.md

@@ -89,6 +89,6 @@ If spending limits prevent the refund:
 
 ## Related Skills
 
-- `request-payment` — the inbound counterpart
-- `mcp-wallet` — wallet operations
-- `validate-address` — verify addresses before sending
+- `nano-request-payment` — the inbound counterpart
+- `nano-mcp-wallet` — wallet operations
+- `nano-validate-address` — verify addresses before sending

package/skills/nano-sign-message/SKILL.md

@@ -10,7 +10,7 @@ triggers:
   - noms signature
 ---
 
-# sign-message
+# nano-sign-message
 
 Sign an off-chain message (plain text) using a custodial wallet managed by `xno-mcp`. This follows the NOMS (Nano Off-chain Message Signature) / ORIS-001 standard.
 

package/skills/nano-verify-message/SKILL.md

@@ -10,7 +10,7 @@ triggers:
   - is this signature valid
 ---
 
-# verify-message
+# nano-verify-message
 
 Verify an off-chain message signature (NOMS / ORIS-001 standard) against a Nano address or public key.