opencode-skills-collection 4.1.14 → 4.1.16

package/bundled-skills/longbridge-fundamentals/references/operating.md

@@ -0,0 +1,42 @@
+# operating
+
+```
+Operating reviews and financial indicators by report period (HK stocks only)
+
+Example: longbridge operating 700.HK Example: longbridge operating 700.HK --report q1
+
+Usage: longbridge operating [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --report <REPORT>
+          Report kind filter: af | saf | q1 | q3 (comma-separated for multiple)
+
+      --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 operating --format json
+
+# See all options
+longbridge operating --help
+```

package/bundled-skills/longbridge-fundamentals/references/smallcap-growth.md

@@ -0,0 +1,72 @@
+# longbridge-smallcap-growth
+
+Screens for overlooked small/mid-cap high-growth stocks across US, HK, and A-share markets using quantitative filters (market cap, revenue growth, ROE) and qualitative overlays (sector focus, 专精特新 category for A-shares).
+
+## Default screening criteria
+
+| Criterion               | Default threshold      | User-adjustable |
+| ----------------------- | ---------------------- | --------------- |
+| Market cap (US/HK)      | < USD 10B              | Yes             |
+| Market cap (A-share)    | < CNY 50B              | Yes             |
+| Revenue YoY growth      | > 30%                  | Yes             |
+| ROE                     | > 15%                  | Yes             |
+| Institutional ownership | Low (qualitative flag) | Note only       |
+
+Ask the user if they want to adjust any threshold before running.
+
+## Workflow
+
+1. Clarify market (US / HK / A-share / all) and any sector preference.
+2. Fetch index constituents for the relevant small/mid-cap indices (e.g. `IWM.US` for Russell 2000, `399006.SZ` for ChiNext, `399005.SZ` for SME Board).
+3. For each constituent, fetch market cap via `calc-index` and filter by size.
+4. For size-passing candidates, fetch the latest income statement to check revenue growth.
+5. Further filter by ROE from the balance sheet / financial-report data.
+6. Return the top 10 candidates ranked by revenue growth rate, with a brief profile for each.
+
+## CLI
+
+> If you're unsure of exact flag names or defaults, run `longbridge <subcommand> --help` first.
+
+```bash
+# Small/mid-cap index constituents
+longbridge constituent <INDEX_SYMBOL> --format json
+# Examples: IWM.US (Russell 2000), 399006.SZ (ChiNext), HSI.HK (Hang Seng)
+
+# Market cap and valuation indices per symbol
+longbridge calc-index <SYMBOL> --format json
+
+# Latest income statement (revenue growth)
+longbridge financial-report <SYMBOL> --kind IS --format json
+
+# News / recent catalysts for top candidates
+longbridge news <SYMBOL> --format json
+```
+
+## Output
+
+**Screening parameters**: market, sector, market cap threshold, revenue growth threshold, ROE threshold
+
+**Top candidates table**:
+
+| Rank | Symbol | Company | Market Cap | Rev Growth YoY | ROE | Sector | Thesis |
+| ---- | ------ | ------- | ---------- | -------------- | --- | ------ | ------ |
+
+For each top 5 candidate, include a brief (3–4 sentence) investment thesis:
+
+- Business model and competitive advantage
+- Growth driver and runway
+- Key risk
+- Catalyst to watch
+
+**A-share note**: For 专精特新 (specialized, sophisticated, distinctive, innovative) classification, note if the company holds a national-level 专精特新小巨人 designation when mentioned in filings/news.
+
+**Disclaimer**: Small-cap stocks carry higher liquidity and volatility risk. Not a buy recommendation.
+
+## Error handling
+
+| Situation                        | Simplified Chinese                           | Traditional Chinese / English                                  |
+| -------------------------------- | -------------------------------------------- | -------------------------------------------------------------- |
+| `command not found: longbridge`  | 回退到 MCP；否则提示安装 longbridge-terminal | 回退到 MCP；否則提示安裝 / Fall back to MCP; prompt to install |
+| `not logged in` / `unauthorized` | 请运行 `longbridge auth login`               | 請運行 `longbridge auth login` / Run `longbridge auth login`   |
+| No market specified              | 请告知目标市场（美股/港股/A股）              | 請告知目標市場 / Please specify market (US/HK/A-share)         |
+| Other stderr                     | 原样展示错误，不重试                         | 原樣展示，不重試 / Surface verbatim, no silent retry           |

