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

61%

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

57%Weight 40%Scale 1-5

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

The content is a well-structured, actionable Stock Connect flow-analysis reference with strong executable code and a clear output template, but it is somewhat verbose, lacks explicit workflow checkpoints, and is a monolithic single file with no progressive disclosure into reference files.

Suggestions

Tighten or move the 'Why Northbound/Southbound matters' explanatory prose into a reference file, keeping only the signal-relevant thresholds inline to improve conciseness.

Add an explicit numbered analysis workflow (pull data → compute signals → score composite → render output) with a validation checkpoint (e.g. sanity-check quota utilization and cumulative-flow signs) to lift workflow clarity.

Split the data-access API reference and the composite-signal scoring logic into separate reference files (e.g. references/data_access.md, references/composite_signal.md) and link to them from SKILL.md to enable one-level-deep progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and information-dense (signal thresholds, sector tables, executable code), but the 'Why Northbound matters' / 'Why Southbound matters' prose blocks and the 7-bullet Notes commentary include conceptual explanation that could be tightened; it is not 4 because several explanatory passages go beyond what is strictly actionable, and not 2 because the padding is moderate rather than severe.	3 / 5
Actionability	Provides executable Python for signal functions, Tushare moneyflow_hsgt/hsgt_top10 calls, yfinance downloads, and a concrete output-format template — mostly copy-paste ready — but minor gaps (the composite connect_score is a commented dict rather than a function, and northbound_trend returns None on some branches) keep it just below fully-executable 5.	4 / 5
Workflow Clarity	The logical flow (concepts → signals → data access → output format) and the structured output template give an implicit sequence, but there are no explicit numbered steps or validation checkpoints; this is an analytical rather than destructive/batch skill so the destructive cap does not apply, and it is not 4 because checkpoints remain implicit rather than present.	3 / 5
Progressive Disclosure	No bundle files exist (references/, scripts/, assets/ are absent) and the ~240-line skill is a single monolithic document; it has good section headers and structure, but detailed code, data-access reference, and the output template are all inlined rather than split into one-level-deep references, fitting 'some structure but content that should be separate is inline' rather than 4.	3 / 5
	Total	13 / 20 Passed

Description

66%Weight 40%Scale 1-5

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

The description is specific and distinctive for a specialized China-HK capital-flow niche, but it omits any explicit 'Use when...' trigger guidance, which caps completeness at 3 and leaves the trigger/use-when dimension underdeveloped.

Suggestions

Add an explicit trigger clause, e.g. 'Use when analyzing Stock Connect flows, Northbound/Southbound capital movements, AH premium arbitrage, or cross-border A-share/HK positioning.'

Include a couple of natural synonyms users might say (e.g. '港股通', 'H-shares', 'mainland-HK flows') to broaden trigger-term coverage toward 5.

Optionally name one or two concrete output actions (e.g. 'generate a flow report' or 'score a composite cross-border signal') to lift specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Names the Stock Connect domain and lists several concrete capabilities — 'Northbound (foreign into A-shares)', 'Southbound (mainland into HK)', 'sector allocation tracking', and 'cross-border arbitrage signals' — but the actions are variations of analysis rather than a maximally comprehensive enumeration, so it sits at 'several specific actions; minor gaps' rather than 5.	4 / 5
Completeness	It has a clear 'what' (the four flow-analysis capabilities) but no 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guideline completeness is capped at 3; it is not 4 because the 'when' is entirely missing rather than weakly implied.	3 / 5
Trigger Term Quality	Includes natural niche terms a user would say — 'Stock Connect', 'Northbound', 'Southbound', 'A-shares', 'HK', 'sector allocation', 'cross-border arbitrage' — giving good keyword coverage, though a few common variations/synonyms (e.g. '港股通', 'H-shares') are absent, keeping it below 5.	4 / 5
Distinctiveness Conflict Risk	The Stock Connect / Northbound / Southbound framing carves a clear niche with distinctive triggers and low conflict risk, but within a finance skill suite it could mildly overlap with broader 'fund flow' or 'capital flow analysis' skills, so it is 'mostly distinct; minor overlap risk' rather than the minimal-risk 5.	4 / 5
	Total	15 / 20 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: e90b6c6

Reviewed: 3 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.