@vike-io/cli 0.5.0

package/skills/vike-hl-top-traders/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: vike-hl-top-traders
+description: Rank top Hyperliquid perp traders by PnL / ROI / win rate / volume / trade count / drawdown across a window. Use when the user asks "top HL traders" / "best Hyperliquid wallets" / "HL leaderboard".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-hl-top-traders
+
+## Command
+
+```bash
+vike perp top-traders
+  [--window 1d|7d|30d|all]
+  [--sort pnl|roi|win_rate|volume|trade_count|drawdown]
+  [--order asc|desc]
+  [--min-trades N]      # default 3
+  [--min-win-rate P]    # 0-100 percent
+  [--min-volume USD]
+  [--size N]            # max 20
+  [--json]
+```
+
+## Common queries
+
+| Question | Flags |
+|---|---|
+| "Top HL traders this week" | `--window 7d --sort pnl` |
+| "Best ROI traders last 30d w/ >=10 trades" | `--sort roi --min-trades 10` |
+| "Sharpshooters: win rate >75% min $1M vol" | `--sort win_rate --min-win-rate 75 --min-volume 1000000` |
+| "Most active traders today" | `--window 1d --sort trade_count` |
+| "Smallest drawdown winners" | `--sort drawdown --order asc --min-trades 20` |
+
+## Output columns
+
+`address`, `pnl_usd`, `roi_pct`, `win_rate_pct`, `volume_usd`, `trade_count`, `max_drawdown_usd`.
+
+## Reading
+
+- `roi_pct` here is **realized + unrealized** (uses live position marks).
+- A wallet with 90% win rate on 4 trades is statistical noise. Min trades 10–20 for any "skill" claim.
+- Top by PnL ≠ top by ROI. Whales win big in $ but small in % terms; ROI sort surfaces smaller-account discretionary skill.
+- `max_drawdown_usd` is peak-to-trough realized — does NOT include unrealized intra-position drawdown.
+
+## Anti-patterns
+
+- Don't claim a wallet is "the best HL trader" from a 1d window. Anything < 30d is short-term.
+- The leaderboard rewards survivors — wallets that blew up don't appear, so PnL distribution is right-skewed survivorship bias.
+
+## Pairs well with
+
+- `vike-hl-trader-profile` to drill into a specific address from the leaderboard
+- `vike-perp-funding-arb` to see if leaders are positioned against funding