package/bundled-skills/longbridge-fundamentals/references/valuation-methodology.md

@@ -0,0 +1,86 @@
+# longbridge-valuation-methodology
+
+A structured framework for selecting and applying valuation methods to listed companies using Longbridge data — from quick relative multiples to full DCF/SOTP builds.
+
+## Workflow
+
+1. Identify the company's industry and growth stage to select the appropriate method.
+2. Fetch current valuation multiples: run `longbridge valuation <SYMBOL> --format json` (verify flags with `--help`).
+3. Fetch industry context: run `longbridge industry-valuation <SYMBOL> --format json`.
+4. Fetch income statement for margin/growth inputs: run `longbridge financial-report <SYMBOL> --kind IS --format json`.
+5. Apply the framework table below; explain selected method(s), assumptions, and output.
+
+## Valuation method selection guide
+
+| Scenario                                | Preferred method | Why                                     |
+| --------------------------------------- | ---------------- | --------------------------------------- |
+| Stable earnings, mature company         | PE-Band / PB     | Simple; market-anchored                 |
+| Asset-heavy (banks, insurance)          | PB-ROE           | Book value reflects true asset base     |
+| Capital-intensive (telecom, utilities)  | EV/EBITDA        | Strips out D&A and leverage differences |
+| High-growth, pre-profit (biotech, SaaS) | PS / DCF         | No earnings yet; revenue is the anchor  |
+| Conglomerate / multi-segment            | SOTP             | Each segment deserves its own multiple  |
+| Dividend-paying mature company          | DDM              | Intrinsic value from future dividends   |
+| Asset-rich company (property)           | NAV              | Book value adjusted to market prices    |
+
+## Method details
+
+### Relative valuation
+
+**PE-Band**: Plot trailing/forward PE against 1–3 year historical mean ± 1SD. Buy signal when PE < mean - 1SD, stretched when > mean + 1SD. Use `longbridge valuation <SYMBOL> --format json` for historical percentile.
+
+**PB-ROE**: High ROE justifies high PB. Plot PB vs ROE scatter across peers. Companies above the regression line are expensive; below are cheap. Fetch ROE from `longbridge financial-report <SYMBOL> --kind IS --format json`.
+
+**EV/EBITDA**: Enterprise-value based; immune to capital structure. Use for cross-border comparisons. EV = market cap + net debt; EBITDA from IS + D&A line.
+
+**PS**: Revenue multiple. Useful when earnings are negative. Compress to gross-profit multiple (EV/GP) for SaaS with different gross margins.
+
+### Absolute valuation
+
+**DCF**: Project free cash flows → discount at WACC → add terminal value. Full workflow in `longbridge-dcf`.
+
+**DDM**: `P = D₁ / (r - g)`. Best for high-dividend stocks (utilities, HK REITs). Inputs: next dividend (D₁), cost of equity (r), long-run dividend growth (g).
+
+**SOTP**: Segment A value + Segment B value + Net cash − Holding discount. Requires segment-level revenue/EBIT from financial reports.
+
+## Common pitfalls
+
+- Using PE for loss-making companies — use PS or EV/Sales instead.
+- Anchoring WACC to an arbitrary 10% — verify Beta and risk-free rate.
+- Ignoring net debt in EV/EBITDA — EV must include all debt and minority interests.
+- Applying a single PE without cyclicality adjustment — use normalized or mid-cycle earnings.
+- SOTP double-counting — ensure holding-company cash is not counted twice.
+
+## CLI
+
+```bash
+# Verify available flags first
+longbridge valuation --help
+longbridge industry-valuation --help
+longbridge financial-report --help
+
+# Fetch current multiples
+longbridge valuation <SYMBOL> --format json
+
+# Industry context
+longbridge industry-valuation <SYMBOL> --format json
+
+# Income statement for margin/growth
+longbridge financial-report <SYMBOL> --kind IS --format json
+```
+
+## Output
+
+Present:
+
+1. Recommended valuation method(s) with rationale.
+2. Current multiple vs historical percentile vs industry median.
+3. Fair-value range under each method with key assumptions.
+4. Summary: cheap / fair / expensive verdict with caveats.
+
+## Error handling
+
+| Situation                       | 简体回复                                           | 繁體回覆                                      | English reply                                                              |
+| ------------------------------- | -------------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------- |
+| `command not found: longbridge` | 请安装 longbridge-terminal，或检查 MCP 配置。      | 請安裝 longbridge-terminal，或檢查 MCP 配置。 | Install longbridge-terminal or check MCP config.                           |
+| stderr: `not logged in`         | 请运行 `longbridge auth login`。                   | 請執行 `longbridge auth login`。              | Run `longbridge auth login`.                                               |
+| No valuation data for symbol    | 该标的暂无估值数据，请检查代码格式（如 AAPL.US）。 | 該標的暫無估值數據，請確認代碼格式。          | No valuation data for this symbol; check the ticker format (e.g. AAPL.US). |

