hk-connect-flow

Stock Connect (Shanghai/Shenzhen-Hong Kong) fund flow analysis — Northbound (foreign into A-shares), Southbound (mainland into HK), sector allocation tracking, and cross-border arbitrage signals.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./agent/src/skills/hk-connect-flow/SKILL.md

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A rich, actionable reference with executable data-access code and concrete thresholds, but it is a monolithic single file with implicit validation checkpoints and inline reference material that could be extracted.

Suggestions

Move the Tushare/yfinance API column details and the AH-premium reference into a separate references/ file, linking from the body to improve progressive disclosure.

Add an explicit validation/sanity-check step to the workflow (e.g. cross-check that the composite signal's NB flow sign matches the 20-day cumulative figure before reporting).

Trim the explanatory 'why this matters' prose and consolidate the Notes section to reduce repetition and tighten conciseness.

Dimension	Reasoning	Score
Conciseness	Mostly efficient domain-specific signal frameworks, but includes explanatory prose (e.g. 'Foreign institutions... are considered smart money', '~4-5% of free-float... marginal price-setters') and a notes section that restates concepts, so it could be tightened.	2 / 3
Actionability	Provides fully executable, copy-paste-ready code — real Tushare calls (pro.moneyflow_hsgt, pro.hsgt_top10) with documented columns, yfinance downloads, and a concrete output template with an example composite-score table.	3 / 3
Workflow Clarity	A clear conceptual sequence (architecture → NB → SB → AH premium → composite → data access → output → notes) and a structured output template exist, but there are no explicit validation/sanity-check checkpoints and the composite-score assembly is left implicit.	2 / 3
Progressive Disclosure	Well-organized into headed sections, but it is a single ~240-line monolithic file with no bundle references and substantial API-reference detail (Tushare/yfinance columns) inline that could be split into a separate reference file.	2 / 3
	Total	9 / 12 Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, distinctive description that names concrete actions and natural domain terms, but it omits any explicit 'when to use' trigger guidance, leaving completeness short of a top score.

Suggestions

Append an explicit trigger clause, e.g. 'Use when analyzing Stock Connect / northbound-southbound fund flows, A-share vs H-share capital positioning, or cross-border arbitrage signals.'

Add the natural lay terms users might say ('沪港通 / 深港通 flows', 'HK Connect', 'mainland-HK capital flows') to broaden trigger coverage beyond the specialist vocabulary.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities — 'fund flow analysis', 'Northbound (foreign into A-shares)', 'Southbound (mainland into HK)', 'sector allocation tracking', and 'cross-border arbitrage signals' — matching the 'multiple specific concrete actions' anchor.	3 / 3
Completeness	The 'what' is clearly stated (fund flow analysis across the listed dimensions), but there is no 'Use when...' clause or explicit trigger guidance, which caps completeness at 2 per the rubric guidelines.	2 / 3
Trigger Term Quality	Covers natural domain terms a specialist would say — 'Stock Connect', 'Shanghai/Shenzhen-Hong Kong', 'Northbound', 'Southbound', 'A-shares', 'cross-border arbitrage' — giving broad coverage of the niche's natural vocabulary.	3 / 3
Distinctiveness Conflict Risk	The Stock Connect Northbound/Southbound flow niche is sharply specific and unlikely to trigger for unrelated skills, matching the 'clear niche with distinct triggers' anchor.	3 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: HKUDS/Vibe-Trading
Path: agent/src/skills/hk-connect-flow/SKILL.md
Commit: 8643fcd

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.