shll-skills 2.0.0 → 2.0.3

package/SKILL.md

@@ -70,35 +70,49 @@ Tell the user:
 export RUNNER_PRIVATE_KEY="0x..."
 ```
 
-### Step 2: Check gas wallet balance
+### Step 2: Check gas balance & token-id
 
 ```bash
 shll-run balance
 ```
 
-If `sufficient: false`, tell the user:
-*"Your operator wallet needs more BNB for gas fees. Send at least $1 of BNB to `<address>`. You can buy BNB on Binance, OKX, or any exchange and withdraw to BSC (BEP-20)."*
+Ask user: *"Do you already have a SHLL Agent token-id (a number like 4, 5, etc.)?"*
 
-Wait until balance is sufficient.
+**If user says YES and gives a number** → Go to Step 4.
 
-### Step 3: Set up agent (user does this themselves)
+**If user says NO, or doesn't know, or says "next" / "continue" / any variation** → Go to Step 3 immediately.
 
-Ask: *"Do you already have a SHLL Agent? (a token-id number)"*
+### Step 3: Create the agent — YOU MUST DO THIS, DO NOT SKIP
 
-**If NO** → Guide them to set up via shll.run:
+🚨 **MANDATORY**: If the user doesn't have a token-id, you MUST run `setup-guide` RIGHT NOW. Do not ask them to "go to a website". Do not keep asking for a token-id they don't have. YOU generate the link for them.
+
+**Immediately run** (default 30 days if user didn't specify):
 ```bash
 shll-run setup-guide --listing-id <LISTING_ID> --days 30
 ```
 
-This outputs a link to https://shll.run/setup with pre-filled parameters. Tell the user:
-1. *"Open the setup link in your browser."*
-2. *"Connect YOUR personal wallet (MetaMask, WalletConnect) — this becomes the owner wallet."*
-3. *"Follow the steps to: rent an agent → authorize the operator wallet → fund the vault."*
-4. *"When done, tell me your token-id number."*
+Then tell the user:
+
+*"I've generated your agent setup link. Open it now in your browser:*
+*👉 `<URL from command output>`*
+
+*⚠️ Connect your **personal wallet** (MetaMask / hardware wallet) — NOT the operator wallet.*
+
+*Follow the 4 steps on the page:*
+1. *Rent — pays rental fee, mints your Agent NFT*
+2. *Authorize — allows this operator wallet to trade*
+3. *Fund — deposits BNB into the trading vault*
+4. *Done — shows your **token-id** number*
+
+*Paste the token-id here when done."*
 
-**⚠️ NEVER use `init` for new users.** The `init` command is deprecated because it uses the same key for owner and operator, which is a security risk.
+❌ **FORBIDDEN PATTERNS — never do any of these:**
+- "Please prepare your token-id" (user doesn't have one!)
+- "Go to shll.run and find your agent" (too vague!)
+- "I need your token-id to proceed" (you should be CREATING it for them!)
+- Asking for token-id more than once without running setup-guide
 
-**If YES** → Verify:
+**If the user already has a token-id**, verify it:
 ```bash
 shll-run portfolio -k <ID>
 ```

package/dist/index.js

@@ -1605,7 +1605,7 @@ var balanceCmd = new import_commander.Command("balance").description("Check BNB
       address: account.address,
       balanceBNB: humanBal,
       sufficient: enough,
-      note: enough ? "Wallet has enough BNB for gas fees." : "Wallet needs more BNB. Send at least $1 of BNB to this address for gas fees."
+      note: enough ? "Wallet has enough BNB for gas fees." : `Wallet needs more BNB for gas. Current: ${humanBal} BNB, minimum recommended: 0.001 BNB (~$0.60). Send a small amount of BNB (BSC/BEP-20) to this address.`
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";

package/dist/index.mjs

@@ -1615,7 +1615,7 @@ var balanceCmd = new Command("balance").description("Check BNB balance of the ga
       address: account.address,
       balanceBNB: humanBal,
       sufficient: enough,
-      note: enough ? "Wallet has enough BNB for gas fees." : "Wallet needs more BNB. Send at least $1 of BNB to this address for gas fees."
+      note: enough ? "Wallet has enough BNB for gas fees." : `Wallet needs more BNB for gas. Current: ${humanBal} BNB, minimum recommended: 0.001 BNB (~$0.60). Send a small amount of BNB (BSC/BEP-20) to this address.`
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "shll-skills",
-    "version": "2.0.0",
+    "version": "2.0.3",
     "description": "SHLL Agent Runtime Skill for OpenClaw",
     "main": "dist/index.js",
     "bin": {
@@ -21,4 +21,4 @@
         "typescript": "^5.4.5",
         "@types/node": "^20.12.7"
     }
-}
+}

package/src/index.ts

@@ -1411,7 +1411,7 @@ const balanceCmd = new Command("balance")
                 sufficient: enough,
                 note: enough
                     ? "Wallet has enough BNB for gas fees."
-                    : "Wallet needs more BNB. Send at least $1 of BNB to this address for gas fees.",
+                    : `Wallet needs more BNB for gas. Current: ${humanBal} BNB, minimum recommended: 0.001 BNB (~$0.60). Send a small amount of BNB (BSC/BEP-20) to this address.`,
             });
         } catch (error: unknown) {
             const message = error instanceof Error ? error.message : "Unknown error";