package/skills/vike-hl-trader-profile/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: vike-hl-trader-profile
+description: Profile a single Hyperliquid perp trader — leaderboard rank, recent performance, on-chain identity. Use when the user gives an HL wallet address and asks "is this trader any good" / "profile this address" / "what's this wallet's HL track record".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-hl-trader-profile
+
+Composite profile combining ranking, identity, and trading metrics.
+
+## Steps
+
+### 1. On-chain identity + balance
+
+```bash
+vike wallet summary <address> --json
+```
+
+Captures: total volume, inflow/outflow, tx count, unique tokens across ETH/BSC/Base. Tells you if the address is HL-only or also active on spot chains.
+
+### 2. HL leaderboard rank
+
+```bash
+vike perp top-traders --window 30d --sort pnl --size 20 --json
+vike perp top-traders --window 7d  --sort pnl --size 20 --json
+```
+
+Search the returned rows for the address. Report rank if found, "outside top 20" otherwise.
+
+### 3. ROI + win rate context
+
+```bash
+vike perp top-traders --sort roi --window 30d --min-trades 10 --size 20 --json
+vike perp top-traders --sort win_rate --window 30d --min-trades 10 --size 20 --json
+```
+
+Same address-search; report rank or "not in top 20".
+
+## Verdict template
+
+> **`<address>` — Hyperliquid trader profile (30d)**
+> - PnL: `$X` (rank #Y of top 20) or (outside top 20)
+> - ROI: `Z%` (rank ...) or (outside top 20)
+> - Win rate: `W%` over N trades
+> - Spot activity: `<volume_usd>` total across ETH/BSC/Base, `<tokens>` unique
+> - Classification: **whale / sharp / volume / one-shot / unverified**
+
+## Classification heuristics
+
+| Pattern | Label |
+|---|---|
+| Top-20 PnL + high ROI + many trades + low DD | **Sharp** |
+| Top-20 PnL + low ROI + huge volume | **Whale** (size matters more than skill) |
+| Outside leaderboard + high win rate on <10 trades | **Unverified — too few data points** |
+| One big trade dominates PnL | **One-shot** (lucky directional bet) |
+| Wallet age < 30d | **Too new — re-check in a month** |
+
+## Anti-patterns
+
+- Don't claim "this is one of the best HL traders" from win rate alone — need volume + trade count for context.
+- A wallet outside the top 20 isn't bad — only ~0.01% of HL wallets make top 20 in any window.
+
+## Pairs well with
+
+- `vike-hl-top-traders` for the leaderboard context

package/skills/vike-options-flow/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: vike-options-flow
+description: Deribit options flow — call/put volume, put-call ratios, and direction signals for BTC / ETH / SOL. Use when the user asks "options flow on X" / "put call ratio" / "options positioning".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-options-flow
+
+## Command
+
+```bash
+vike options flow --symbol BTC|ETH|SOL [--window 1d|1w|1m] [--json]
+```
+
+Default: BTC, 1d.
+
+## Output
+
+Per-window aggregates: call volume, put volume, put-call ratio, net delta, open-interest deltas.
+
+## Reading the put-call ratio (PCR)
+
+| PCR (volume basis) | Read |
+|---|---|
+| < 0.5 | **Aggressive call buying** — bullish positioning, or call-overwrite unwind |
+| 0.5–0.8 | Normal bullish |
+| 0.8–1.2 | Balanced |
+| 1.2–1.8 | Bearish hedging or directional put buying |
+| > 1.8 | Heavy put demand — fear / hedge spike |
+
+PCR is **not a contrarian signal** on its own. Cross-reference with spot price action and funding:
+- High PCR + price falling + negative funding = real bearish capitulation
+- High PCR + price flat + positive funding = hedging into a rally (not panic)
+
+## Window choice
+
+- `1d` — intraday sentiment shifts, useful around major events
+- `1w` — positioning trend; cleaner read for narrative
+- `1m` — structural positioning; useful for IV-rank and term-structure context
+
+## Anti-patterns
+
+- Don't quote raw call/put volume without context — Deribit's BTC notional is in the tens of billions weekly; a $100M day means little in isolation.
+- Don't conflate flow (new positions) with open interest (cumulative). Flow is the change; OI is the stock.
+
+## Pairs well with
+
+- `vike-perp-funding-arb` for the corresponding perp positioning
+- `vike-perp-screener` for the broader market read

package/skills/vike-perp-funding-arb/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: vike-perp-funding-arb
+description: Find cross-venue funding-rate arbitrage opportunities on perpetual futures. Use when the user asks "any funding arb today" / "where to long-short X for funding" / "highest funding rates".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-perp-funding-arb
+
+Cross-venue funding rates across Binance, Bybit, OKX, Aster, and Hyperliquid.
+
+## Commands
+
+### A. All arb opportunities (default)
+
+```bash
+vike perp funding --json
+```
+
+Returns pre-ranked rows where the spread between the highest-funding venue and the lowest is ≥ 0.3% (daily normalized). Each row already includes:
+- `symbol`
+- `long_exchange`, `long_daily_pct` (pay funding here)
+- `short_exchange`, `short_daily_pct` (receive funding here)
+- `spread_daily_pct`
+
+**These are pre-ranked — just cite the top N rows directly. No further sorting needed.**
+
+### B. Single symbol per-venue rates
+
+```bash
+vike perp funding --symbol BTC --json
+```
+
+Returns one row per venue: `{exchange, funding_rate_daily_pct, mark_price, ...}`.
+
+## Reading the arb
+
+```
+spread_daily_pct = 0.42%   →  ~$420/day per $100k notional, gross
+                              (before fees, slippage, transfer costs)
+```
+
+A funding arb at 0.4–1% daily is real. > 3% daily on a liquid pair is almost always a halted-trading / venue-mispricing artifact — verify with `vike perp spreads --symbol <sym>` to make sure the underlying spot/perp prices are sane.
+
+## Anti-patterns
+
+- Don't quote a daily funding rate as "annualized" without converting (× 365). Some users expect annual; some daily; be explicit.
+- Funding flips every 1–8 hours depending on the venue. The number you see is the current-window rate, not a forecast — don't extrapolate without saying so.
+- Spread < 0.3% daily is filtered out at the source (not enough to cover fees + execution). Don't try to lower the filter; below that the trade doesn't work.
+
+## Pairs well with
+
+- `vike-perp-spread-arb` to confirm spot/perp basis is sane
+- `vike-cross-venue-perps` for the full per-venue picture on one symbol

package/skills/vike-perp-screener/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: vike-perp-screener
+description: Snapshot the current state of perpetual-futures markets — funding rates, cross-venue spreads, and HL leaderboard in one read. Use when the user asks "what's happening in perps today" / "perp market overview".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-perp-screener
+
+One-shot market overview for perpetuals.
+
+## Workflow (3 parallel calls)
+
+```bash
+vike perp funding --json &              # top funding-arb opportunities
+vike perp spreads --json &              # top spot-perp price spreads
+vike perp top-traders --window 1d --sort pnl --size 10 --json &
+wait
+```
+
+## Report template
+
+> **Perp market snapshot (last 24h)**
+>
+> **Top funding arbs (>0.3% daily spread)**
+> - `BTC`: long Bybit @ -0.5%/d, short Hyperliquid @ +0.8%/d → spread 1.3%/d
+> - ...
+>
+> **Top cross-venue price spreads (>0.5%)**
+> - `SOL`: buy Aster @ 138.20, sell OKX @ 139.05 → 0.61%
+> - ...
+>
+> **Top HL traders last 24h (by PnL)**
+> - `0xabc...` +$X, rank #1 — ...
+> - ...
+
+## When to skip the 3-call screener
+
+- User asked specifically about one symbol → use `vike-cross-venue-perps` instead.
+- User asked about a single trader → use `vike-hl-trader-profile`.
+
+## Anti-patterns
+
+- Don't quote funding rates in 8h chunks when the underlying API returns daily — be consistent (daily %).
+- "Top by PnL last 24h" is noise for swing-trader narratives; only useful for "who's hot right now". Use 7d or 30d for skill claims.
+
+## Pairs well with
+
+- `vike-options-flow` for the corresponding options positioning on BTC/ETH/SOL
+- `vike-perp-funding-arb` for the funding-only deep dive

package/skills/vike-perp-spread-arb/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: vike-perp-spread-arb
+description: Cross-venue perp price spread (buy on venue A, sell on venue B). Use when the user asks "any perp arb today" / "price differences across exchanges" / "where's X cheapest".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-perp-spread-arb
+
+## Command
+
+```bash
+vike perp spreads --json                 # full matrix, all symbols with spread >= 0.5%
+vike perp spreads --symbol BTC --json    # one specific symbol
+```
+
+## Output
+
+Pre-ranked rows: `symbol`, `buy_exchange`, `buy_price`, `sell_exchange`, `sell_price`, `spread_pct`.
+
+Outliers (> 400 bps off the cross-venue median) are filtered upstream — typically these are unit-mismatch listings like `1000SHIB` vs `SHIB`, or stale prices.
+
+## Reading
+
+`spread_pct = 0.7%` on a liquid pair = real arb opportunity, **before fees + transfer time**. Realistic net edge:
+- 30-60 bps after taker fees
+- Cross-venue settlement adds latency — fast inventory rotation matters more than per-trade size
+- Always check `vike-perp-funding-arb` for the same symbol — funding can amplify or kill the trade economics
+
+## Anti-patterns
+
+- Quoting a spread as "free money" without mentioning fees / transfer time
+- Trading 1000-token-suffix pairs without normalizing — `1000PEPE` on Binance ≠ `PEPE` on Bybit; if the spread looks insane it's probably this
+- Treating the buy/sell exchanges as static — the spreads update minute-by-minute; the row you see is current snapshot, not forecast
+
+## Pairs well with
+
+- `vike-perp-funding-arb` (combine for the full carry picture)
+- `vike-cross-venue-perps` for one-symbol depth

package/skills/vike-polymarket-market-detail/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: vike-polymarket-market-detail
+description: Deep-dive on a single Polymarket market — question, outcomes, current quotes, 24h volume, smart-money flows, top wallets active in it, resolution status. Use after vike-polymarket-markets when the user asks about a specific market.
+allowed-tools: Bash(vike:*)
+---
+
+# vike-polymarket-market-detail
+
+## Command
+
+```bash
+vike polymarket market <condition_id> [--json]
+```
+
+`condition_id` is a hex string (you'll have it from `vike polymarket markets` output).
+
+## Example
+
+```bash
+vike polymarket markets --category Crypto --limit 5 --json
+#   → pick a condition_id from the output, then:
+vike polymarket market 0x1234abcd...
+```
+
+## What it returns
+
+- Market metadata: question, slug, category, end_date, fee_rate_bps
+- Current quotes for both outcomes (Yes / No mid / bid / ask)
+- 24h volume + liquidity
+- Smart-money cohort activity on this specific market (recent net flow)
+- Top wallets (by trade count or volume) active here
+- Resolution status (resolved / open / awaiting resolution)
+
+## Anti-patterns
+
+- Don't claim a market is "manipulated" from cohort flow alone. High cohort buy ≠ insider info — it might just be popular among the cohort.
+- Resolution-pending markets can show stale mids. Cross-check with `last_traded` timestamp.
+
+## Pairs well with
+
+- `vike-polymarket-trader` — profile any interesting wallet you find in the top-wallets list
+- `vike-polymarket-smart-money mode=mispricings` — markets where cohort bought below current mid

package/skills/vike-polymarket-markets/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: vike-polymarket-markets
+description: List trending Polymarket prediction markets ranked by 24h volume, filterable by category (Crypto / Sports / Politics / Pop-Culture / Tech). Use when the user asks "what's hot on Polymarket" / "top crypto prediction markets" / "trending markets today".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-polymarket-markets
+
+## Command
+
+```bash
+vike polymarket markets [--category C] [--limit N] [--json]
+```
+
+`C` is one of: `Crypto`, `Sports`, `Politics`, `Pop-Culture`, `Tech`, `all` (default).
+
+## Examples
+
+```bash
+vike polymarket markets --category Crypto --limit 10
+vike polymarket markets --category Politics --limit 20
+vike pm markets --json                    # `pm` alias
+```
+
+## Output columns
+
+`condition_id`, `slug`, `question`, `end_date`, `market_vol_24h` (USD), `liquidity`, plus per-outcome `outcome` / `mid` / `bid` / `ask` for both Yes and No legs.
+
+## Reading the data
+
+- `mid` is the midpoint price as a probability (0.0 to 1.0). `0.42` means "the market thinks 42% chance".
+- A bid/ask spread > 0.05 (5 cents) = thin liquidity; the price is noisier.
+- `end_date` is when the market resolves. Sort priority for action-oriented users: markets ending in the next 7 days.
+
+## Anti-patterns
+
+- Don't quote `mid` as a percentage without saying so. "Yes is 0.42" is the raw probability; "42% chance" is the user-friendly translation.
+- For tiny markets (<$50k 24h volume) the quotes are often stale or one-sided. Skip them unless explicitly asked.
+
+## Pairs well with
+
+- `vike-polymarket-market-detail` — deep-dive on one market once you have its condition_id
+- `vike-polymarket-smart-money` — see which markets cohort wallets are buying/selling
+- `vike-polymarket-screener` — composite multi-call screener

package/skills/vike-polymarket-screener/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: vike-polymarket-screener
+description: Polymarket market screener combining trending markets + smart-money flows + mispricings in one pass. Use when the user asks "give me a Polymarket overview" / "what's happening in prediction markets today".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-polymarket-screener
+
+Composite playbook — 3 parallel calls for a complete prediction-market snapshot.
+
+## Workflow
+
+```bash
+vike polymarket markets --category all --limit 10 --json &
+vike polymarket smart-money --mode flows --hours 24 --json &
+vike polymarket smart-money --mode mispricings --hours 24 --json &
+wait
+```
+
+## Report template
+
+> **Polymarket snapshot (last 24h)**
+>
+> **Top 5 trending markets by volume**
+> - `<question>` (`<category>`) — Yes mid `<m>`, 24h vol `$X` — ends `<date>`
+> - ...
+>
+> **Top 5 smart-money inflows**
+> - `<title>` (`<slug>`) — `<smart_wallets>` cohort wallets, net inflow `$X`, latest Yes mid `<m>`
+> - ...
+>
+> **Top 5 mispricings**
+> - `<title>` (`<side>`) — cohort avg buy `<p>`, current mid `<m>`, delta `<d>%`, cohort buy `$X`
+> - ...
+
+## When to use the focused skill instead
+
+| User asked | Use |
+|---|---|
+| "What's hot on Polymarket" (just lists) | `vike-polymarket-markets` only |
+| "Profile this PM wallet" | `vike-polymarket-trader` |
+| "Deep-dive market X" | `vike-polymarket-market-detail` |
+| "Smart-money signals" | `vike-polymarket-smart-money` |
+| "Full overview" or "give me everything" | This skill |
+
+## Cost note
+
+3 parallel tool calls = ~5 credits total.
+
+## Anti-patterns
+
+- Don't report all three sections if the user asked a narrower question. Trim aggressively.
+- Trending markets sorted by volume include resolved markets that closed earlier today — verify `end_date` if you're recommending a position.
+- `mispricings` mode requires `--hours` to be ≥ 6 for stable signal; below that, intraday noise dominates.
+
+## Pairs well with
+
+- `vike-polymarket-trader` — drill into any interesting wallet
+- `vike-polymarket-market-detail` — drill into any flagged market

package/skills/vike-polymarket-smart-money/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: vike-polymarket-smart-money
+description: Smart-money signals on Polymarket. Two modes — flows (markets with largest net cohort inflow) or mispricings (markets where cohort bought meaningfully below current mid). Use when the user asks "what is smart money buying on Polymarket" or "any prediction-market alpha".
+allowed-tools: Bash(vike:*)
+---
+
+# vike-polymarket-smart-money
+
+The "smart-money cohort" is wallets meeting all three criteria:
+- ≥ $1,000 lifetime realized PnL
+- ≥ 5 resolved markets (so hit-rate is meaningful)
+- ≥ $5,000 lifetime volume
+
+## Command
+
+```bash
+vike polymarket smart-money --mode flows|mispricings [--hours N] [--category C] [--limit N] [--json]
+```
+
+## Mode A — flows (default)
+
+```bash
+vike polymarket smart-money --mode flows --hours 24 --category all
+```
+
+Markets with the largest **net buy** from cohort wallets in the last N hours.
+`net_flow = buy_inflow - sell_outflow`. Useful for "where is smart money concentrating today".
+
+Output: `condition_id`, `title`, `slug`, `smart_wallets` (cohort count), `buy_inflow_usd`, `sell_outflow_usd`, `trades`, `latest_yes_mid`.
+
+## Mode B — mispricings
+
+```bash
+vike polymarket smart-money --mode mispricings --hours 24 --category Crypto
+```
+
+Markets where cohort wallets recently bought meaningfully **below** the current mid — i.e. the market has moved away from where cohort got their fills.
+
+Output: `condition_id`, `title`, `slug`, `side` (Yes or No), `smart_avg_buy`, `current_mid`, `delta_pct`, `smart_buy_usd`.
+
+`delta_pct > 5` = cohort got in 5+ cents better than current. Potential edge if you think cohort was right.
+
+## Reading
+
+- **Flows**: high net inflow + low `smart_wallets` count = concentrated bet (few wallets, big size). Higher conviction signal than diffuse inflow across 50 wallets.
+- **Mispricings**: high `delta_pct` is interesting only when paired with cohort that has a history in that category. Cross-check with `vike-polymarket-trader` on the top wallets.
+
+## Anti-patterns
+
+- Don't treat "smart-money cohort" as omniscient. They're filtered for past performance — survivorship bias applies, especially in fast-moving political markets.
+- Mispricings can be slow-to-resolve. A 5% mispricing on a market resolving in 3 months might be efficient pricing for tail risk, not edge.
+- Don't combine the cohort definition with strict ROI filters — the cohort is built on realized PnL, not Sharpe.
+
+## Pairs well with
+
+- `vike-polymarket-market-detail` — drill into a flagged market
+- `vike-polymarket-trader` — profile the top wallets active in flagged markets
+- `vike-polymarket-screener` — full multi-call market scan

package/skills/vike-polymarket-trader/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: vike-polymarket-trader
+description: Profile a Polymarket wallet — realized PnL across 24h / 7d / 30d / all, hit-rate on resolved markets, total volume, top categories traded, recent positions. Use when the user gives a Polymarket wallet address.
+allowed-tools: Bash(vike:*)
+---
+
+# vike-polymarket-trader
+
+## Command
+
+```bash
+vike polymarket wallet <address> [--window 24h|7d|30d|all] [--json]
+```
+
+## Example
+
+```bash
+vike polymarket wallet 0xabcdef1234... --window 30d
+vike pm wallet 0xabcdef1234... --json     # `pm` alias
+```
+
+## Output
+
+Per-wallet summary:
+- `realized_pnl_usd` (lifetime + windowed)
+- `hit_rate_pct` (resolved markets only)
+- `resolved_markets` (count — denominator for hit_rate)
+- `volume_all_usd`, `volume_<window>_usd`
+- `trades_all`, `trades_<window>`
+- Category breakdown (Crypto/Sports/Politics/etc.)
+- Last seen timestamp
+
+## Reading
+
+| Pattern | Read |
+|---|---|
+| `hit_rate_pct > 60` with `resolved_markets > 20` | **Skilled** — consistent over a real sample |
+| `hit_rate_pct > 80` with `resolved_markets < 10` | **Lucky — too few data points** |
+| Positive PnL but `hit_rate_pct < 50` | **Asymmetric bettor** — wins big when right, loses small |
+| Negative PnL with high volume | **Volume trader / MM-style** — pays the spread |
+| One category dominates >80% of activity | **Specialist** — only trust their reads in that category |
+
+## Hit-rate caveat
+
+`hit_rate_pct` is computed only on **resolved** markets. A wallet with 100 trades but only 5 resolved has a hit_rate based on those 5. Always inspect `resolved_markets` before quoting hit_rate.
+
+## Anti-patterns
+
+- Don't claim "this trader is good at predictions" from <10 resolved markets. Below that, hit_rate is noise.
+- Multi-category specialists are rare. If the wallet trades 5+ categories, treat hit_rate as a generic "good at probabilities" signal, not "deep edge".
+
+## Pairs well with
+
+- `vike-polymarket-market-detail` — see which markets they're currently in
+- `vike-polymarket-smart-money` — confirm they're in the smart-money cohort

package/skills/vike-router/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: vike-router
+description: Entry point — decide which vike skill to use. Read this first when the user asks anything about on-chain analytics, perps, options, prediction markets, wallets, or tokens.
+allowed-tools: Bash(vike:*)
+---
+
+# vike-router
+
+Route the user's question to the right `vike-*` skill.
+
+## Routing table
+
+| User asks about ... | Use skill |
+|---|---|
+| Token by symbol/name → address | `vike-token-search` |
+| Token holders / who bought / sold | `vike-token-transfers` |
+| Token price chart / OHLCV | `vike-token-research` |
+| Generic token research (everything) | `vike-token-research` |
+| Single wallet's metrics | `vike-wallet-summary` |
+| Top wallets / leaderboard | `vike-wallet-discover` |
+| "Find smart money on X" | `vike-smart-money-discovery` |
+| Perp funding rates / arb opportunities | `vike-perp-funding-arb` |
+| Cross-venue perp price spreads | `vike-perp-spread-arb` |
+| Top Hyperliquid perp traders | `vike-hl-top-traders` |
+| Profile a single HL perp trader | `vike-hl-trader-profile` |
+| HL market overview (vol/OI/funding) | `vike-perp-screener` |
+| Compare a symbol across all perp venues | `vike-cross-venue-perps` |
+| Deribit options flow / put-call ratios | `vike-options-flow` |
+| Create / list / edit alerts | `vike-alerts-setup` |
+| Auth / setup / "I just installed it" | `vike-core` |
+
+## Quick command map
+
+```
+vike token   search | transfers | chart
+vike wallet  summary | discover
+vike perp    funding | spreads | top-traders
+vike options flow
+vike alerts  list | channels | create | edit | delete
+vike init | doctor | schema | whoami | login | logout
+```
+
+## Bias
+
+- If unsure between two skills, prefer the **task skill** (specific workflow) over the **per-tool skill** (single command).
+- If the user wants raw data, use the per-tool skill with `--json`.
+- If the user is exploring, lead with `vike schema --pretty` to show what's available.
+
+## Cost note
+
+Cheap (free-tier safe): `token search`, `wallet summary`, `alerts list`, `schema`, `doctor`, `whoami`.
+
+Heavier (count against quota): `wallet discover` (full pages), `perp top-traders` (large filters), `token transfers` (long periods).