CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

75

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 a strong, well-structured skill: clear routing to six sub-skills, fully executable code for the core analyses, honest limitation notes, and a well-organized one-level-deep reference file that delivers everything the body promises. Weaknesses are minor — some trimmable explanatory padding and a few missing validation checkpoints for flaky upstream data.

Suggestions

Trim the motivational opening ('Liquidity matters because...') and the 'Illiquidity premium' educational note; Claude already knows why liquidity matters, so these tokens can be reclaimed.

Add a brief validation/retry checkpoint after data fetching: what to do when yfinance returns partial info (bid/ask of 0/None) or times out, e.g. one line pointing to the reference's 'Edge Cases and Gotchas' section.

Clarify or generalize the host-specific '!' shell-probe preamble (line 16), which reads as tailored to one host environment; a single generic 'check dependencies before proceeding' instruction would be clearer.

DimensionReasoningScore

Conciseness

The body is largely efficient — routing tables, defaults, executable functions, and checklists all earn their tokens — but contains minor over-explanation that could be trimmed: the motivational paragraph 'Liquidity matters because it determines the real cost of trading. The quoted price is not what you actually pay', the educational 'Illiquidity premium' note, and the host-specific '!' shell-probe preamble. It is not a 5 because a few passages explain concepts Claude already knows; it is not a 3 because padding is incidental, not pervasive.

4 / 5

Actionability

Sub-skills A, B, C, E, and F include complete, copy-paste-ready Python functions covering the common cases (dashboard, spread, volume, impact curve, turnover), and the two sections without inline code (B2, D1) point to verified sections in references/liquidity_reference.md containing the full templates. It is not a 4 because the guidance is fully executable end-to-end, with data access, computation, and presentation output all specified.

5 / 5

Workflow Clarity

The three-step sequence (dependency probe with DEPS_MISSING feedback loop, routing table with explicit request-to-sub-skill mapping, response checklist) is clear, with empty-data handling in code and mandatory caveats. It is not a 5 because some validation gaps remain — no guidance for retrying or degraded results when yfinance calls fail intermittently (a known flakiness), and no explicit checkpoint that fetched quote fields (bid/ask) were actually populated before interpreting spreads. It is not a 3 because checkpoints for the main failure modes (missing deps, empty history, invalid tickers) are present and explicit.

4 / 5

Progressive Disclosure

Structure is clean: a routing table and defaults up front, core sub-skills with inline code, and a single one-level-deep reference (references/liquidity_reference.md, 438 lines with its own table of contents) that genuinely contains the sections the body signals ('Options Spread Analysis' §341, 'Order Book Depth Proxy' §363), plus a closing 'Reference Files' section stating when to read it. It is not a 4 because navigation is easy and the split is appropriate with no orphaned or nested references.

5 / 5

Total

18

/

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.

The description is exemplary: it enumerates concrete capabilities in third person, provides an explicit 'Use when' clause rich with natural user phrasings and synonyms, and defines a distinct niche with minimal conflict risk. Both the 'what' and 'when' questions are answered clearly and specifically.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific capabilities — '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' — which comprehensively covers the skill's functionality with no generic filler. It is not a 4 because coverage extends across every sub-capability of the skill rather than leaving minor gaps.

5 / 5

Completeness

Both 'what' (first sentence enumerates the analysis capabilities and data source 'Yahoo Finance data (yfinance)') and 'when' ('Use this skill whenever the user asks about liquidity or trading costs — ...') are explicitly and concretely answered with trigger phrases. It is not a 4 because the 'when' clause is fully explicit with concrete trigger examples rather than merely serviceable.

5 / 5

Trigger Term Quality

Natural user phrasings are covered comprehensively: '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', plus synonyms like 'small caps, penny stocks, and thinly traded names'. It is not a 4 because it goes beyond domain keywords to include full natural question forms users would actually say.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — stock liquidity/execution-cost analysis via yfinance — with triggers ('bid-ask spreads', 'market impact', 'thinly traded names') that would not fire for adjacent skills like general stock screening or options analysis. It is not a 4 because overlap risk is minimal, not just minor: every trigger term is liquidity-specific.

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

Path

plugins/market-analysis/skills/stock-liquidity/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.