adr-hshare

ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and A-shares for arbitrage signals, dual-listing valuation, and delisting risk assessment.

Quality

56%

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/adr-hshare/SKILL.md

Quality

Content

56%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 actionable and well-structured with executable code and useful tables, but it leans verbose on background context, lacks an explicit sequenced workflow with validation checkpoints, and keeps everything in one file rather than progressively disclosing detail.

Suggestions

Add an explicit numbered workflow with a validation/sanity-check step (e.g., verify premium inputs and FX conversion before emitting signals).

Move the large ADR conversion-ratio table and delisting-risk reference material into a separate referenced file to improve progressive disclosure.

Trim background exposition (e.g., HFCAA history, the overview paragraph restating multi-exchange listing) that Claude can be assumed to know.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with executable code and tables, but it dedicates space to explaining well-known concepts (e.g., that Chinese companies list on multiple exchanges, HFCAA background) and could be tightened throughout.	3 / 5
Actionability	It provides concrete, executable Python functions for AH and ADR premium calculations plus specific conversion-ratio and FX-handling examples, with only minor gaps such as the HSAHP index being left as a manual lookup.	4 / 5
Workflow Clarity	The analysis flow is implied through ordered sections (structure, premium, risk, signal, output), but there is no explicit step sequence or validation checkpoint; since the skill drives batch/data operations, the absence of verify steps caps the score at 3.	3 / 5
Progressive Disclosure	The skill is organized into clear sections but is a single monolithic SKILL.md with no external references or bundle files to offload the lengthy ratio tables and strategy detail, so structure is present but not split across files.	3 / 5
	Total	13 / 20 Passed

Description

57%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 clearly conveys a specific, distinctive niche and several concrete capabilities, but it lacks an explicit 'Use when...' trigger clause and omits some natural user-facing keywords, which limits completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause naming the trigger situations (e.g., 'Use when analyzing premiums between US-listed ADRs, HK H-shares, and mainland A-shares').

Include more natural user-facing keywords such as 'Chinese stocks', 'Hong Kong listing', 'dual-listed', and 'delisting risk'.

Reduce slightly overloaded phrasing ('cross-listing premium analysis — track pricing gaps ... for arbitrage signals, dual-listing valuation, and delisting risk assessment') to a tighter, more scannable action list.

Dimension	Reasoning	Score
Specificity	Names the cross-listing domain and several concrete actions ('track pricing gaps', 'arbitrage signals', 'dual-listing valuation', 'delisting risk assessment'), but a couple of actions overlap and the coverage is broad rather than tightly enumerated.	4 / 5
Completeness	It clearly states what the skill does, but there is no 'Use when...' clause or any explicit guidance on when Claude should invoke it, capping completeness at 3 per the rubric.	3 / 5
Trigger Term Quality	It includes relevant terms like 'ADR', 'H-share', 'A-share', 'cross-listing premium', and 'arbitrage', but lacks common natural phrasings a user might say (e.g., 'Chinese stocks', 'HK listing', 'delisting risk') and has no trigger-style language.	3 / 5
Distinctiveness Conflict Risk	The niche is fairly specific (ADR/H-share/A-share cross-listing analysis) and unlikely to collide with unrelated skills, though it could overlap slightly with general market-analysis or China-equity skills.	4 / 5
	Total	14 / 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/adr-hshare/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.