Stock Deep Analysis Workflow
wbh604/UZI-Skill
Runs a staged deep analysis of a single stock on China A-share, Hong Kong and US markets, ending in an HTML report with valuation models and investor-panel scores.
Frameworks for comparing the A-share, H-share and US ADR prices of one Chinese company: AH premium, arbitrage signals, dual-listing valuation and delisting risk.
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HKUDS/Vibe-Trading adr-hshare --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/adr-hshare .claude/skills/adr-hshare && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .claude/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshareType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HKUDS/Vibe-Trading adr-hshare --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agent/src/skills/adr-hshare .agents/skills/adr-hshare && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .agents/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HKUDS/Vibe-Trading adr-hshare --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agent/src/skills/adr-hshare .cursor/skills/adr-hshare && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .cursor/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/HKUDS/Vibe-Trading.git --path agent/src/skills/adr-hshare--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HKUDS/Vibe-Trading adr-hshare --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agent/src/skills/adr-hshare .gemini/skills/adr-hshare && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .gemini/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HKUDS/Vibe-Trading adr-hshareInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .github/skills && cp -r skills-src/agent/src/skills/adr-hshare .github/skills/adr-hshare && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .github/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HKUDS/Vibe-Trading adr-hshare --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agent/src/skills/adr-hshare .opencode/skills/adr-hshare && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "adr-hshare" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/adr-hshare into .opencode/skills/adr-hshare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "adr-hshare", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
adr-hshareFrameworks for comparing the A-share, H-share and US ADR prices of one Chinese company: AH premium, arbitrage signals, dual-listing valuation and delisting risk.
Many Chinese companies trade on several exchanges: A-shares in Shanghai or Shenzhen, H-shares in Hong Kong and ADRs in the US. This skill gives the agent a framework for comparing those listings. It sorts companies into structures such as A plus H, H plus ADR, triple-listed, Hong Kong primary with a US secondary and US primary with a later Hong Kong listing, and gives example tickers for each.
The central measure is the AH premium, the A-share price relative to the H-share price converted to CNY, shown with a short Python function that handles the currency conversion. A table maps premium bands, from above 50% down to below zero, to an interpretation and a typical stance, and the structural drivers are listed, such as liquidity, historic access limits and currency expectations. The skill also covers delisting risk for US-listed Chinese ADRs.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit b1f6ce7. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
ADR and H-Share Premium Analysis loads about 2.5k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 692 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from HKUDS/Vibe-Trading at commit b1f6ce7, republished under its MIT licence (© HKUDS). 692 words, ~2,488 tokens.
.claude/skills/adr-hshare/SKILL.md (or your agent's skills folder).Many Chinese companies are listed on multiple exchanges — A-shares in Shanghai/Shenzhen, H-shares in Hong Kong, and ADRs in the US. Pricing gaps between these listings create arbitrage opportunities and reveal market-specific sentiment differences. This skill provides frameworks for analyzing cross-listing premiums, identifying arbitrage signals, and assessing delisting risk for US-listed Chinese ADRs.
| Structure | Description | Examples |
|---|---|---|
| A + H dual-listed | Same company listed on both A-share and HK exchange | PetroChina (601857.SH / 0857.HK), ICBC (601398.SH / 1398.HK) |
| H + ADR dual-listed | HK-listed with US ADR | Alibaba (9988.HK / BABA), JD.com (9618.HK / JD) |
| A + H + ADR triple-listed | All three markets | China Life (601628.SH / 2628.HK / LFC) |
| HK primary + US secondary | Primary listing in HK, secondary ADR | Tencent (0700.HK / TCEHY OTC) |
| US primary → HK secondary | Originally US, added HK listing | Alibaba (BABA → 9988.HK), Baidu (BIDU → 9888.HK) |
AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%
def calculate_ah_premium(a_price_cny, h_price_hkd, usdcny, usdhkd):
"""Calculate AH premium for a dual-listed stock."""
h_price_cny = h_price_hkd * (usdcny / usdhkd) # Convert HKD to CNY
ah_premium = (a_price_cny / h_price_cny - 1) * 100
return ah_premium
# Example: PetroChina
# A-share: 8.50 CNY, H-share: 6.20 HKD
# USDCNY: 7.25, USDHKD: 7.82
# H in CNY: 6.20 * (7.25/7.82) = 5.75 CNY
# AH Premium: (8.50/5.75 - 1) * 100 = 47.8%AH Premium signal interpretation:
| Premium Level | Interpretation | Action |
|---|---|---|
| >50% | Extreme A-share premium; A-share speculative bubble or H-share extreme undervaluation | Strong: buy H, sell/avoid A |
| 30-50% | Elevated premium; normal for high-retail-participation names | Moderate: favor H if fundamentals same |
| 10-30% | Normal range for most AH pairs | Neutral; no strong arbitrage signal |
| 0-10% | Compressed premium; A-shares relatively cheap | Unusual; investigate catalyst |
| <0% | H-share premium over A-share | Very rare; usually near-term event-driven |
Structural drivers of AH premium:
ADR premium = (ADR price in USD / HK equivalent in USD - 1) × 100%
def calculate_adr_premium(adr_price_usd, hk_price_hkd, adr_ratio, usdhkd):
"""
Calculate ADR premium over HK listing.
adr_ratio: number of HK shares per 1 ADR (e.g., BABA: 1 ADR = 8 HK shares)
"""
hk_equivalent_usd = (hk_price_hkd * adr_ratio) / usdhkd
premium = (adr_price_usd / hk_equivalent_usd - 1) * 100
return premium
# Example: Alibaba
# BABA ADR: $85.00, 9988.HK: HKD 82.50
# ADR ratio: 1 ADR = 8 HK shares
# HK equivalent: (82.50 * 8) / 7.82 = $84.40
# ADR premium: (85.00/84.40 - 1) * 100 = 0.71%Key ADR conversion ratios:
| Company | ADR Ticker | HK Ticker | ADR Ratio (HK:ADR) | ADR Exchange |
|---|---|---|---|---|
| Alibaba | BABA | 9988.HK | 8:1 | NYSE |
| JD.com | JD | 9618.HK | 2:1 | NASDAQ |
| Baidu | BIDU | 9888.HK | 8:1 | NASDAQ |
| Bilibili | BILI | 9626.HK | 1:1 | NASDAQ |
| NIO | NIO | 9866.HK | 1:1 | NYSE |
| XPeng | XPEV | 9868.HK | 2:1 | NYSE |
| Li Auto | LI | 2015.HK | 2:1 | NASDAQ |
| NetEase | NTES | 9999.HK | 5:1 | NASDAQ |
| Trip.com | TCOM | 9961.HK | 1:1 | NASDAQ |
| Pinduoduo | PDD | N/A (US-only) | N/A | NASDAQ |
ADR premium drivers:
HFCAA (Holding Foreign Companies Accountable Act) framework:
Since 2022, PCAOB gained access to audit workpapers of Chinese companies. Key risks:
| Risk Level | Criteria | Impact |
|---|---|---|
| Low | PCAOB inspection completed, no issues | ADR status stable |
| Medium | PCAOB inspection completed, deficiencies noted | Monitor for resolution |
| High | PCAOB access revoked or restricted | 3-year delisting countdown activated |
| Critical | On SEC "identified issuer" list for 3 consecutive years | Forced delisting |
Delisting risk indicators:
delisting_risk_factors = {
"pcaob_status": "inspected", # inspected / pending / blocked
"sec_identified_years": 0, # 0, 1, 2, or 3 (3 = delist)
"has_hk_listing": True, # Backup listing reduces impact
"hk_listing_type": "primary", # primary (can be in Connect) vs secondary
"vie_structure": True, # Variable Interest Entity adds legal risk
"state_owned": False, # SOE status adds geopolitical risk
}
# Companies with HK primary listing (BABA, JD, BIDU, NTES, etc.) have
# a safety net if US delisting occurs → fungible conversion ADR → HK shares
# Companies with US-only listing (PDD until HK listing) face higher riskStrategy 1: AH Premium Mean-Reversion
# When AH premium for a specific stock diverges significantly from its historical average
ah_premium_current = 45 # current premium
ah_premium_mean_12m = 35 # 12-month average
ah_premium_std = 8 # standard deviation
z_score = (ah_premium_current - ah_premium_mean_12m) / ah_premium_std
if z_score > 2.0:
signal = "fade_premium" # A-share overvalued vs H; buy H, avoid A
elif z_score < -2.0:
signal = "buy_premium" # A-share undervalued vs H; buy A, avoid H
else:
signal = "neutral"Strategy 2: ADR-HK Intraday Arbitrage
Strategy 3: Event-Driven Cross-Listing
import yfinance as yf
# Fetch ADR and HK prices simultaneously
baba_adr = yf.download("BABA", start="2025-01-01", end="2026-03-30", progress=False)
baba_hk = yf.download("9988.HK", start="2025-01-01", end="2026-03-30", progress=False)
# For A+H pairs
petrochina_a = yf.download("601857.SS", start="2025-01-01", end="2026-03-30", progress=False)
petrochina_h = yf.download("0857.HK", start="2025-01-01", end="2026-03-30", progress=False)
# FX rates for premium calculation
cny = yf.download("CNY=X", start="2025-01-01", end="2026-03-30", progress=False) # USD/CNY
hkd = yf.download("HKD=X", start="2025-01-01", end="2026-03-30", progress=False) # USD/HKD
# AH Premium Index (HSAHP)
# Not directly on yfinance; use Hang Seng website or Tushare## Cross-Listing Analysis — [Company Name]
### Listing Structure
- **A-share**: [code] @ [price CNY]
- **H-share**: [code] @ [price HKD]
- **ADR**: [ticker] @ [price USD] (ratio: X HK shares = 1 ADR)
### Premium/Discount
- **AH Premium**: [X%] (12m avg: X%, z-score: X.X)
- **ADR-HK Premium**: [X%] (5d avg: X%)
- **Direction**: [AH premium widening / narrowing / stable]
### Valuation Comparison
| Metric | A-share | H-share | ADR |
|--------|---------|---------|-----|
| PE (TTM) | XX.X | XX.X | XX.X |
| PB | X.X | X.X | X.X |
| Dividend yield | X.X% | X.X% | X.X% |
### Delisting Risk (ADR)
- **PCAOB status**: [inspected / pending]
- **SEC identified years**: [0/1/2/3]
- **HK backup**: [yes-primary / yes-secondary / no]
- **Risk level**: [low / medium / high / critical]
### Arbitrage Signal
- **AH premium z-score**: [X.X] → [fade premium / neutral / buy premium]
- **Best market to buy**: [A / H / ADR] — rationale
- **Catalyst**: [index inclusion, Connect eligibility, earnings]
### Investment Implication
- **Preferred listing**: [H-share / ADR / A-share] for new position
- **Risk**: [delisting, FX, regulatory, liquidity]© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in agent/src/skills/adr-hshare of HKUDS/Vibe-Trading.
Open the folder on GitHubat commit b1f6ce7
ADR and H-Share Premium Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| ADR and H-Share Premium Analysis this skillHKUDS/Vibe-Trading | 35k | — | ~2.5k | Automated safety check: Pass | MIT | |
| Stock Deep Analysis Workflowwbh604/UZI-Skill | 7.1k | — | ~9.1k | Automated safety check: Notes | MIT | |
| Supply Chain Bottleneck Hunterxbtlin/ai-berkshire | 17k | — | ~2.6k | Automated safety check: Pass | MIT | |
| A-Share Daily Reviewqusong0627/QuantMind | 1.7k | — | ~1.9k | Automated safety check: Pass | AGPL-3.0 | |
| Futu OpenAPI Market and Trading Assistantqusong0627/QuantMind | 1.7k | — | ~3.3k | Automated safety check: Notes | AGPL-3.0 | |
| US Market Data ToolkitGeeksfino/finskills | 282 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 |
wbh604/UZI-Skill
Runs a staged deep analysis of a single stock on China A-share, Hong Kong and US markets, ending in an HTML report with valuation models and investor-panel scores.
xbtlin/ai-berkshire
Scans a long-running industry trend for supply chain chokepoints, aiming to find second- and third-layer suppliers that the market has not yet priced in.
qusong0627/QuantMind
Produces a post-market review report for the China A-share market from local QuantDB data, news sentiment and model signals, ending in a next-day direction call.
qusong0627/QuantMind
Queries Futu quotes, options, fundamentals and accounts and places orders through the Futu OpenAPI Python SDK, defaulting to simulated trading.
Geeksfino/finskills
Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.
Senpi-ai/senpi-skills
Produces a structured cross-asset read of the day across crypto, equities, indices, commodities and macro, using a bundled engine for data and ending with a signals brief.
HKUDS/Vibe-Trading
Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.
HKUDS/Vibe-Trading
Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.
HKUDS/Vibe-Trading
Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.
HKUDS/Vibe-Trading
Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.
HKUDS/Vibe-Trading
Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.
HKUDS/Vibe-Trading
Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.
Works with
Categories
Frameworks for comparing the A-share, H-share and US ADR prices of one Chinese company: AH premium, arbitrage signals, dual-listing valuation and delisting risk. Many Chinese companies trade on several exchanges: A-shares in Shanghai or Shenzhen, H-shares in Hong Kong and ADRs in the US. This skill gives the agent a framework for comparing those listings.
ADR and H-Share Premium Analysis fits situations like: comparing the A-share and H-share prices of a dual-listed company; checking an ADR's price against its Hong Kong listing; assessing delisting risk for a US-listed Chinese company; understanding why A-shares often trade at a premium to H-shares.
Run `npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a claude-code`. Or copy the skill folder (agent/src/skills/adr-hshare in HKUDS/Vibe-Trading) into .claude/skills/adr-hshare in your project. Claude Code loads it when a task matches its description.
Run `npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a codex`. Or copy the skill folder (agent/src/skills/adr-hshare in HKUDS/Vibe-Trading) into .agents/skills/adr-hshare in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/Vibe-Trading --skill adr-hshare -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adr-hshare, .gemini/skills/adr-hshare, .github/skills/adr-hshare and .opencode/skills/adr-hshare in your project.
SKILL.md names no scripts, command-line tools or credentials: ADR and H-Share Premium Analysis is instructions for the agent only. Our summary lists: Prices for each listing of the company; USD/CNY and USD/HKD exchange rates.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
ADR and H-Share Premium Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with ADR and H-Share Premium Analysis: Stock Deep Analysis Workflow (wbh604/UZI-Skill, 7.1k stars), Supply Chain Bottleneck Hunter (xbtlin/ai-berkshire, 17k stars), A-Share Daily Review (qusong0627/QuantMind, 1.7k stars) and Futu OpenAPI Market and Trading Assistant (qusong0627/QuantMind, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 35,097 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 9, 2026.
Source: HKUDS/Vibe-Trading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.