CtrlK
BlogDocsLog inGet started
Tessl Logo

stock-liquidity

Analyze how liquid a stock is using Yahoo Finance data (yfinance): bid-ask spreads, volume and dollar volume (ADTV), top-of-book and options depth, square-root market impact and slippage estimates, turnover ratio, and Amihud illiquidity, rolled into a liquidity grade. Use this skill whenever the user asks about liquidity or trading costs — how easily a position can be entered or exited, what a large order would do to the price, spread or execution-cost estimates, order book depth, volume patterns, or liquidity comparisons — especially for small caps, penny stocks, and thinly traded names.

73

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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, well-architected skill body: request-routing table, executable per-metric functions, explicit defaults, honest limitation notes, and a working one-level-deep reference file. The main gaps are mild — some inline code and one motivation paragraph that could move to the reference, and a malformed dependency-probe snippet in Step 1.

Suggestions

Fix or remove the Step 1 dependency-check artifact — replace the `!\`python3 …\`` doubled-fence block with a plain executable check (e.g., a short `python3 -c "import yfinance, pandas, numpy"` probe) so the instruction is copy-paste runnable.

Move one or two of the longer inline functions (e.g., volume_analysis and turnover_analysis) into references/liquidity_reference.md alongside the existing templates, keeping SKILL.md to the dashboard, spread, and impact recipes it always needs.

Trim the 'Liquidity matters because…' motivation paragraph to a single line or drop it — Claude already knows why liquidity matters and only needs the operational caveats already covered in Step 3.

DimensionReasoningScore

Conciseness

The body is efficient — routing tables, defaults tables, and code that earns its tokens — but includes trimmable material: the 'Liquidity matters because…' motivation paragraph and five full inline analysis functions (~200 lines of code) where some could move to the reference file. It sits above 'mostly efficient with some unnecessary explanation' (anchor 3) but short of 'every token earns its place' (anchor 5).

4 / 5

Actionability

Sub-skills A, B, C, E, and F ship copy-paste-ready executable functions with concrete thresholds and presentation guidance, and D defers cleanly to a real reference template. It falls short of anchor 5 only because the Step 1 dependency probe block (the backtick-quoted `!\`python3 …\`` snippet inside a doubled code fence) is a malformed artifact rather than an executable command as written — a minor gap.

4 / 5

Workflow Clarity

The sequence is explicit — check/install deps, classify the request via the routing table, run the matched sub-skill, then respond using the Step 3 template — with genuine feedback loops: DEPS_MISSING → pip install → proceed, `if hist.empty` guards in code, and a mandate to report tickers that returned empty data. This matches the anchor for clear sequencing with explicit validation and error-recovery paths.

5 / 5

Progressive Disclosure

Structure is good: SKILL.md routes and carries the core recipes, while a real one-level-deep `references/liquidity_reference.md` (verified present, with matching sections like 'Order Book Depth Proxy' guidance and impact-curve code) is clearly signaled in both inline pointers and the 'Reference Files' section. It misses anchor 5 because the ~495-line main file retains bulkier inline code (volume, turnover, impact functions) that could be split out, leaving minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

100%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 model description: concrete capability enumeration, natural trigger phrases with synonyms and niche variants, an explicit 'Use this skill whenever…' clause, and a well-delineated niche. It reads as third-person/neutral and makes no over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and metrics — 'bid-ask spreads, volume and dollar volume (ADTV), top-of-book and options depth, square-root market impact and slippage estimates, turnover ratio, and Amihud illiquidity, rolled into a liquidity grade' — giving comprehensive, specific coverage rather than vague domain naming. No concrete capability is missing; it is not merely 'names domain and 1-2 actions' (anchor 3).

5 / 5

Completeness

It explicitly answers both what (the enumerated liquidity analyses and composite grade) and when via 'Use this skill whenever the user asks about liquidity or trading costs' followed by concrete trigger phrases. This matches the score-5 anchor exactly; the 'when' is explicit, not merely present-but-improvable (anchor 4).

5 / 5

Trigger Term Quality

It covers natural user phrasings comprehensively — 'how easily a position can be entered or exited', 'what a large order would do to the price', 'spread or execution-cost estimates', 'order book depth', 'volume patterns', 'liquidity comparisons' — plus synonyms and niche variants like 'small caps, penny stocks, and thinly traded names'. This matches the anchor for comprehensive natural-term coverage including synonyms, well above 'good coverage with a few natural terms missing' (anchor 4).

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — stock liquidity analysis via Yahoo Finance/yfinance with named metrics (Amihud, square-root impact, ADTV) — and its triggers ('how liquid', 'market impact', 'order book depth') are unlikely to fire for unrelated skills. Minor theoretical overlap with a generic market-analysis skill is not enough to drop below anchor 5's 'clear niche with distinct triggers'.

5 / 5

Total

20

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
himself65/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.