mootdx

Mootdx A-share market data via TCP-direct 通达信 servers. Free, no API key, no IP rate limits. Use as the stable A-share OHLCV fallback when akshare's East Money scrape is throttled.

Quality

87%

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

Quality

Content

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

An excellent single-file reference: executable Quick Start, precise tables for frequency codes, methods, symbol formats, and a candid Known Limitations section with workarounds. The main deductions are inline version/date-sensitive notes and the absence of an explicit data sanity-check step.

Suggestions

Move version-sensitive details (the httpx<0.26 pin workaround, the v0.11.7 extended-market note) into a dedicated 'Version notes / old patterns' section so they don't age the whole document.

Add a brief validation step after fetching (e.g., check the returned DataFrame is non-empty and covers the requested date range, falling back to the next source in the chain) to close the workflow-clarity gap.

Consider extracting the Key Methods / frequency-code tables into a references/ file if the skill grows, keeping SKILL.md as a leaner overview.

Dimension	Reasoning	Score
Conciseness	Dense and reference-style with no concept-explanation padding (frequency-code table, symbol prefix rules, quirks like 'duplicate volume alongside the legacy vol'). However, version-sensitive info appears inline ('pins httpx<0.26', 'as of v0.11.7', 'httpx>=0.28.1') outside any old-patterns/deprecated section, which the guidelines penalize, so not anchor 5.	4 / 5
Actionability	Quick Start is copy-paste executable and covers the common cases (daily get_k_data with date range plus intraday bars with offset), backed by a concrete install command, full return-column schemas, and symbol auto-detection rules. The only illustrative snippet (run(strategy=..., source="mootdx")) is a deliberate override example, not a gap.	5 / 5
Workflow Clarity	Single-purpose skill with an unambiguous usage path, a documented fallback chain ([tushare, mootdx, akshare]), and failure-mode handling (BJ get_k_data raises KeyError → loader warns and skips). No explicit data-validation checkpoint (e.g., verify the returned frame is non-empty before use), so it sits at anchor 4 rather than 5.	4 / 5
Progressive Disclosure	A single ~87-line file, cleanly sectioned, with all content appropriately inline for a compact data-source cheat-sheet and external docs linked one level deep. No bundle files exist and the body exceeds the ~50-line simple-skill threshold, so the top anchor's 'content appropriately split' is not fully demonstrated.	4 / 5
	Total	17 / 20 Passed

Description

87%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 strong description: it states what the skill provides, how (TCP-direct TDX protocol), its cost/limit advantages, and exactly when to reach for it as a fallback. Third-person voice, concise, with concrete trigger terms. Only minor gaps in synonym coverage.

Dimension	Reasoning	Score
Specificity	Names the domain ('A-share market data'), mechanism ('TCP-direct 通达信 servers'), data type ('OHLCV'), and cost profile ('Free, no API key, no IP rate limits') — several concrete specifics with minor coverage gaps (no mention of daily/intraday or symbol coverage). Fits anchor 4 better than 3, which expects only 1-2 concrete actions.	4 / 5
Completeness	Explicitly answers 'what' (Mootdx A-share market data via TCP-direct TDX servers, free, no key) and 'when' with a concrete trigger clause: 'Use as the stable A-share OHLCV fallback when akshare's East Money scrape is throttled'. The 'when' is specific rather than generic, matching anchor 5 over 4.	5 / 5
Trigger Term Quality	Includes natural terms a user would say: 'A-share', 'OHLCV', 'akshare', 'East Money', 'throttled', plus '通达信' and the library name. A few natural synonyms ('Chinese stocks', '沪深') are missing, so not the comprehensive anchor 5.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (TDX protocol data source) and explicitly positions itself against sibling sources (akshare/East Money, implied tushare), so it is unlikely to trigger for the wrong skill.	5 / 5
	Total	18 / 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/mootdx/SKILL.md
Commit: 251b094

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.