feat: rename recipe-* skills and auto-install to agent dirs

Rename all 20 recipe-* skill directories to bitmex-recipe-* so every
skill has the bitmex- prefix. Makes all bitmex skills easy to find and
remove (rm ~/.claude/commands/bitmex-*.md) without touching unrelated
skills from other tools.

Extend install.sh to copy skills to detected agent directories after
binary install: OpenClaw (~/.openclaw/skills/), Claude Code
(~/.claude/commands/ as flat .md files), Hermes (~/.hermes/skills/).
Skills install is non-fatal — a download failure warns and continues.

Also corrects ~80 command bugs across 29 SKILL.md files verified
against the live BitMEX API.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Quentin-M

skills/INDEX.md

@@ -88,43 +88,43 @@ Multi-step workflows combining multiple skills.
 
 | Skill | Description |
 |-------|-------------|
-| [recipe-start-dca-bot](./recipe-start-dca-bot/SKILL.md) | Set up and run a DCA bot from testnet validation to live. |
-| [recipe-launch-grid-bot](./recipe-launch-grid-bot/SKILL.md) | Deploy a grid trading bot with testnet validation. |
-| [recipe-trailing-stop-runner](./recipe-trailing-stop-runner/SKILL.md) | Ride a trend with a trailing stop that locks in profits on reversal. |
-| [recipe-basis-trade-entry](./recipe-basis-trade-entry/SKILL.md) | Enter a perp-futures basis trade when premium exceeds threshold. |
-| [recipe-futures-hedge-spot](./recipe-futures-hedge-spot/SKILL.md) | Hedge a long position with a short perpetual. |
-| [recipe-funding-rate-scan](./recipe-funding-rate-scan/SKILL.md) | Scan perpetual contracts for funding rate carry opportunities. |
-| [recipe-testnet-strategy-backtest](./recipe-testnet-strategy-backtest/SKILL.md) | Validate a strategy across multiple testnet sessions before going live. |
+| [bitmex-recipe-start-dca-bot](./bitmex-recipe-start-dca-bot/SKILL.md) | Set up and run a DCA bot from testnet validation to live. |
+| [bitmex-recipe-launch-grid-bot](./bitmex-recipe-launch-grid-bot/SKILL.md) | Deploy a grid trading bot with testnet validation. |
+| [bitmex-recipe-trailing-stop-runner](./bitmex-recipe-trailing-stop-runner/SKILL.md) | Ride a trend with a trailing stop that locks in profits on reversal. |
+| [bitmex-recipe-basis-trade-entry](./bitmex-recipe-basis-trade-entry/SKILL.md) | Enter a perp-futures basis trade when premium exceeds threshold. |
+| [bitmex-recipe-futures-hedge-spot](./bitmex-recipe-futures-hedge-spot/SKILL.md) | Hedge a long position with a short perpetual. |
+| [bitmex-recipe-funding-rate-scan](./bitmex-recipe-funding-rate-scan/SKILL.md) | Scan perpetual contracts for funding rate carry opportunities. |
+| [bitmex-recipe-testnet-strategy-backtest](./bitmex-recipe-testnet-strategy-backtest/SKILL.md) | Validate a strategy across multiple testnet sessions before going live. |
 
 ### Portfolio Recipes
 
 | Skill | Description |
 |-------|-------------|
-| [recipe-weekly-rebalance](./recipe-weekly-rebalance/SKILL.md) | Weekly rebalance to maintain target position allocations. |
-| [recipe-daily-pnl-report](./recipe-daily-pnl-report/SKILL.md) | Daily realised P&L summary from trades and wallet history. |
-| [recipe-portfolio-snapshot-csv](./recipe-portfolio-snapshot-csv/SKILL.md) | Export portfolio snapshot with balances and positions to CSV. |
-| [recipe-subaccount-capital-rotation](./recipe-subaccount-capital-rotation/SKILL.md) | Rotate capital between subaccounts based on strategy performance. |
-| [recipe-fee-tier-progress](./recipe-fee-tier-progress/SKILL.md) | Track trading volume and commission rates. |
+| [bitmex-recipe-weekly-rebalance](./bitmex-recipe-weekly-rebalance/SKILL.md) | Weekly rebalance to maintain target position allocations. |
+| [bitmex-recipe-daily-pnl-report](./bitmex-recipe-daily-pnl-report/SKILL.md) | Daily realised P&L summary from trades and wallet history. |
+| [bitmex-recipe-portfolio-snapshot-csv](./bitmex-recipe-portfolio-snapshot-csv/SKILL.md) | Export portfolio snapshot with balances and positions to CSV. |
+| [bitmex-recipe-subaccount-capital-rotation](./bitmex-recipe-subaccount-capital-rotation/SKILL.md) | Rotate capital between subaccounts based on strategy performance. |
+| [bitmex-recipe-fee-tier-progress](./bitmex-recipe-fee-tier-progress/SKILL.md) | Track trading volume and commission rates. |
 
 ### Market Data Recipes
 
 | Skill | Description |
 |-------|-------------|
