CtrlK
BlogDocsLog inGet started
Tessl Logo

alphaear-stock

Search A-Share/HK/US finance stock tickers and retrieve finance stock price history. Use when user asks about finance stock codes, recent price changes, or specific company finance stock info.

66

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/alphaear-stock/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

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

The content is concise and appropriately references real bundle files, but actionability and workflow clarity are held back by the absence of an executable usage example and of explicit validation checkpoints for the proxy/network failure modes it mentions.

Suggestions

Add a short copy-paste-ready example showing how to instantiate and call StockTools (e.g. 'from scripts.stock_tools import StockTools; StockTools().search_ticker("Moutai")').

Turn the proxy note into a small validation/feedback loop: detect the yfinance/akshare failure, then set HTTP_PROXY/HTTPS_PROXY and retry, rather than leaving it as prose guidance.

DimensionReasoningScore

Conciseness

The body is lean and well-organized, listing method signatures and return types without explaining concepts Claude already knows, so every token earns its place.

3 / 3

Actionability

It names concrete methods and return types but provides no executable import/usage snippet, leaving Claude to infer how to instantiate and call StockTools.

2 / 3

Workflow Clarity

This single-purpose lookup skill has an unambiguous action sequence, but there are no explicit validation or error-handling checkpoints for the proxy/network failure cases it itself flags.

2 / 3

Progressive Disclosure

For a compact single-purpose skill, the well-organized sections and one-level-deep references to real bundle files (scripts/stock_tools.py, scripts/database_manager.py, both verified present) give clear navigation.

3 / 3

Total

10

/

12

Passed

Description

85%

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, complete with an explicit use-trigger, and clearly differentiated to a finance-stock niche. Its main weakness is trigger term quality: the repeated 'finance stock' phrasing is unnatural and several common user phrasings are missing.

Suggestions

Reword triggers to natural user phrasings, e.g. 'Use when the user asks about stock prices, ticker codes, A-shares, HK stocks, US equities, or company fundamentals' instead of the repeated 'finance stock' wording.

Add the commonly-said terms 'stock price', 'ticker', and 'A-share/HK/US stocks' to the trigger list to improve coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('Search A-Share/HK/US finance stock tickers and retrieve finance stock price history'), naming the specific data domains and operations rather than vague verbs.

3 / 3

Completeness

Clearly states what it does and includes an explicit 'Use when user asks about...' trigger clause, answering both what and when.

3 / 3

Trigger Term Quality

Includes some natural triggers ('finance stock codes', 'recent price changes', 'company finance stock info') but the awkward repeated 'finance stock' phrasing and absence of common variations ('stock price', 'ticker', 'A-share', 'HK stock') leave coverage incomplete.

2 / 3

Distinctiveness Conflict Risk

Targets a clear niche (A-Share/HK/US finance stock data) with distinct triggers unlikely to collide with other skills.

3 / 3

Total

11

/

12

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
RKiding/Awesome-finance-skills
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.