opencode-skills-collection 4.1.15 → 4.1.16

package/bundled-skills/longbridge-market-data/references/capital.md

@@ -0,0 +1,48 @@
+# longbridge-capital-flow
+
+Today's capital flow time-series and order-size distribution for a single security.
+
+## Subcommands
+
+> A single `capital` command handles both modes — distribution snapshot (default) and time-series (`--flow`). Run `longbridge capital --help` to confirm.
+
+| CLI command                                        | Returns                                                                                |
+| -------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `longbridge capital <SYMBOL> --format json`        | Cross-section snapshot: large / medium / small / super-large order buy & sell amounts. |
+| `longbridge capital <SYMBOL> --flow --format json` | Today's main-capital net inflow / outflow time series.                                 |
+
+**Single symbol per call.** Today's data only — no historical range.
+
+## Workflow
+
+1. Resolve a single symbol to `<CODE>.<MARKET>`.
+2. Decide which mode: distribution snapshot (default), time-series (`--flow`), or both.
+3. Call the Longbridge CLI directly (preferred) or fall back to MCP.
+4. Summarise: net inflow direction (▲ / ▼), accumulated total, distribution skew. Cite Longbridge Securities.
+
+## CLI
+
+```bash
+longbridge capital NVDA.US                  --format json     # snapshot
+longbridge capital TSLA.US --flow           --format json     # time series
+# Combined view → call both and merge in the LLM
+```
+
+## Output
+
+The default snapshot returns a cross-section object; `--flow` returns a time-series array.
+
+Field translations (LLM should map):
+
+| Field (likely)           | 简体            | 繁體            | English                  |
+| ------------------------ | --------------- | --------------- | ------------------------ |
+| `large_in / large_out`   | 大单流入/流出   | 大單流入/流出   | Large order in/out       |
+| `medium_in / medium_out` | 中单流入/流出   | 中單流入/流出   | Medium order in/out      |
+| `small_in / small_out`   | 小单流入/流出   | 小單流入/流出   | Small order in/out       |
+| `super_in / super_out`   | 超大单流入/流出 | 超大單流入/流出 | Super-large order in/out |
+
+(Field names follow Longbridge JSON; LLM maps to the user's language.)
+
+## Error handling
+
+If `longbridge` is missing, fall back to MCP. Other stderr messages get relayed verbatim (auth issues → `longbridge auth login`; invalid symbol → re-check format).

package/bundled-skills/longbridge-market-data/references/depth.md

@@ -0,0 +1,40 @@
+# longbridge-depth
+
+Orderbook depth, broker queue (HK-only), and tick-by-tick trades.
+
+## Subcommands
+
+| Subcommand | Returns                                                                                                          |
+| ---------- | ---------------------------------------------------------------------------------------------------------------- |
+| `depth`    | 5 / 10-level orderbook: per-level price / volume / order_num                                                     |
+| `brokers`  | Per-level broker_id queue (**HK only**). Tell the user the queue is HK-only when they ask about a non-HK symbol. |
+| `trades`   | Latest N trades: time / price / volume / direction / type. Pass `--count 1..1000`.                               |
+
+`broker_id` integers can be translated to names via `longbridge-security-list` → `participants`.
+
+## Workflow
+
+1. Resolve the symbol to `<CODE>.<MARKET>`.
+2. Pick the subcommand by user intent (table above). For an "overview" intent, run `depth` + `brokers` (HK-only) + `trades` and merge.
+3. **Off-hours warning**: outside trading hours, `depth` is the closing snapshot and `trades` are the last N of the previous session — call this out explicitly when responding.
+4. Call the Longbridge CLI directly (preferred) or fall back to MCP.
+5. Render `depth` as a bid / ask table; describe `trades` as a direction summary (buy-dominant / sell-dominant) plus the latest few rows. Cite Longbridge Securities.
+
+## CLI
+
+```bash
+longbridge depth   700.HK                  --format json
+longbridge brokers 700.HK                  --format json   # HK-only
+longbridge trades  700.HK --count 50       --format json
+```
+
+Always pass `--format json` so the output is machine-parseable.
+
+## Output
+
+- `depth` / `brokers`: `{asks: [...], bids: [...]}` (`brokers[i]` includes a `broker_id` array)
+- `trades`: array of trade rows (`time / price / volume / direction / type`)
+
+## Error handling
+
+If `longbridge` is missing, fall back to MCP. If stderr surfaces _"broker queue not supported"_ / _"non-HK"_ on a `brokers` call, explain that broker queues are HK-only and switch to `depth`. Other stderr messages (auth / invalid symbol) get relayed verbatim.

package/bundled-skills/longbridge-market-data/references/exchange-rate.md

@@ -0,0 +1,35 @@
+# exchange-rate
+
+```
+Exchange rates for all supported currencies
+
+Example: longbridge exchange-rate Example: longbridge exchange-rate --format json
+
+Usage: longbridge exchange-rate [OPTIONS]
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge exchange-rate --format json
+
+# See all options
+longbridge exchange-rate --help
+```

package/bundled-skills/longbridge-market-data/references/fx-carry.md

@@ -0,0 +1,59 @@
+# longbridge-fx-carry
+
+FX carry-trade analysis — evaluate interest-rate differential, historical carry returns, and key risks for currency pairs.
+
+## Common carry pairs
+
+| Pair    | 高息货币 / High-yield | 低息货币 / Low-yield | 典型场景        |
+| ------- | --------------------- | -------------------- | --------------- |
+| AUD/JPY | AUD                   | JPY                  | Risk-on carry   |
+| NZD/USD | NZD                   | USD                  | Commodity carry |
+| MXN/JPY | MXN                   | JPY                  | EM carry        |
+| TRY/USD | TRY                   | USD                  | High-risk EM    |
+| BRL/JPY | BRL                   | JPY                  | EM carry        |
+
+> If unsure of exact flag names, run `longbridge <subcommand> --help` before proceeding.
+
+## Workflow
+
+1. Identify the carry pair(s) from the user's prompt; default to AUD/JPY, NZD/USD, MXN/JPY if unspecified.
+2. Fetch current spot rates for all relevant currencies.
+3. Look up prevailing benchmark interest rates (use embedded knowledge or `longbridge macro` if available).
+4. Calculate annualised carry yield: `(high-yield rate − low-yield rate)`.
+5. Fetch historical FX price data (60 days) to estimate realised volatility.
+6. Compute simplified Sharpe: `carry_yield / annualised_vol`.
+7. Assess tail-risk scenarios (rapid JPY strength / EM stress / risk-off unwind).
+8. Output structured summary.
+
+## CLI
+
+```bash
+# Spot exchange rates
+longbridge exchange-rate --format json
+
+# Historical FX price series (if supported by the CLI)
+longbridge kline <FX_PAIR> --period day --count 60 --format json
+```
+
+## Output
+
+Present for each pair:
+
+```
+Pair      Carry Yield   60d Volatility   Est. Sharpe   Signal
+─────────────────────────────────────────────────────────────
+AUD/JPY      3.2%           8.4%            0.38       Moderate
+NZD/USD      2.1%           6.2%            0.34       Moderate
+MXN/JPY      8.5%          14.1%            0.60       High / Risky
+```
+
+Follow with a narrative covering: current macro environment, carry unwind risks, position sizing guidance.
+
+## Error handling
+
+| Situation                       | 简体回复                                     | 繁體回復                                     | English reply                                                         |
+| ------------------------------- | -------------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------- |
+| FX pair not supported           | 该货币对暂不支持，请尝试其他主要货币对。     | 該貨幣對暫不支援，請嘗試其他主要貨幣對。     | This FX pair is not supported — try a major currency pair.            |
+| Historical FX data unavailable  | 历史汇率数据不可用，仅提供当前利差分析。     | 歷史匯率數據不可用，僅提供當前利差分析。     | Historical FX data unavailable — providing current differential only. |
+| `command not found: longbridge` | 请安装 longbridge-terminal 或通过 MCP 连接。 | 請安裝 longbridge-terminal 或透過 MCP 連線。 | Install longbridge-terminal or connect via MCP.                       |
+| `not logged in`                 | 请运行 `longbridge auth login`。             | 請執行 `longbridge auth login`。             | Run `longbridge auth login`.                                          |

package/bundled-skills/longbridge-market-data/references/intraday.md

@@ -0,0 +1,47 @@
+# intraday
+
+```
+Intraday minute-by-minute price and volume lines for today (or a historical date)
+
+Returns: timestamp, price, volume, turnover, `avg_price`. Use `--session all` to include pre-market and post-market lines. Use `--date YYYYMMDD` to fetch a historical day's intraday data. Example: longbridge intraday TSLA.US Example: longbridge intraday TSLA.US --session all Example: longbridge intraday TSLA.US --date 20240115
+
+Usage: longbridge intraday [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --session <SESSION>
+          Trade session filter: `intraday` (default) | `all` (includes pre/post market)
+
+          [default: intraday]
+
+      --date <DATE>
+          Historical date in YYYYMMDD format (omit for today's live data)
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge intraday --format json
+
+# See all options
+longbridge intraday --help
+```

package/bundled-skills/longbridge-market-data/references/ipo.md

@@ -0,0 +1,48 @@
+# ipo
+
+```
+IPO (new listings) commands — subscriptions, calendar, orders, profit/loss
+
+Example: longbridge ipo subscriptions Example: longbridge ipo calendar
+
+Usage: longbridge ipo [OPTIONS] <COMMAND>
+
+Commands:
+  subscriptions     List IPO stocks currently in filing or subscription stage
+  wait-listing      List IPO stocks in wait-listing (grey market) stage
+  listed            List recently listed IPO stocks
+  calendar          Show the IPO calendar (all upcoming and recent IPOs)
+  detail            Show IPO detail: profile and timeline for a symbol
+  orders            IPO orders (active + history) for the current account
+  profit-loss       Show IPO profit/loss summary and items for a period
+  us-subscriptions  List US IPO stocks currently in subscription stage
+  us-wait-listing   List US IPO stocks in wait-listing stage
+  us-listed         List recently listed US IPO stocks
+  help              Print this message or the help of the given subcommand(s)
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge ipo --format json
+
+# See all options
+longbridge ipo --help
+```

package/bundled-skills/longbridge-market-data/references/kline.md

@@ -0,0 +1,62 @@
+# longbridge-kline
+
+Historical candlesticks and today's intraday curve for Longbridge-supported securities (HK / US / A-share / Singapore). Does **not** support options, warrants, or indices — defer to `longbridge-derivatives` (derivatives) or `longbridge-quote` (indices).
+
+## Subcommands
+
+> Run `longbridge kline --help` to confirm current period values, defaults, and aliases.
+
+| CLI command                                                                                        | Use when                                                                           |
+| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `longbridge kline <SYMBOL> --period <P> --count <N> --format json`                                 | Latest N candles. Periods: `1m / 5m / 15m / 30m / 1h / day / week / month / year`. |
+| `longbridge kline history <SYMBOL> --start YYYY-MM-DD --end YYYY-MM-DD --period <P> --format json` | OHLCV across an explicit date range (sub-subcommand).                              |
+| `longbridge intraday <SYMBOL> --format json`                                                       | Today's per-minute curve (price + volume + avg_price).                             |
+
+Period aliases: `minute=1m`, `hour=1h`, `d/1d=day`, `w=week`, `m/1mo=month`, `y=year`. `--adjust none` (default) or `--adjust forward` for 前复权 / 前復權.
+
+## Workflow
+
+1. Resolve the symbol to `<CODE>.<MARKET>` (see `longbridge-quote` for the rules).
+2. Pick the form:
+   - Explicit start/end dates → `kline history`.
+   - "Today" / "intraday" → `intraday`.
+   - Otherwise → `kline` with sensible defaults (`--period day --count 100`).
+3. Map natural-language windows to (`period`, `count`). Examples: "最近一周" → `day,7`, "最近一年" → `day,252`, "月 K" → `month,100`.
+4. Call the Longbridge CLI directly (preferred) or fall back to MCP.
+5. Translate datasets into prose (range high / low, net move, volume note); use ▲ / ▼ for direction. Cite **Longbridge Securities** / **数据来源:长桥证券** / **數據來源:長橋證券**.
+
+## CLI
+
+```bash
+longbridge kline         NVDA.US --period day --count 100             --format json
+longbridge kline         700.HK  --period 5m  --count 100 --adjust forward --format json
+longbridge kline history NVDA.US --start 2025-01-01 --end 2025-12-31  --format json
+longbridge intraday      700.HK                                       --format json
+```
+
+## Output
+
+`longbridge kline ... --format json` returns a list of OHLCV rows:
+
+```json
+[
+  {
+    "time": "...",
+    "open": "...",
+    "high": "...",
+    "low": "...",
+    "close": "...",
+    "volume": "...",
+    "turnover": "..."
+  }
+]
+```
+
+`intraday` rows are `{time, price, volume, turnover, avg_price}`.
+
+## Error handling
+
+If `longbridge` is not installed, the shell returns a `command not found` error → fall back to MCP (see below) or tell the user to install longbridge-terminal. If `longbridge` prints `Error: ...` to stderr, surface the message to the user — common causes:
+
+- `Error: not logged in` / `unauthorized` → user runs `longbridge auth login`.
+- `Error: invalid symbol` / `param_error` → re-check the `<CODE>.<MARKET>` format.

package/bundled-skills/longbridge-market-data/references/market-status.md

@@ -0,0 +1,35 @@
+# market-status
+
+```
+Market open/close status for each exchange
+
+Example: longbridge market-status
+
+Usage: longbridge market-status [OPTIONS]
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge market-status --format json
+
+# See all options
+longbridge market-status --help
+```

package/bundled-skills/longbridge-market-data/references/market-temp.md

@@ -0,0 +1,53 @@
+# longbridge-market-temp
+
+Market-level state: open / close, calendar, sentiment temperature. Symbol-level questions belong in `longbridge-quote`.
+
+## Subcommands
+
+> The `MARKET` argument is **positional** (not a `--market` flag). Run `longbridge <subcommand> --help` to confirm.
+
+| CLI command                                                      | Returns                                                                                                     |
+| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `longbridge market-temp <MARKET> --format json`                  | Today's market temperature (0–100). Add `--history --start --end` for a time series. Default market = `HK`. |
+| `longbridge trading session --format json`                       | Trading sessions for all markets (open / close times).                                                      |
+| `longbridge trading days <MARKET> [--start --end] --format json` | Trading day calendar with half-days. Default market = `HK`.                                                 |
+
+## Market mapping
+
+LLM maps colloquial names to the positional `<MARKET>`:
+
+| User says                              | `<MARKET>`                 |
+| -------------------------------------- | -------------------------- |
+| 美股 / US / Nasdaq / S&P / Dow         | `US`                       |
+| 港股 / HK / Hang Seng / 恒生 / 恆生    | `HK`                       |
+| A 股 / 沪 / 深 / 上证 / 深证 / SH / SZ | `CN` (aliases: `SH`, `SZ`) |
+| 新加坡 / SG / Straits / 海峡 / 海峽    | `SG`                       |
+
+`trading session` does not take a market argument; it returns all markets in one call.
+
+## Workflow
+
+1. Pick the subcommand (table above).
+2. Resolve the positional `<MARKET>` if needed.
+3. For "is the market open?" — call `trading session`, then reason against the current local time (US = UTC-5/-4 DST, HK / CN / SG = UTC+8) and the user's target market.
+4. Call the Longbridge CLI directly (preferred) or fall back to MCP.
+5. Translate the `market-temp` value into wording: 0–30 _偏空_, 30–50 _中性偏空_, 50–70 _中性偏多_, 70–100 _偏多_ (translate into the user's language).
+
+## CLI
+
+```bash
+longbridge market-temp     HK                                          --format json
+longbridge trading session                                              --format json
+longbridge trading days    US --start 2026-04-28 --end 2026-05-31       --format json
+longbridge market-temp     HK --history --start 2026-01-01 --end 2026-04-28 --format json
+```
+
+## Output
+
+- `market-temp` (snapshot): single object with the temperature value. With `--history`, an array of historical points.
+- `trading session`: array spanning all markets.
+- `trading days`: `{trading_days, half_trading_days}` arrays for the selected market.
+
+## Error handling
+
+If `longbridge` is missing, fall back to MCP. Other stderr messages get relayed verbatim to the user.

package/bundled-skills/longbridge-market-data/references/participants.md

@@ -0,0 +1,35 @@
+# participants
+
+```
+Market maker (participant) broker IDs and names
+
+Use these IDs to interpret results from the `brokers` command.
+
+Usage: longbridge participants [OPTIONS]
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge participants --format json
+
+# See all options
+longbridge participants --help
+```

package/bundled-skills/longbridge-market-data/references/quote.md

@@ -0,0 +1,78 @@
+# longbridge-quote
+
+Real-time quote, static info, and valuation indices for Longbridge-supported securities (HK / US / A-share / Singapore).
+
+## Symbol format
+
+`<CODE>.<MARKET>`. Normalise before calling:
+
+| Pattern                        | Market        | Example                                                     |
+| ------------------------------ | ------------- | ----------------------------------------------------------- |
+| Uppercase ticker (US)          | `.US`         | `NVDA.US`, `AAPL.US`                                        |
+| 4-digit numeric                | `.HK`         | `700.HK`, `9988.HK`                                         |
+| 6-digit, starts `60`           | `.SH`         | `600519.SH`                                                 |
+| 6-digit, starts `00`/`30`      | `.SZ`         | `300750.SZ`                                                 |
+| Singapore ticker               | `.SG`         | `D05.SG`                                                    |
+| Chinese / English company name | use knowledge | 腾讯 → `700.HK`, 特斯拉 → `TSLA.US`, 贵州茅台 → `600519.SH` |
+
+If the market is ambiguous, **ask the user** rather than guessing.
+
+## Subcommands
+
+Run `longbridge --help` to see all available subcommands, then `longbridge <subcommand> --help` before calling. Types of data needed:
+
+- Real-time quote data (last price, open, high, low, prev close, volume, turnover, trade status)
+- Static reference data (name, industry, lot size, total/circulating shares, EPS, BPS, dividend yield, currency)
+- Valuation indices (PE, PB, turnover rate, total market cap, change rates, etc.)
+
+> **Always run `longbridge <subcommand> --help` first** — every Longbridge CLI subcommand self-documents its arguments, defaults, and examples. Do not hard-code flag names from this SKILL.md if the CLI version may have evolved.
+
+## Workflow
+
+1. Extract symbol(s) from the prompt; normalise each to `<CODE>.<MARKET>`.
+2. Run `longbridge --help` to identify available subcommands, then `longbridge <subcommand> --help` to confirm flags.
+3. Decide which subset of data is needed:
+   - **Quote only** (price / change / volume) → real-time quote subcommand
+   - **Static** (industry, market cap, EPS, BPS, dividend yield) → static reference subcommand
+   - **Indices** (PE, PB, turnover rate, etc.) → valuation index subcommand (check `--help` for supported field names)
+   - **Combined** ("full snapshot") → all three
+4. Run them (parallel is fine when supported by the agent runtime). Each command returns a JSON array keyed by symbol.
+5. Merge the per-symbol rows by `symbol` into a single object per security.
+6. Translate to natural language; cite the source as **Longbridge Securities** / **数据来源:长桥证券** / **數據來源:長橋證券**.
+
+## CLI examples
+
+```bash
+# Always check available flags first:
+longbridge <subcommand> --help
+
+# Then call with --format json — example structure (verify subcommand names and flags with --help):
+longbridge <quote-subcommand>      NVDA.US --format json
+longbridge <quote-subcommand>      NVDA.US 700.HK 600519.SH --format json   # multi-symbol
+longbridge <static-subcommand>     600519.SH --format json
+longbridge <calc-index-subcommand> NVDA.US --format json   # valuation indices; use --help for index field names
+```
+
+Run `longbridge <calc-index-subcommand> --help` to see all supported index field names. A reference cheat-sheet (with multilingual labels) lives in [references/calc-index-fields.md](references/calc-index-fields.md).
+
+## Output
+
+Each subcommand returns a JSON array, one object per requested symbol. Missing per-symbol values appear as `"-"` or `null` (not an error). When merging, key by `symbol` and emit a structure like:
+
+```json
+{
+  "symbol": "NVDA.US",
+  "quote":      { "last": "...", "prev_close": "...", "volume": "...", ... },
+  "static":     { "industry": "...", "eps": "...", "bps": "...", ... },
+  "calc_index": { "pe_ttm": "...", "pb": "...", "total_market_value": "...", ... }
+}
+```
+
+## Error handling
+
+| Situation                                         | LLM response                                                                                                                                              |
+| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Shell `command not found: longbridge`             | Fall back to MCP if configured (see below); otherwise tell the user to install [longbridge-terminal](https://github.com/longportapp/longbridge-terminal). |
+| stderr contains `not logged in` / `unauthorized`  | Tell the user to run `longbridge auth login`.                                                                                                             |
+| stderr contains `param_error` or "invalid symbol" | Re-check the `<CODE>.<MARKET>` format with the user.                                                                                                      |
+| Other stderr                                      | Surface verbatim — never silently retry.                                                                                                                  |

package/bundled-skills/longbridge-market-data/references/security-list.md

@@ -0,0 +1,36 @@
+# longbridge-security-list
+
+Catalog lookups: US overnight-eligible securities, and the HK broker_id → name dictionary.
+
+## Subcommands
+
+> Run `longbridge <subcommand> --help` to confirm the current flag spelling and defaults.
+
+| CLI command                              | Returns                                                          |
+| ---------------------------------------- | ---------------------------------------------------------------- |
+| `longbridge security-list --format json` | US overnight-eligible securities `[{symbol, name_en, name_cn}]`. |
+| `longbridge participants --format json`  | HK broker directory `[{broker_id, name_en, name_cn}]`.           |
+
+> ⚠️ **Scope**: `security-list` only exposes the US Overnight category (full HK / A-share / SG catalogs are not available through this endpoint). The CLI returns `Error: Only US market is supported for security-list ...` if you pass `HK / CN / SG`. For non-US listed lookups, route the user to `longbridge-quote` for per-symbol queries.
+
+## Usage rules
+
+- For "how many" questions, reply with the array length; do **not** dump the full payload.
+- For broker_id translation, find the matching row instead of dumping the whole directory.
+- For "list all stocks" requests in non-US markets, ask the user to narrow scope (industry, name search) and route them to `longbridge-quote`.
+
+## CLI
+
+```bash
+longbridge security-list      --format json
+longbridge participants       --format json
+```
+
+## Output
+
+- `security-list`: array of `{symbol, name_en, name_cn}` for US overnight-eligible names.
+- `participants`: array of `{broker_id, name_en, name_cn}` for HK brokers.
+
+## Error handling
+
+If `longbridge` is missing, fall back to MCP. If stderr says _"Only US market is supported for security-list"_ on a non-US market query, explain the scope limit to the user and offer per-symbol lookup via `longbridge-quote`. Other stderr messages relay verbatim.

package/bundled-skills/longbridge-market-data/references/subscriptions.md

@@ -0,0 +1,23 @@
+# longbridge-subscriptions
+
+Diagnostic listing of the active real-time subscriptions in the current `longbridge` CLI session.
+
+`default_install: false` — not installed by default. Manual symlink only.
+
+## CLI
+
+```bash
+longbridge subscriptions --format json
+```
+
+Returns an array of `{symbol, sub_types: [...], candlestick_periods: [...]}` for every active subscription in this CLI session.
+
+## Local-only
+
+The Longbridge MCP service is stateless HTTP — it has **no** WebSocket session concept and **no** equivalent tool. This skill requires the local `longbridge` CLI (which holds the OAuth + WebSocket session).
+
+If `longbridge` is not installed, tell the user this skill is local-only and they need to install longbridge-terminal.
+
+## Error handling
+
+If `longbridge` is missing, surface the message — there is no MCP fallback. If stderr says `not logged in`, tell the user to run `longbridge auth login`.

package/bundled-skills/longbridge-market-data/references/trade-stats.md

@@ -0,0 +1,39 @@
+# trade-stats
+
+```
+Trade statistics (price distribution by volume)
+
+Example: longbridge trade-stats 700.HK
+
+Usage: longbridge trade-stats [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge trade-stats --format json
+
+# See all options
+longbridge trade-stats --help
+```