-| [recipe-morning-market-brief](./recipe-morning-market-brief/SKILL.md) | Morning summary: prices, funding, positions, and wallet. |
-| [recipe-multi-pair-breakout-watch](./recipe-multi-pair-breakout-watch/SKILL.md) | Monitor multiple symbols for price breakouts. |
-| [recipe-track-orderbook-depth](./recipe-track-orderbook-depth/SKILL.md) | Monitor order book depth and bid-ask imbalance for liquidity signals. |
-| [recipe-price-level-alerts](./recipe-price-level-alerts/SKILL.md) | Set up price level alerts for key levels. |
+| [bitmex-recipe-morning-market-brief](./bitmex-recipe-morning-market-brief/SKILL.md) | Morning summary: prices, funding, positions, and wallet. |
+| [bitmex-recipe-multi-pair-breakout-watch](./bitmex-recipe-multi-pair-breakout-watch/SKILL.md) | Monitor multiple symbols for price breakouts. |
+| [bitmex-recipe-track-orderbook-depth](./bitmex-recipe-track-orderbook-depth/SKILL.md) | Monitor order book depth and bid-ask imbalance for liquidity signals. |
+| [bitmex-recipe-price-level-alerts](./bitmex-recipe-price-level-alerts/SKILL.md) | Set up price level alerts for key levels. |
 
 ### Risk Recipes
 
 | Skill | Description |
 |-------|-------------|
-| [recipe-emergency-flatten](./recipe-emergency-flatten/SKILL.md) | Cancel all orders and close all positions immediately. |
-| [recipe-drawdown-circuit-breaker](./recipe-drawdown-circuit-breaker/SKILL.md) | Halt trading when portfolio drawdown exceeds threshold. |
+| [bitmex-recipe-emergency-flatten](./bitmex-recipe-emergency-flatten/SKILL.md) | Cancel all orders and close all positions immediately. |
+| [bitmex-recipe-drawdown-circuit-breaker](./bitmex-recipe-drawdown-circuit-breaker/SKILL.md) | Halt trading when portfolio drawdown exceeds threshold. |
 
 ### Funding Recipes
 
 | Skill | Description |
 |-------|-------------|
-| [recipe-withdrawal-to-cold-storage](./recipe-withdrawal-to-cold-storage/SKILL.md) | Safely withdraw funds to a pre-approved cold storage address. |
-| [recipe-staking-yield-compare](./recipe-staking-yield-compare/SKILL.md) | Compare staking yields across instruments to find the best rate. |
+| [bitmex-recipe-withdrawal-to-cold-storage](./bitmex-recipe-withdrawal-to-cold-storage/SKILL.md) | Safely withdraw funds to a pre-approved cold storage address. |
+| [bitmex-recipe-staking-yield-compare](./bitmex-recipe-staking-yield-compare/SKILL.md) | Compare staking yields across instruments to find the best rate. |

skills/bitmex-basis-trading/SKILL.md

@@ -27,11 +27,11 @@ A positive basis (futures above perp) typically reflects cost-of-carry. The stra
 ```bash
 # Perpetual
 PERP=$(bitmex market instrument --symbol XBTUSD -o json 2>/dev/null | \
-  jq -r '.lastPrice')
+  jq -r '.[0].lastPrice')
 
 # Nearest quarterly future (example: XBTM25)
 FUT=$(bitmex market instrument --symbol XBTM25 -o json 2>/dev/null | \
-  jq -r '.lastPrice')
+  jq -r '.[0].lastPrice')
 
 echo "Perp: $PERP | Future: $FUT"
 ```
