@vike-io/cli 0.8.0 → 0.8.1

package/README.md

@@ -5,13 +5,26 @@
 [![npm version](https://img.shields.io/npm/v/@vike-io/cli.svg)](https://www.npmjs.com/package/@vike-io/cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org)
+[![skills.sh](https://skills.sh/b/vike-io/vike-cli)](https://skills.sh/vike-io/vike-cli)
 
 > **Command-line interface for the [vike.io](https://vike.io) API.** On-chain analytics, perpetuals, options flow, and prediction-market data across 11 chains — designed to be driven by AI agents (Claude Code, OpenClaw) as well as humans.
 
 ## Install
 
 ```bash
+# Standard install — gives you the `vike` binary
 npm install -g @vike-io/cli
+
+# OR install just the skill playbooks into your AI agent (Claude Code, Cursor,
+# Codex, Copilot, OpenCode and 50+ more — auto-detected):
+npx skills add vike-io/vike-cli
+```
+
+After `npm install`, you can also drop the skill into AI agents from the CLI itself:
+
+```bash
+vike install --all          # writes to ~/.claude/skills/vike/, .cursorrules,
+                            # .github/copilot-instructions.md, AGENTS.md
 ```
 
 ## Quick start
@@ -22,7 +35,7 @@ vike doctor                    # confirm everything works
 vike token search BTC          # your first query
 ```
 
-Get an API key at [vike.io/api/keys](https://vike.io/api/keys).
+Get an API key at [vike.io/account?tab=api-keys](https://vike.io/account?tab=api-keys).
 
 ## Commands at a glance
 
@@ -50,15 +63,24 @@ Run `vike schema --pretty` for the full command + flag reference.
 
 ## For AI agents
 
-This package ships **skill playbooks** under [`skills/`](skills/) — markdown files designed to be loaded by AI coding agents (Claude Code, OpenClaw, Cursor) so they know when and how to invoke each command.
+This package ships **41 skill playbooks** under [`skills/`](skills/) — markdown files designed to be loaded by AI coding agents (Claude Code, Cursor, Codex, Copilot, OpenCode, …) so they know when and how to invoke each command. They are grouped in [`skills.sh.json`](skills.sh.json) by domain (Tokens / Wallets / CEX perps / Hyperliquid / Options / Polymarket / Alerts / Web research).
 
-Skill entry points:
-- `vike-core` — install + auth + conventions (read first)
-- `vike-router` — decide which skill applies
-- `vike-token-research`, `vike-smart-money-discovery`, `vike-perp-funding-arb`, `vike-perp-screener`, `vike-hl-top-traders`, `vike-hl-trader-profile`, `vike-cross-venue-perps`, `vike-options-flow`, `vike-alerts-setup` — task playbooks
-- Per-tool skills for each command
+Three install paths, pick whichever fits your stack:
+
+```bash
+# 1. Install just the skill files for your agent (no Node binary needed):
+npx skills add vike-io/vike-cli                # auto-detects the agent
+npx skills add vike-io/vike-cli -a claude-code # explicit target
+npx skills add vike-io/vike-cli --list          # list all 41 first
+
+# 2. Use the CLI itself to install the umbrella skill into multiple agents:
+vike install --claude --cursor --copilot --agents
+
+# 3. Manual: point your agent at the skills/ folder of this npm package
+#    (lives at node_modules/@vike-io/cli/skills/ after install).
+```
 
-In Claude Code, the bundled skills are auto-discovered after `npm install -g @vike-io/cli`. In other harnesses, point the agent at the `skills/` folder of this package.
+Entry-point skill: `vike` (the umbrella) — auto-routes the user's question to the right specialized skill below. Bypass it and pick a specialized one if you know exactly which you need (e.g. `vike-hl-position-match` for reverse-lookup of an HL share card).
 
 ## Auth
 

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "AI-agent CLI for vike.io on-chain analytics, perps, options, and prediction markets across 11 chains",
   "type": "module",
   "main": "src/index.js",
@@ -14,7 +14,7 @@
     "src/**/*.js",
     "scripts/postinstall.js",
     "skills/**",
-    "SKILL.md",
+    "skills.sh.json",
     "CHANGELOG.md"
   ],
   "scripts": {

package/{SKILL.md → skills/vike/SKILL.md}

@@ -47,7 +47,7 @@ If the user has no API key yet, tell them:
 
 > **To use vike, you'll need a free API key:**
 >
-> 1. Visit https://vike.io/api/keys?utm_source=skill&utm_medium=ai&utm_campaign=cli_skill, sign in, and copy a key (starts with `vk_`).
+> 1. Visit https://vike.io/account?tab=api-keys&utm_source=skill&utm_medium=ai&utm_campaign=cli_skill, sign in, and copy a key (starts with `vk_`).
 > 2. Save it: `vike login --api-key vk_...` (or `export VIKE_API_KEY=vk_...`).
 > 3. Verify: `vike doctor`.
 >

package/skills/vike-core/SKILL.md

@@ -32,7 +32,7 @@ vike login --api-key vk_...        # non-interactive
 export VIKE_API_KEY=vk_...         # env (wins over saved config)
 ```
 
-Get an API key at https://vike.io/api/keys
+Get an API key at https://vike.io/account?tab=api-keys
 
 ## Verify
 

package/skills/vike-wallet-trace/SKILL.md

@@ -68,6 +68,16 @@ Tool credits = 4 per call (heavier than other graph-less tools). Graph explodes
 - Don't depth-5 by default. Graph blows up; results become noise.
 - Don't ignore `min_usd` — without it, dust transfers create false-positive edges.
 
+## Visual graph (web UI)
+
+When the user wants to *see* the network rather than read JSON, surface the URL:
+
+```
+https://vike.io/spot/wallet/<address>
+```
+
+Tell them to click the **Graph** tab. It renders the same trace data as a force-directed graph (nodes coloured by hop depth, sized by USD volume, animated directional particles on edges). Clicking any non-root node navigates to that wallet's graph. Use this in chat replies when the user says "show me", "visualize", or pastes a wallet address asking for an exploration view — JSON is for downstream pipelines, the URL is for humans.
+
 ## Pairs well with
 
 - `vike labels <addr>` — identify any interesting node

package/skills.sh.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://skills.sh/schemas/skills.sh.schema.json",
+  "notGrouped": "bottom",
+  "groupings": [
+    {
+      "title": "Quick start",
+      "description": "Start here. The umbrella skill auto-routes user questions to the right specialized skill below.",
+      "skills": [
+        "vike",
+        "vike-router",
+        "vike-core"
+      ]
+    },
+    {
+      "title": "Tokens",
+      "description": "Resolve, screen, and research tokens across 11 chains. Smart-money inflow, holders, recent transfers, OHLCV.",
+      "skills": [
+        "vike-token-search",
+        "vike-token-research",
+        "vike-token-transfers",
+        "vike-token-holders",
+        "vike-token-screener",
+        "vike-smart-money-discovery"
+      ]
+    },
+    {
+      "title": "Wallets",
+      "description": "Per-wallet profile, PnL, counterparty graphs, ENS, batch labelling, fund affiliation, DeFi positions.",
+      "skills": [
+        "vike-wallet-summary",
+        "vike-wallet-portfolio",
+        "vike-wallet-discover",
+        "vike-wallet-transactions",
+        "vike-wallet-counterparties",
+        "vike-wallet-trace",
+        "vike-wallet-compare",
+        "vike-wallet-batch",
+        "vike-wallet-pnl-history",
+        "vike-wallet-balances",
+        "vike-wallet-ens",
+        "vike-wallet-label-provenance",
+        "vike-fund-holdings",
+        "vike-defi-positions"
+      ]
+    },
+    {
+      "title": "CEX perps",
+      "description": "Funding-rate arb + cross-venue mark-price spreads across Binance, Bybit, OKX, Aster, Hyperliquid.",
+      "skills": [
+        "vike-perp-funding-arb",
+        "vike-perp-spread-arb",
+        "vike-perp-screener",
+        "vike-cross-venue-perps"
+      ]
+    },
+    {
+      "title": "Hyperliquid perps",
+      "description": "Deep on-chain HL coverage: top traders, full trader profiles, and share-card reverse-lookup.",
+      "skills": [
+        "vike-hl-top-traders",
+        "vike-hl-trader-profile",
+        "vike-hl-position-match"
+      ]
+    },
+    {
+      "title": "Options",
+      "description": "Deribit BTC/ETH options flow + put-call ratios.",
+      "skills": [
+        "vike-options-flow"
+      ]
+    },
+    {
+      "title": "Polymarket",
+      "description": "Prediction-market discovery, single-market deep-dives, trader profiles, and smart-money leaderboards.",
+      "skills": [
+        "vike-polymarket-markets",
+        "vike-polymarket-market-detail",
+        "vike-polymarket-trader",
+        "vike-polymarket-smart-money",
+        "vike-polymarket-screener"
+      ]
+    },
+    {
+      "title": "Alerts",
+      "description": "Create, list, edit, delete price + flow alerts; register HTTPS webhooks with HMAC delivery.",
+      "skills": [
+        "vike-alerts-setup",
+        "vike-alerts-webhook"
+      ]
+    },
+    {
+      "title": "Web research",
+      "description": "Off-chain context: general web search and AI-summarized URL fetch for news, docs, and social.",
+      "skills": [
+        "vike-web-search",
+        "vike-web-fetch",
+        "vike-web-research"
+      ]
+    }
+  ]
+}

package/src/auth.js

@@ -48,7 +48,7 @@ export function requireApiKey() {
   if (!key) {
     throw new Error(
       'No API key. Run `vike login --api-key <key>` or set VIKE_API_KEY. ' +
-      'Get a key at https://vike.io/api/keys',
+      'Get a key at https://vike.io/account?tab=api-keys',
     );
   }
   return key;

package/src/commands/auth.js

@@ -8,7 +8,7 @@ export function registerLogin(program) {
     .option('--api-key <key>', 'API key (vk_...)')
     .action(async (opts) => {
       if (!opts.apiKey) {
-        console.error('Pass --api-key <vk_...>. Get a key at https://vike.io/api/keys');
+        console.error('Pass --api-key <vk_...>. Get a key at https://vike.io/account?tab=api-keys');
         process.exitCode = 1;
         return;
       }

package/src/commands/init.js

@@ -15,7 +15,7 @@ export function registerInit(program) {
       if (!key) {
         const rl = createInterface({ input: stdin, output: stdout });
         try {
-          console.log('Get your API key at https://vike.io/api/keys');
+          console.log('Get your API key at https://vike.io/account?tab=api-keys');
           key = (await rl.question('Paste your API key (vk_...): ')).trim();
         } finally {
           rl.close();

package/src/commands/install.js

@@ -22,14 +22,17 @@ const BEGIN = '<!-- vike-skill:begin -->';
 const END = '<!-- vike-skill:end -->';
 
 function readSkillSource() {
-  // SKILL.md ships at the root of the npm package, two levels up from
-  // src/commands/install.js.
+  // Umbrella SKILL.md lives at skills/vike/SKILL.md (moved from the repo
+  // root so the skills-CLI auto-discovers all 40 nested skills instead of
+  // stopping at the root one). Fallback to the old root path keeps older
+  // installs working until they upgrade.
   const here = fileURLToPath(import.meta.url);
-  const candidate = resolve(dirname(here), '..', '..', 'SKILL.md');
-  if (!existsSync(candidate)) {
-    throw new Error(`SKILL.md not found at ${candidate}. Reinstall @vike-io/cli.`);
+  const root = resolve(dirname(here), '..', '..');
+  for (const rel of ['skills/vike/SKILL.md', 'SKILL.md']) {
+    const candidate = resolve(root, rel);
+    if (existsSync(candidate)) return readFileSync(candidate, 'utf8');
   }
-  return readFileSync(candidate, 'utf8');
+  throw new Error(`SKILL.md not found under ${root}. Reinstall @vike-io/cli.`);
 }
 
 function writeStandalone(path, skill) {