CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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
SecuritybySnyk

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
SKILL.md
Quality
Evals
Security

Quality

Content

65%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.

A strong, information-dense domain skill with executable data-access code, concrete numeric thresholds, and a clear output contract. The main gaps are the lack of an explicit step-by-step workflow with validation checkpoints and the absence of progressive disclosure — everything lives inline in one long file.

Suggestions

Add an explicit numbered workflow (fetch flows → compute signals → score composite → render output) with a validation step (e.g., cross-check daily Southbound against HKEX before signaling) to anchor execution order.

Complete the composite scoring logic: the connect_score dict is all zeros with no function mapping raw flows/percentiles to the -2..+2 component scores.

Split the sector allocation tables and signal frameworks into a references/ file (e.g., references/signal-frameworks.md) and link them one level deep, keeping SKILL.md as a lean overview plus data access and output format.

DimensionReasoningScore

Conciseness

Mostly lean and dense with domain-specific judgment Claude cannot derive (quota thresholds, sector weight ranges, signal cutoffs, tushare field pitfalls), with only minor over-explanation — e.g., the 'Why Northbound matters' bullets and 'smart money' framing could be tightened. Fits 'efficient; minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

Mostly executable guidance: real API calls with parameters and column documentation (moneyflow_hsgt, hsgt_top10, get_southbound_flow, yahoo_download), concrete numeric signal functions, and a fill-in output template. Minor gaps keep it below 5 — the composite 'connect_score' dict is left initialized to zeros with no scoring function showing how to compute each dimension, and 'ah_discount': [] is an unexplained placeholder.

4 / 5

Workflow Clarity

The sequence (understand signals → fetch data → compute composite → render output format) is present but only implicitly through section order; there is no explicit step list or validation checkpoints. The tushare cumulative-field warning and Eastmoney↔HKEX cross-verification note act as partial data validation, fitting 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'.

3 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but the ~260-line body is monolithic with no bundle files — the signal frameworks, sector allocation tables, and output template are natural candidates for one-level-deep reference files. Fits 'some structure but could be better organized' rather than the appropriately-split structure of a 4.

3 / 5

Total

14

/

20

Passed

Description

71%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.

A specific, well-scoped description that clearly names the domain and enumerates concrete capabilities with good natural trigger terms. Its main weakness is the complete absence of a 'when to use' clause, which both caps completeness and leaves triggering to keyword coincidence.

Suggestions

Add an explicit trigger clause, e.g., 'Use when analyzing Northbound/Southbound (Stock Connect / 港股通) flows, cross-border capital positioning, or AH premium arbitrage signals.'

Include the natural synonyms users say for this domain — 'HK Stock Connect', '港股通', '北向资金 / 南向资金' — alongside the English terms to improve trigger coverage.

Name the 'AH Premium Index' explicitly in the description since it is a core part of the skill but currently only implied via 'cross-border arbitrage signals'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete capabilities — 'fund flow analysis', 'Northbound (foreign into A-shares)', 'Southbound (mainland into HK)', 'sector allocation tracking', and 'cross-border arbitrage signals' — with comprehensive coverage of the skill's scope, matching the anchor for multiple specific concrete actions.

5 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines. Not a 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good natural keyword coverage ('Stock Connect', 'fund flow', 'Northbound', 'Southbound', 'arbitrage'), but common variations users would actually say are missing (e.g., 'HK Stock Connect', '港股通', '北向/南向资金', 'AH premium'). Fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The Stock Connect cross-border flow niche is clear with distinct triggers (Northbound/Southbound/AH arbitrage), but within a finance-oriented skill collection it has minor overlap risk with general fund-flow or sector-rotation analysis skills — 'mostly distinct; minor overlap risk' rather than a fully isolated niche.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

Reviewed

Table of Contents

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.