How to use the Stock Connect Fund Flow Analysis agent skill

What is an agent skill and what does this one do?

An agent skill is a folder containing a SKILL.md file that gives an AI agent specific instructions, rules and sometimes scripts for one kind of task. When the skill is loaded, the agent follows its concepts and frameworks when you ask a related question.

This skill, named hk-connect-flow, focuses on Stock Connect fund flows. It defines the four Stock Connect channels (Shanghai and Shenzhen, Northbound and Southbound), explains why each direction is read as a sentiment signal, and provides simple rules for classifying single-day and multi-day flows. It also includes a composite scoring scheme that combines flow, breadth, AH premium and CNY direction.

• Northbound: foreign capital into A-shares, read as foreign institutional appetite for China A-shares.
• Southbound: mainland capital into Hong Kong stocks, read as mainland preference for HK-listed assets.
• Sector allocation tracking: which sectors Northbound investors are adding to or reducing.
• AH premium index: the average premium of A-shares over their H-share counterparts for dual-listed companies.
• Cross-border composite signal: a score from -10 to +10 summarising positioning.

Install the hk-connect-flow skill

Option 1, personal skills folder: download the skill ZIP from this page and unzip it into ~/.claude/skills/. The folder should contain SKILL.md.

Option 2, project skills folder: unzip the ZIP into the .claude/skills/ folder of a specific project so the skill applies only to that project.

Option 3, Claude apps: download the ZIP and upload it in the Claude apps under Settings → Capabilities → Skills.

• Download the ZIP from this page.
• Unzip it into ~/.claude/skills/ (personal) or a project's .claude/skills/ (project-only).
• Or upload the ZIP in the Claude apps under Settings → Capabilities → Skills.
• Check that the skill folder contains SKILL.md.

Trigger the skill with natural requests

You do not need a special command. Describe what you want in ordinary language that mentions Stock Connect, Northbound, Southbound, AH premium or cross-border flows, and the agent can apply the skill. The skill's description is what the agent matches against your request.

Be specific about the window and the direction. A question about the last 20 days of Northbound flow gives the agent what the skill's trend rules need.

• "Classify today's Northbound flow and tell me whether foreign money is buying or selling A-shares."
• "Is Northbound accumulation sustained over the last 20 days, or is it pausing?"
• "What does Southbound flow suggest about mainland interest in Hong Kong tech platforms?"
• "Where does the Hang Seng AH Premium Index sit, and what does that imply for dual-listed stocks?"
• "Give me a cross-border composite score and explain each component."

What data and tools does it need?

The skill's data section references Eastmoney datacenter and HKEX official statistics for Stock Connect flow data. It also shows examples using the Tushare API for daily Northbound and Southbound aggregates and top-10 Northbound stocks, and yfinance for the Hong Kong perspective. The file does not show how your agent's data tools are configured, so you need to confirm that the agent can reach a flow data source before relying on its output.

Some parts of the skill, such as the AH premium logic, may need the Hang Seng AH Premium Index data. Plan for this when you set up the skill.

• Access to Stock Connect flow data through the agent's data tools (the file names get_southbound_flow(lookback_days=20) as the Southbound call).
• Optional: Tushare credentials if you use the Tushare examples.
• Optional: a Hang Seng AH Premium Index data source.

Safety notes: scripts and network access

This skill runs scripts and uses the network. Its code examples fetch or compute flow data, so review the SKILL.md and any scripts before installing, and only install skills from sources you trust. Do not treat the output as a trade instruction.

The skill's own warning is important: do not read daily Southbound flow from the Tushare field moneyflow_hsgt, because its ggt_ss, ggt_sz and south_money fields carry cumulative holdings rather than daily flow in the current file.

• Review SKILL.md and any scripts before use.
• Expect network calls to third-party data sources.
• Verify figures independently before acting on them.
• Avoid moneyflow_hsgt for daily Southbound flow, per the skill's warning.

Tips for better results

The thresholds in the skill are illustrative. For example, the file treats a daily Northbound net buy above 10bn RMB as strong buying, and the composite score ranges are rules of thumb, not validated backtests. Ask the agent to show its inputs so you can check them.

Compare the single-day reading with the 20-day trend. The skill itself says cumulative flow is more important than one day's figure.

• Ask for both the single-day classification and the cumulative trend.
• Ask the agent to name the data source and date of every number.
• Ask for the component scores when you want the composite result explained.
• Treat sector allocation percentages in the file as typical ranges, not current holdings.