CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

whale-hunting

Detect institutional whale activity in options for a given underlying. Use when the user asks about unusual options activity, large block trades, whale trades, or institutional options flow for a specific symbol.

Quality

80%

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 ./.claude/skills/whale-hunting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-organized, highly actionable skill document that delegates computation to a real bundled script and gives explicit reporting guidance. The notable defect is a documented `--sigma` flag that the script does not implement, making one documented argument and one example non-executable.

Suggestions

Remove the `--sigma` argument from the Arguments section or implement it in scripts/whale_hunting.py, and fix the `--sigma 2.0` example accordingly, so every documented command runs as written.

Add brief guidance on handling the script's error JSON output (e.g. present the error message and suggest checking MASSIVE_API_KEY or the date) to close the workflow feedback-loop gap.

Tighten the Requirements/Timezone sections by merging them into the Instructions note, since they are each one or two lines that repeat behavior the script already implements.

DimensionReasoningScore

Conciseness

The body is a lean interface document — command, arguments, output schema, examples, report template — with almost no explanation of concepts Claude already knows. Minor items could be trimmed (the uv fallback note, some interpretation lines restating fields), keeping it just below the "every token earns its place" anchor.

4 / 5

Actionability

Commands are copy-paste ready ("uv run python .claude/skills/whale-hunting/scripts/whale_hunting.py AAPL") with full argument defaults and output field definitions. However, the documented `--sigma` argument ("Std-deviation multiplier for crude outlier threshold (default: 3.0)") and the example using `--sigma 2.0` do not exist in the bundled scripts/whale_hunting.py, so that example would fail — a minor gap that prevents a 5.

4 / 5

Workflow Clarity

The run-then-report sequence is unambiguous, with an explicit header template, table format, sort order ("Sort by total_invested descending"), and documented fallback semantics ("source: 'yahoo only' — Fallback; daily-level data"). The minor gap is no guidance for handling the script's error JSON output, so it does not reach the 5 anchor's explicit feedback loops.

4 / 5

Progressive Disclosure

The heavy logic correctly lives in the bundled scripts/whale_hunting.py, which exists and is referenced via its install path, and the body is a well-sectioned ~90-line overview. It is not a 5 because the file exceeds the lean threshold with all detail (output schema, reporting rules) inline and no well-signaled separate reference files.

4 / 5

Total

16

/

20

Passed

Description

78%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 with an explicit what-and-when structure and natural trigger phrases in third-person voice. Its main limitation is thin capability specificity — a single detect verb with no enumeration of the concrete actions the skill performs.

DimensionReasoningScore

Specificity

"Detect institutional whale activity in options for a given underlying" names a clear domain and one concrete action (detect), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions (e.g. chain scanning, per-second drill-down, flow reporting), so it is not a 4.

3 / 5

Completeness

It explicitly answers both what ("Detect institutional whale activity in options for a given underlying") and when ("Use when the user asks about unusual options activity, large block trades, whale trades, or institutional options flow") with concrete trigger phrases — a direct match to the top anchor. Third-person voice is used correctly.

5 / 5

Trigger Term Quality

"unusual options activity, large block trades, whale trades, or institutional options flow" provides good natural keyword coverage a user would plausibly say. It falls short of comprehensive (5) because common variations like plain "options flow", "sweep", or "big money in options" are absent.

4 / 5

Distinctiveness Conflict Risk

The niche (institutional whale activity in options, per-symbol) is distinct with specific triggers like "whale trades" and "large block trades". It is mostly distinct but has minor overlap risk with a general options-screening or options-analysis skill that could also trigger on "unusual options activity", so it fits the 4 anchor rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

staskh/trading_skills

Path

.claude/skills/whale-hunting/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.