@@ -44,7 +44,7 @@ echo "Basis: ${BASIS}%"
 
 # Days to expiry for annualized estimate
 SETTLE=$(bitmex market instrument --symbol XBTM25 -o json 2>/dev/null | \
-  jq -r '.settle')
+  jq -r '.[0].settle')
 echo "Settlement: $SETTLE"
 ```
 
@@ -86,8 +86,8 @@ bitmex order sell XBTM25 $QTY --price "$FUT" \
 
 ```bash
 # Check current basis
-PERP_NOW=$(bitmex market instrument --symbol XBTUSD -o json 2>/dev/null | jq -r '.lastPrice')
-FUT_NOW=$(bitmex market instrument --symbol XBTM25 -o json 2>/dev/null | jq -r '.lastPrice')
+PERP_NOW=$(bitmex market instrument --symbol XBTUSD -o json 2>/dev/null | jq -r '.[0].lastPrice')
+FUT_NOW=$(bitmex market instrument --symbol XBTM25 -o json 2>/dev/null | jq -r '.[0].lastPrice')
 BASIS_NOW=$(echo "scale=6; ($FUT_NOW - $PERP_NOW) / $PERP_NOW * 100" | bc -l)
 echo "Current basis: ${BASIS_NOW}%"
 

skills/bitmex-dca-strategy/SKILL.md

@@ -35,7 +35,7 @@ export BITMEX_API_SECRET="testnet-secret"
 # Run 3 testnet cycles to verify logic
 for i in 1 2 3; do
   PRICE=$(bitmex --testnet market orderbook XBTUSD --depth 1 -o json 2>/dev/null | \
-    jq '.bids[0][0]')
+    jq '[.[] | select(.side == "Buy")] | .[0].price')
   bitmex --testnet order buy XBTUSD 100 --price "$PRICE" \
     --order-type Limit --exec-inst ParticipateDoNotInitiate \
     -o json 2>/dev/null | jq '{orderID, price, ordStatus}'
@@ -72,7 +72,7 @@ while true; do
 
   # 3. Place limit order at best bid
   BID=$(bitmex market orderbook $SYMBOL --depth 1 -o json 2>/dev/null | \
-    jq '.bids[0][0]')
+    jq '[.[] | select(.side == "Buy")] | .[0].price')
   echo "DCA buy $QTY $SYMBOL @ $BID"
   bitmex order buy $SYMBOL $QTY \
     --price "$BID" \

skills/bitmex-fee-optimization/SKILL.md

@@ -21,11 +21,15 @@ BitMEX charges taker fees and pays maker rebates. The difference is meaningful a
 | Maker | Rebate | You earn (negative fee) |
 | Taker | Fee | You pay |
 
-Check your current fee schedule:
+Check your current fee schedule (returns a map of symbol → fees):
 
 ```bash
+# All symbols
+bitmex account commission -o json 2>/dev/null
+
+# Single symbol
 bitmex account commission -o json 2>/dev/null | \
-  jq '{makerFee, takerFee, settlementFee}'
+  jq '.XBTUSD | {makerFee, takerFee, settlementFee}'
 ```
 
 ## Default: Post-Only Limit Orders