package/bundled-skills/longbridge-fundamentals/references/valuation-rank.md

@@ -0,0 +1,57 @@
+# longbridge-valuation-rank
+
+Prompt-only skill. Fetches the **time series of a stock's valuation rank within its industry** — each data point shows where the stock sits among peers (e.g., rank 3 out of 28) for PE, PB, PS, and dividend yield.
+
+## CLI
+
+Run `longbridge valuation-rank --help` to verify exact flags. Common calls:
+
+```bash
+# Past 1 year (default) — PE / PB / PS / dividend-yield ranks
+longbridge valuation-rank AAPL.US --format json
+
+# Custom date range
+longbridge valuation-rank AAPL.US --start 20250101 --end 20251231 --format json
+longbridge valuation-rank 700.HK --start 20240101 --end 20251231 --format json
+
+# Help — always verify flags
+longbridge valuation-rank --help
+```
+
+## Workflow
+
+1. **Resolve symbol** to `<CODE>.<MARKET>` format.
+2. **Run** `longbridge valuation-rank <SYMBOL> --format json` (add `--start` / `--end` if the user specifies a range; otherwise omit for the default 1-year window).
+3. **Parse** the time series. Each data point includes a `timestamp` and sub-objects for `pe`, `pb`, `ps`, `dvd` — each containing `rank` and `total`.
+4. **Compute trend** for each indicator:
+   - Direction: is rank rising (improving relative valuation) or falling (deteriorating)?
+   - Percentile at each point: `(total − rank + 1) / total × 100%` → lower rank = lower PE = cheaper.
+   - Identify any notable inflection points (large rank jumps).
+5. **Present** as a summary table + trend narrative; omit indicators where data is sparse.
+
+## Output
+
+**AAPL.US — Industry valuation rank history (past 1 year)**
+Source: Longbridge Securities
+
+```
+Date       | PE rank | PB rank | PS rank | Dvd rank | Peers (n)
+2025-01-31 |  8 / 32 |  5 / 32 | 12 / 32 |  28 / 32 | 32
+2025-02-28 |  9 / 32 |  5 / 32 | 11 / 32 |  27 / 32 | 32
+…
+```
+
+_Trend summary_: PE rank improved from 12→8 (valuation became relatively cheaper vs peers) over the period; dividend yield rank remained near bottom (low yield vs peers).
+
+⚠️ 排名数据仅供参考，不构成投资建议。
+⚠️ 排名數據僅供參考，不構成投資建議。
+⚠️ For reference only. Not investment advice.
+
+## Error handling
+
+| Situation                       | 简体中文回复                                              | 繁體中文 / English                                                                                                   |
+| ------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `command not found: longbridge` | 回退到 MCP；如也不可用，请安装 longbridge-terminal。      | 回退到 MCP；如也不可用，請安裝 longbridge-terminal。/ Fall back to MCP; if unavailable, install longbridge-terminal. |
+| `valuation-rank` returns empty  | "{symbol} 暂无行业估值排名数据，可能不支持该市场或标的。" | "{symbol} 暫無行業估值排名。" / "{symbol} has no industry valuation rank data."                                      |
+| `total` = 0 or null             | 跳过该指标，注明无同行数据。                              | 跳過該指標，注明無同行數據。/ Skip the indicator and note no peer data.                                              |
+| Other stderr                    | 直接显示原始错误，不静默重试。                            | 顯示原始錯誤。/ Surface verbatim — do not retry silently.                                                            |

