CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

etf-analysis

ETF分析:产品筛选、费率对比、跟踪误差、流动性评估、策略应用与中国市场ETF量化配置框架。

Quality

70%

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

Quality

Content

63%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 dense, knowledgeable reference with strong executable code and China-market specifics Claude would not know, delivered as a monolithic 890-line file. Its main weaknesses are padding from textbook strategy explanations and the total absence of progressive disclosure via separate reference files.

Suggestions

Split the file: move the product/index classification tables (§1, §5.4) and the Tushare data-access code templates (§7) into references/ and scripts/ files, keeping SKILL.md as a concise overview with one-level-deep links.

Trim or cut sections explaining widely known concepts (core-satellite, volatility decay derivation, 60/40 and all-weather portfolios) down to the China-specific parameters that actually add value.

Fix the data contract inconsistency (get_etf_nav returns trade_date/nav/accum_nav but downstream code uses unit_nav and fund_share) and add explicit handling for empty or failed Tushare API responses.

DimensionReasoningScore

Conciseness

The China-specific reference data (ETF tickers, fee levels, tax rules, QDII premium thresholds, index-adjustment schedule) is genuinely non-obvious and earns its tokens, but roughly a third of the ~890-line file explains concepts Claude already knows (core-satellite strategy, volatility decay math, 60/40 portfolios, single-factor regression). The file could be tightened considerably without losing value.

3 / 5

Actionability

Abundant concrete guidance: executable, docstringed Python (etf_score, calc_tracking_error, monitor_qdii_premium, fund-flow analysis), a 5-step selection procedure, and numeric thresholds throughout. Minor gaps keep it from a 5: the code depends on project-internal modules (src.data_gateway) absent from the bundle, and etf_fund_flow_analysis consumes unit_nav/fund_share columns that get_etf_nav does not return.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced (the Step 1-5 comparison framework in §3.1, scenario templates in §8, risk-graded monitoring logic in §7.3), and the analytical read-only nature means the destructive-operation cap does not apply. Missing explicit error-recovery or validation checkpoints for data-access failures (empty API responses, rate limits) prevents a 5.

4 / 5

Progressive Disclosure

Internal structure is good (nine numbered sections with headers and tables), but it is a monolithic ~890-line SKILL.md with no bundle files at all — the product classification tables, index-system reference, and data-access code templates are exactly the material that belongs in references/ and scripts/ files linked one level deep.

3 / 5

Total

14

/

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.

A domain-specific description with good keyword coverage and a clear statement of what the skill does, but it completely lacks any "when to use" trigger guidance. Adding an explicit usage-trigger clause would lift it from adequate to strong.

Suggestions

Add a 'Use when...' clause, e.g. '当用户提到 ETF、指数基金、场内基金、ETF 费率/跟踪误差/折溢价,或需要进行 ETF 筛选与组合配置时使用',to explicitly answer the 'when' question.

Include common synonyms such as '指数基金' and '场内基金' alongside 'ETF' to broaden natural trigger-term coverage.

DimensionReasoningScore

Specificity

The description enumerates six specific capability areas ("产品筛选、费率对比、跟踪误差、流动性评估、策略应用"), giving concrete coverage of the domain. It falls short of a 5 because these are topic nouns under a single verb ("分析") rather than verb-led concrete actions, and "量化配置框架" is abstract.

4 / 5

Completeness

The "what" is clearly stated (ETF analysis across screening, fees, tracking error, liquidity, strategies, and China-market allocation), but there is no "Use when..." clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Natural terms users would say when needing this skill are present: "ETF", "费率", "跟踪误差", "流动性". Common synonyms and variations such as "指数基金", "场内基金", or "联接基金" are missing, preventing a 5.

4 / 5

Distinctiveness Conflict Risk

The scoping to "中国市场ETF量化配置" establishes a clear niche that is unlikely to trigger for unrelated skills. Minor overlap risk remains with generic fund-analysis or quantitative-investing skills.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (894 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

HKUDS/Vibe-Trading

Path

agent/src/skills/etf-analysis/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.