@@ -60,7 +64,7 @@ Market orders always pay taker fees. Use limit orders at aggressive prices (insi
 
 ```bash
 # Instead of market buy, use aggressive limit:
-ASK=$(bitmex market orderbook XBTUSD --depth 1 -o json 2>/dev/null | jq '.asks[0][0]')
+ASK=$(bitmex market orderbook XBTUSD --depth 1 -o json 2>/dev/null | jq '[.[] | select(.side=="Sell") | .price][0]')
 bitmex order buy XBTUSD 100 \
   --price "$ASK" \
   --order-type Limit \
@@ -85,12 +89,12 @@ bitmex order buy XBTUSD 100 \
 Higher 30-day trading volume unlocks lower fees:
 
 ```bash
-# Check your 30-day volume
+# Check your 30-day volume (returns array; first element has the totals)
 bitmex account volume -o json 2>/dev/null | \
-  jq '{advUsd, advXBt}'
+  jq '.[0] | {advUsd, advUsdContract, advUsdSpot}'
 
-# Cross-reference with commission tiers
-bitmex account commission -o json 2>/dev/null
+# Cross-reference with commission tiers (returns map of symbol → fees)
+bitmex account commission -o json 2>/dev/null | jq '.XBTUSD'
 ```
 
 ## Fee Audit from Trade History

skills/bitmex-funding-carry/SKILL.md

@@ -44,7 +44,7 @@ Only enter if the annualized yield exceeds transaction costs and risk premium. A
 
 ```bash
 # Annualized carry threshold check (e.g., > 10% annualized)
-RATE=$(bitmex market funding --symbol XBTUSD -o json 2>/dev/null | \
+RATE=$(bitmex market funding --symbol XBTUSD --count 1 --reverse -o json 2>/dev/null | \
   jq -r '.[0].fundingRate // 0')
 ANNUALIZED=$(echo "$RATE * 3 * 365 * 100" | bc -l)
 echo "Annualized funding yield: ${ANNUALIZED}%"
@@ -101,7 +101,7 @@ bitmex position list --symbol XBTUSD -o json 2>/dev/null | \
 
 ```bash
 # Check if rate has converged toward zero
-RATE=$(bitmex market funding --symbol XBTUSD -o json 2>/dev/null | \
+RATE=$(bitmex market funding --symbol XBTUSD --count 1 --reverse -o json 2>/dev/null | \
   jq -r '.[0].fundingRate // 0')
 EXIT_THRESHOLD=0.0001  # < 0.01% per 8h no longer worth holding
 

skills/bitmex-grid-trading/SKILL.md

@@ -36,7 +36,7 @@ FLAG="--testnet"
 
 # Verify connectivity
 bitmex $FLAG market instrument --symbol XBTUSD -o json 2>/dev/null | \
-  jq '{symbol, lastPrice}'
+  jq '.[0] | {symbol, lastPrice}'
 ```
 
 ## Calculate Grid Levels
@@ -61,7 +61,7 @@ done
 ## Place Grid Orders
 
 ```bash
-CURRENT=$(bitmex market instrument --symbol $SYMBOL -o json 2>/dev/null | jq -r '.lastPrice')
+CURRENT=$(bitmex market instrument --symbol $SYMBOL -o json 2>/dev/null | jq -r '.[0].lastPrice')
 
 for i in $(seq 0 $((GRID_COUNT - 1))); do
   LEVEL=$(echo "$GRID_LOW + $STEP * $i" | bc)

skills/bitmex-liquidation-guard/SKILL.md

@@ -21,7 +21,7 @@ bitmex account margin --currency XBt -o json 2>/dev/null | jq '
   {
     marginBalance,
     availableMargin,
-    maintenanceMargin,
+    maintMargin,
     health_pct: ((.availableMargin / .marginBalance * 100) | round / 100)
   }
 '

skills/bitmex-market-intel/SKILL.md

@@ -21,7 +21,7 @@ Retrieve contract specifications, mark price, open interest, and 24h volume.
 ```bash
 # Single instrument
 bitmex market instrument --symbol XBTUSD -o json 2>/dev/null | \
-  jq '{symbol, lastPrice, markPrice, openInterest, volume24h: .volume}'
+  jq '.[0] | {symbol, lastPrice, markPrice, openInterest, volume24h: .volume}'
 
 # All active instruments
 bitmex market instrument --active -o json 2>/dev/null | \
@@ -35,16 +35,16 @@ bitmex market instrument --indices -o json 2>/dev/null | \
 ## Order Book
 
 ```bash
-# Top 25 levels (default)
+# Top 25 levels (default) — response is a flat array of {side, price, size}
 bitmex market orderbook XBTUSD -o json 2>/dev/null | \
-  jq '{bids: .bids[:5], asks: .asks[:5]}'
+  jq '{bids: [.[] | select(.side=="Buy") | [.price,.size]][:5], asks: [.[] | select(.side=="Sell") | [.price,.size]][:5]}'
 
 # Top 5 levels
 bitmex market orderbook XBTUSD --depth 5 -o json 2>/dev/null
 
 # Mid price calculation
 bitmex market orderbook XBTUSD --depth 1 -o json 2>/dev/null | \
-  jq '(.bids[0][0] + .asks[0][0]) / 2'
+  jq '([.[] | select(.side=="Buy") | .price][0] + [.[] | select(.side=="Sell") | .price][0]) / 2'
 ```
 
 ## Recent Trades
@@ -68,7 +68,7 @@ bitmex market trades --symbol XBTUSD --bucketed --bin-size 5m -o json 2>/dev/nul
 ```bash
 # Current best bid/ask
 bitmex market quote --symbol XBTUSD -o json 2>/dev/null | \
-  jq '{bidPrice, bidSize, askPrice, askSize}'
+  jq '.[0] | {bidPrice, bidSize, askPrice, askSize}'
 
 # Bucketed quote history
 bitmex market quote --symbol XBTUSD --bucketed --bin-size 1h -o json 2>/dev/null
@@ -81,7 +81,7 @@ Perpetual contracts pay or receive funding every 8 hours (00:00, 08:00, 16:00 UT
 ```bash
 # Current funding rate
 bitmex market funding --symbol XBTUSD -o json 2>/dev/null | \
-  jq '{symbol, fundingRate, fundingRateDaily: (.fundingRate * 3), nextFundingTime}'
+  jq '.[0] | {symbol, fundingRate, fundingRateDaily: (.fundingRate * 3), timestamp}'
 
 # Funding history (last 10 periods)
 bitmex market funding --symbol XBTUSD --count 10 --reverse -o json 2>/dev/null | \
@@ -101,7 +101,7 @@ bitmex market liquidation --symbol XBTUSD -o json 2>/dev/null | \
 ```bash
 # Upcoming and past settlements
 bitmex market settlement --symbol XBTM25 -o json 2>/dev/null | \
-  jq '{settlDate, settledPrice}'
+  jq '.[0] | {timestamp, settledPrice}'
 ```
 
 ## Insurance Fund
@@ -125,6 +125,6 @@ bitmex market stats -o json 2>/dev/null | \
 # Top traders by notional
 bitmex market leaderboard --method notional -o json 2>/dev/null | jq '.[0:5]'
 
-# Top traders by ROE
-bitmex market leaderboard --method roe -o json 2>/dev/null | jq '.[0:5]'
+# Top traders by ROE (not supported on mainnet — omit or use --method notional)
+# bitmex market leaderboard --method roe -o json 2>/dev/null | jq '.[0:5]'
 ```

skills/bitmex-mcp-integration/SKILL.md

@@ -115,11 +115,18 @@ MCP tools follow the pattern `bitmex_<group>_<subcommand>`:
 ## Verifying the MCP Server
 
 ```bash
-# List available tools
-bitmex mcp --list-tools 2>/dev/null
-
-# Test a single tool call
-bitmex mcp --call bitmex_market_instrument '{"symbol":"XBTUSD"}' 2>/dev/null
+# Start the MCP server in stdio mode and confirm it launches without error
+bitmex mcp -s market,account 2>/dev/null &
+MCP_PID=$!
+sleep 1
+kill $MCP_PID 2>/dev/null
+
+# To test a tool call, connect via an MCP client (e.g. Claude Desktop) or use the --port HTTP mode:
+# bitmex mcp --port 3000 --token mytoken -s market,account &
+# curl -s -H "Authorization: Bearer mytoken" \
+#   -H "Content-Type: application/json" \
+#   -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bitmex_market_instrument","arguments":{"symbol":"XBTUSD"}}}' \
+#   http://localhost:3000/mcp
 ```
 
 ## System Prompt Guidance

skills/bitmex-multi-pair/SKILL.md

@@ -70,7 +70,7 @@ When you need per-symbol data not available in bulk (e.g., order book):
 SYMBOLS=("XBTUSD" "ETHUSD" "SOLUSD")
 for SYM in "${SYMBOLS[@]}"; do
   DEPTH=$(bitmex market orderbook "$SYM" --depth 1 -o json 2>/dev/null | \
-    jq '{symbol: .symbol, spread: (.asks[0][0] - .bids[0][0])}')
+    jq '{symbol: .[0].symbol, spread: (([.[] | select(.side == "Sell")] | .[0].price) - ([.[] | select(.side == "Buy")] | .[0].price))}')
   echo "$DEPTH"
   sleep 1  # stay within 300 req/5min budget
 done