package/bundled-skills/longbridge-fundamentals/references/valuation.md

@@ -0,0 +1,86 @@
+# longbridge-valuation
+
+Prompt-only analysis skill. Orchestrates Longbridge CLI commands to answer _"is X expensive?"_ across three dimensions: current snapshot, historical percentile, industry context.
+
+## CLI
+
+Run `longbridge --help` to see all available subcommands, then `longbridge <subcommand> --help` before calling. Types of data needed (run concurrently):
+
+- Current valuation snapshot + peer comparison
+- Historical valuation series (PE, PB — run `--help` for available indicators and range flags)
+- Daily industry percentile rank for PE / PB / PS (run `--help` for date range flags)
+- Industry median + distribution
+- Industry percentile distribution
+- Optional intraday valuation correction (for live mid-day prices — run `--help` for the relevant subcommand)
+
+```bash
+longbridge <subcommand> TSLA.US --format json   # run --help for available flags and subcommand names
+```
+
+## Workflow
+
+1. **Resolve symbol** to `<CODE>.<MARKET>` (rules in `longbridge-quote`). Multiple symbols → route to `longbridge-peer-comparison`.
+2. **Concurrently call** CLI commands above. If `longbridge` is not installed, fall back to MCP (see MCP fallback section).
+3. Optional intraday correction (only when needed): run `longbridge --help` to find the subcommand for live intraday valuation — note that the standard valuation subcommand is often EOD only.
+
+4. **Compute** in the LLM:
+
+   | Quantity                 | Method                                                                                                         |
+   | ------------------------ | -------------------------------------------------------------------------------------------------------------- |
+   | Historical PE percentile | prefer the daily valuation-rank series from CLI; fallback: rank current PE against historical valuation series |
+   | Historical PB percentile | same                                                                                                           |
+   | Industry premium         | `(current PE − industry median PE) / industry median PE`                                                       |
+   | Industry rank            | bucket from industry valuation distribution data                                                               |
+
+   If history is sparse (< 1y) or the industry has fewer than 5 peers, **degrade gracefully** — show snapshot + relative-to-industry only, drop the percentile claim.
+
+5. **Output the three sections** (template below). Cite **Longbridge Securities**.
+
+## Output template
+
+```
+{Symbol} ({code}) valuation snapshot — Source: Longbridge Securities
+
+[Current snapshot]
+- PE (TTM): X
+- PB:        X
+- PS:        X
+- EV/EBITDA: X (if available)
+- Dividend yield: X%
+
+[Historical (past 3y)]
+- PE in N-th percentile (low / mid / high)
+- PB in N-th percentile
+
+[Industry (N peers)]
+- Industry median PE: X → currently {premium/discount} of N%
+- Industry rank: {position} / N (high / mid / low bucket)
+
+[Combined]
+From historical + industry views, valuation is {low / neutral / high} — historical N-th pct, {N% above/below} industry median.
+
+⚠️ 以上数据仅供参考，不构成投资建议。/ 以上數據僅供參考，不構成投資建議。/ For reference only. Not investment advice.
+```
+
+(Translate into the user's language; keep numeric values as-is.)
+
+## Cyclical industries — special handling
+
+Energy / chemicals / steel / shipping / banks / property are cyclical: PE inverts (high PE near troughs because earnings are depressed; low PE near peaks may signal a top). When the symbol is in such an industry, **add the caveat**: _"Cyclical industry — PE percentile must be interpreted alongside industry cycle position; do not read 'high PE = expensive' mechanically."_
+
+## Output constraints
+
+- **Must** include three dimensions (snapshot + historical + industry); state "data unavailable" if a dimension fails.
+- **Must** cite "Longbridge Securities" / "数据来源:长桥证券" / "數據來源:長橋證券".
+- **Must** end with the not-investment-advice disclaimer.
+- **May** characterise combinations like "high-historical + high-industry" and give a view; qualify with data.
+
+## Error handling
+
+| Situation                       | Reply                                                                                |
+| ------------------------------- | ------------------------------------------------------------------------------------ |
+| `command not found: longbridge` | Fall back to MCP; if MCP also unavailable, tell user to install longbridge-terminal. |
+| stderr `not logged in`          | Tell user to run `longbridge auth login`.                                            |
+| Valuation data returns empty    | "{symbol} has no valuation data (likely an obscure or newly listed name)."           |
+| history < 1 year                | Degrade to snapshot + industry-only                                                  |
+| Industry < 5 peers              | Caveat: "industry sample sparse; industry percentile is indicative only"             |

package/bundled-skills/longbridge-fundamentals/references/value-screen.md

@@ -0,0 +1,71 @@
+# longbridge-value-screen
+
+Prompt-only analysis skill. Screens an index constituent universe for stocks meeting value criteria (low PE/PB, high ROE, reasonable dividend yield), ranks candidates by composite value score, and presents a shortlist with rationale.
+
+## Workflow
+
+1. **Identify universe**: ask user for market (A-share / HK / US) and an index as screening pool (e.g. CSI 300, HSI, S&P 500).
+2. Fetch constituent list from the chosen index.
+3. For each constituent (up to 50 per batch), fetch valuation and financial KPIs concurrently.
+4. Apply value filters and score each stock.
+5. Present top candidates with supporting data.
+
+## CLI
+
+Run `longbridge <subcommand> --help` to verify exact flags before calling.
+
+```bash
+# Step 1: get constituent list (JSON key is "stocks", not "list")
+longbridge constituent <INDEX> --format json
+# Examples: 000300.SH (CSI300), HSI.HK, SPX.US, IXIC.US
+
+# Step 2: for each constituent symbol (run concurrently, batch of ≤20 at a time)
+longbridge calc-index <SYMBOL> --format json       # PE, PB, ROE, dividend yield, market cap
+longbridge valuation <SYMBOL> --format json        # current snapshot + historical percentile
+longbridge dividend <SYMBOL> --format json         # dividend history and yield
+```
+
+## Value Screening Criteria
+
+Apply the following filters (user can adjust thresholds):
+
+| Criterion                | Default threshold         | Rationale                          |
+| ------------------------ | ------------------------- | ---------------------------------- |
+| PE (TTM)                 | < 20 (A/HK); < 25 (US)    | Below market average               |
+| PB                       | < 2.0                     | Below book value or modest premium |
+| ROE                      | > 10%                     | Profitability quality gate         |
+| Dividend yield           | > 2% (optional)           | Shareholder return signal          |
+| PE historical percentile | < 50th pct (if available) | Below own history                  |
+| Gross margin             | > 20% (if available)      | Business quality filter            |
+
+**Composite value score** = equal-weight rank across (PE rank asc, PB rank asc, ROE rank desc, dividend yield rank desc). Higher score = better value candidate.
+
+**Cyclical-industry caveat**: for energy, steel, banks, shipping — low PE near a cycle peak may not signal undervaluation. Flag these and suggest using PB or dividend yield as primary metric.
+
+## Output template
+
+```
+Value Screen — <INDEX> (<N> stocks screened)  Source: Longbridge Securities
+Date: <today>  Filters: PE<20, PB<2, ROE>10%
+
+Rank  Symbol      Name         PE    PB    ROE    Div.Yield  Score   Note
+1     <SYM>       <Name>       <N>   <N>   <N>%   <N>%       <N>/10
+2     ...
+...
+(top 10 candidates)
+
+[Interpretation]
+- Top pick: <symbol> — <brief rationale>
+- Key risk: <e.g. sector concentration, cyclical exposure>
+
+⚠️ 筛选结果仅供参考，不构成投资建议。/ 篩選結果僅供參考，不構成投資建議。/ Screening results are for reference only. Not investment advice.
+```
+
+## Error handling
+
+| Situation                       | 简体回复                                           | 繁體回復                                           | English reply                                                  |
+| ------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------- |
+| `command not found: longbridge` | 回退到 MCP；若也不可用，请安装 longbridge-terminal | 回退到 MCP；若也不可用，請安裝 longbridge-terminal | Fall back to MCP; if unavailable, install longbridge-terminal. |
+| No index specified              | 请告知要筛选的指数，如沪深300、恒生指数、标普500   | 請告知要篩選的指數，如滬深300、恒生指數、標普500   | Please specify an index, e.g. CSI 300, HSI, or S&P 500.        |
+| constituent returns empty       | 未能获取成分股列表，请检查指数代码                 | 未能獲取成分股列表，請檢查指數代碼                 | Cannot fetch constituent list; check index symbol.             |
+| calc-index missing fields       | 跳过该标的，标注数据缺失                           | 略過該標的，標注數據缺失                           | Skip symbol; note data gap.                                    |

package/bundled-skills/longbridge-market-data/SKILL.md

@@ -9,6 +9,9 @@ date_added: 2026-07-01
 license: MIT
 license_source: https://github.com/longbridge/skills/blob/main/LICENSE
 ---
+## Bundled upstream support
+
+Supporting files are included at skill-relative paths. See [UPSTREAM-NOTICE.md](UPSTREAM-NOTICE.md) for their pinned sources, licenses, hashes, and import changes.
 
 # Longbridge Market Data
 

package/bundled-skills/longbridge-market-data/UPSTREAM-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Longbridge Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bundled-skills/longbridge-market-data/UPSTREAM-NOTICE.md

@@ -0,0 +1,28 @@
+# Upstream helpers for longbridge-market-data
+
+The files listed below were recovered from [longbridge/skills](https://github.com/longbridge/skills) at commit `66f45635ac0c7000b714ed0f34ab400b6818be74`. The repository ID is `1224163986`.
+
+They retain the upstream **MIT** license reproduced in [UPSTREAM-LICENSE.txt](UPSTREAM-LICENSE.txt). This notice applies to the listed support files; it does not replace the license metadata of other catalog files. Preserve the upstream license and this attribution when redistributing them.
+
+License wording is unchanged; text-only trailing whitespace and EOF blank lines are normalized. Original license: https://github.com/longbridge/skills/blob/66f45635ac0c7000b714ed0f34ab400b6818be74/LICENSE
+
+| Local file | Original upstream path | Original Git blob SHA | Import changes |
+| --- | --- | --- | --- |
+| `references/quote.md` | `skills/longbridge-market-data/references/quote.md` | `bc41861cbb760400035000fa34ff1e6ed26f2583` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/kline.md` | `skills/longbridge-market-data/references/kline.md` | `d0102a027d45d739a810d889074472801a2cc5d3` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/depth.md` | `skills/longbridge-market-data/references/depth.md` | `f60c214cba7ba84d141f746c15b7655949af32cc` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/trades.md` | `skills/longbridge-market-data/references/trades.md` | `116d7afabfa61aba4794844e9460fa8b3b0eddc8` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/intraday.md` | `skills/longbridge-market-data/references/intraday.md` | `36e93696ec54d6651c1bc4c1962e4636ae5811c6` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/capital.md` | `skills/longbridge-market-data/references/capital.md` | `e07e0c2789edd44014c8ee9c79840b470d5ba5e4` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/market-temp.md` | `skills/longbridge-market-data/references/market-temp.md` | `3162a7ceb11915f82bafb23d4fd61b32741680b8` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/trading.md` | `skills/longbridge-market-data/references/trading.md` | `cbbfa38418ccd9925c3a90c3db4fdc5f0a2b0572` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/security-list.md` | `skills/longbridge-market-data/references/security-list.md` | `509a1082f83709cdd6642f6dbc536621682f1fb3` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/participants.md` | `skills/longbridge-market-data/references/participants.md` | `2a63815cca7da725d6292ddbe1e630fdcad75191` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/subscriptions.md` | `skills/longbridge-market-data/references/subscriptions.md` | `d22fdd32f9b0932e2ece2754749f9d9b4b3e844a` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/ah-premium.md` | `skills/longbridge-market-data/references/ah-premium.md` | `55ec3147032c853f84ba3471a4724a6b5edcec78` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/trade-stats.md` | `skills/longbridge-market-data/references/trade-stats.md` | `3d22870996f5ecd46a8b67962dd4b2deb781b808` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/market-status.md` | `skills/longbridge-market-data/references/market-status.md` | `9af1cad7dfcf8e07238ceef050b7cd7550f62728` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/exchange-rate.md` | `skills/longbridge-market-data/references/exchange-rate.md` | `7b2c50265bc6ca1e29bcd01f1175c0eda2faf4aa` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/ipo.md` | `skills/longbridge-market-data/references/ipo.md` | `75a85f04804eb38e45d54164229c63663ca01573` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/adr-premium.md` | `skills/longbridge-market-data/references/adr-premium.md` | `a1ee7ba5802ec39b7474c2afc0976b3c21f71ed2` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/fx-carry.md` | `skills/longbridge-market-data/references/fx-carry.md` | `76232f6fa40aea5e9883066fcf8791de03118723` | text-only trailing whitespace and EOF blank lines normalized |

package/bundled-skills/longbridge-market-data/references/adr-premium.md

@@ -0,0 +1,63 @@
+# longbridge-adr-premium
+
+Cross-market premium / discount analysis for companies dual- or triple-listed as ADR (US), H-share (HK), and/or A-share (CN).
+
+## Workflow
+
+1. Identify all available listing venues for the company (ADR ticker, HK code, A-share code).
+2. Fetch real-time quotes for each venue.
+3. Fetch USD/HKD and USD/CNY exchange rates.
+4. Convert all prices to a common currency (USD) using the ADR ratio where applicable.
+5. Calculate premium / discount between each pair: `(Price_A − Price_B) / Price_B × 100%`.
+6. Assess arbitrage constraints: FX repatriation rules, stamp duty, liquidity depth, settlement lag.
+7. Output a comparison table and narrative.
+
+> If unsure of exact flag names, run `longbridge <subcommand> --help` before proceeding.
+
+## CLI
+
+```bash
+# Quotes for each listing venue
+longbridge quote <ADR_SYMBOL> --format json
+longbridge quote <HK_SYMBOL> --format json
+longbridge quote <A_SYMBOL> --format json   # omit if no A-share listing
+
+# Exchange rates for currency conversion
+longbridge exchange-rate --format json
+```
+
+Common examples:
+
+| Company | ADR     | H-share | A-share |
+| ------- | ------- | ------- | ------- |
+| Alibaba | BABA.US | 9988.HK | —       |
+| Baidu   | BIDU.US | 9888.HK | —       |
+| JD.com  | JD.US   | 9618.HK | —       |
+| NIO     | NIO.US  | 9866.HK | —       |
+
+## Output
+
+Present a summary table then a narrative:
+
+```
+Symbol        Price (local)   Price (USD)   vs ADR
+──────────────────────────────────────────────────
+BABA.US        $82.50          $82.50        baseline
+9988.HK        HK$638.00       $81.79        −0.9%
+```
+
+Then explain:
+
+- Which venue is cheapest / most expensive and why.
+- Arbitrage constraints (FX controls, transaction costs, liquidity).
+- Whether the spread is actionable or structural.
+
+## Error handling
+
+| Situation                       | 简体回复                                        | 繁體回復                                        | English reply                                                    |
+| ------------------------------- | ----------------------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------- |
+| Symbol not found                | 未找到该代码，请确认上市交易所和代码格式。      | 找不到該代碼，請確認上市交易所和代碼格式。      | Symbol not found — please verify the exchange and ticker format. |
+| No ADR listing                  | 该公司没有美股 ADR，只能比较 H 股和 A 股。      | 該公司沒有美股 ADR，只能比較 H 股和 A 股。      | No US ADR found — comparing H-share vs A-share only.             |
+| Exchange rate unavailable       | 汇率数据暂时不可用，无法换算成同一货币。        | 匯率數據暫時不可用，無法換算成同一貨幣。        | Exchange rate unavailable — cannot convert to a common currency. |
+| `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` to authenticate.                     |

package/bundled-skills/longbridge-market-data/references/ah-premium.md

@@ -0,0 +1,67 @@
+# longbridge-ah-premium
+
+A/H premium ratio for dual-listed Mainland-Chinese companies — historical kline or today's intraday curve.
+
+## Symbol format
+
+Always pass the **HK side** (`<CODE>.HK`) of the dual-listed pair. The Longbridge API maps internally to the A-share counterpart. Common pairs:
+
+| Company               | HK        | A-share     |
+| --------------------- | --------- | ----------- |
+| 工商银行 / ICBC       | `1398.HK` | `601398.SH` |
+| 建设银行 / CCB        | `939.HK`  | `601939.SH` |
+| 中国平安 / Ping An    | `2318.HK` | `601318.SH` |
+| 招商银行 / CMB        | `3968.HK` | `600036.SH` |
+| 中国人寿 / China Life | `2628.HK` | `601628.SH` |
+
+If the user gives an A-share symbol, translate to the HK side. If the stock is not dual-listed (e.g. `700.HK`), the API returns no data — report that, don't retry.
+
+## Subcommands
+
+> Run `longbridge ah-premium --help` (and `longbridge ah-premium intraday --help`) if unsure of current flags.
+
+| CLI command                                                                 | Returns                              |
+| --------------------------------------------------------------------------- | ------------------------------------ |
+| `longbridge ah-premium <SYMBOL> [--kline-type T] [--count N] --format json` | Historical premium ratio kline       |
+| `longbridge ah-premium intraday <SYMBOL> --format json`                     | Today's intraday premium time series |
+
+`--kline-type`: `1m` / `5m` / `15m` / `30m` / `60m` / `day` (default) / `week` / `month` / `year`. `--count` defaults to 100.
+
+## Workflow
+
+1. Identify the dual-listed pair; pass the **HK** symbol.
+2. Decide mode:
+   - "近一年 / last year走势" → kline `--kline-type day --count 250`
+   - "近一月 / past month" → kline `--kline-type day --count 22`
+   - "今天 / 当日 / intraday" → `intraday` subcommand
+3. Run the command, render the time series (table or summary: latest premium %, range, trend).
+4. Cite source as **Longbridge Securities** / **数据来源:长桥证券** / **數據來源:長橋證券**.
+
+## CLI examples
+
+```bash
+# Default daily kline (100 days)
+longbridge ah-premium 939.HK                                       --format json
+
+# Last year of daily premium
+longbridge ah-premium 1398.HK --kline-type day --count 250         --format json
+
+# Last 12 weeks
+longbridge ah-premium 2318.HK --kline-type week --count 12         --format json
+
+# Today's intraday premium curve
+longbridge ah-premium intraday 939.HK                              --format json
+```
+
+## Output
+
+Each row carries a timestamp and a premium ratio (typically expressed as `(H_price * fx) / A_price - 1`, in %). Negative = HK trades at a discount to A-share. Surface latest value + recent range.
+
+## Error handling
+
+| Situation                             | LLM response                                                                            |
+| ------------------------------------- | --------------------------------------------------------------------------------------- |
+| Shell `command not found: longbridge` | Fall back to MCP if configured; otherwise tell the user to install longbridge-terminal. |
+| Empty array                           | "No A/H premium data — `<SYMBOL>` is likely not dual-listed in A-shares."               |
+| stderr `param_error`                  | Verify the symbol is an HK ticker of a dual-listed pair.                                |
+| Other stderr                          | Surface verbatim.                                                                       |