CtrlK
BlogDocsLog inGet started
Tessl Logo

market-top-detector

Detects market top probability using O'Neil Distribution Days, Minervini Leading Stock Deterioration, and Monty Defensive Sector Rotation. Generates a 0-100 composite score with risk zone classification. Use when user asks about market top risk, distribution days, defensive rotation, leadership breakdown, or whether to reduce equity exposure. Focuses on 2-8 week tactical timing signals for 10-20% corrections.

68

Quality

86%

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

78%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 body is a well-structured operational guide with fully executable commands, exact data-collection queries, and exemplary progressive disclosure to real reference files. Its main weakness is redundancy — duplicated freshness and API-key statements and a fully duplicated bilingual trigger list — plus the absence of an explicit data-validation feedback loop before script execution.

Suggestions

State the 3-business-day freshness rule and FMP API key requirement once (Prerequisites) and remove the duplicate 'API Requirements' section and repeated freshness line in Phase 1.

Trim or collapse the Japanese 'When to Use' block, which duplicates the six English trigger phrases verbatim and adds ~15% to the token load for no operational value.

Add an explicit validation checkpoint in Phase 1: 'Before running the script, confirm each [REQUIRED] value is within its valid range and dated within 3 business days; if not, use the fallback query/URL and re-collect.'

DimensionReasoningScore

Conciseness

The body is dense with high-signal material (scoring weights, CLI args, exact search queries) but repeats itself several times: the 3-business-day freshness rule appears in both 'Prerequisites' and 'Phase 1', the FMP API key requirement appears in both 'Prerequisites' and a separate 'API Requirements' section, and the Japanese 'When to Use' block fully duplicates the six English triggers. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4, where over-explanation is only minor.

3 / 5

Actionability

The body provides a copy-paste-ready bash invocation with all CLI flags, exact primary and fallback search query strings, direct fallback URLs with the specific fields to parse ('lastPrice' / 'tradeTime', 'Last Value' / 'Latest Period'), valid input ranges (e.g., 'Valid range: 20-100', '0.30-1.50'), and concrete output filenames. This is fully executable guidance covering the common execution path, matching anchor 5; the only nit — the script path assumes a repo-root layout and requirements.txt has no explicit pip command — does not rise to a 'minor gap' under anchor 4.

5 / 5

Workflow Clarity

The three-phase workflow (WebSearch collection → script execution → result presentation) is clearly sequenced, with fallback search strategies, 'Record the data date' instructions, and a freshness requirement acting as implicit input validation. However, there is no explicit validate-and-retry loop (e.g., 'if data is stale or out of the valid range, refetch before running the script'), and Phase 3 merely says to *highlight* freshness warnings rather than act on them, so it fits anchor 4 ('most checkpoints present; minor validation gaps') rather than anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

The SKILL.md body stays at overview level (component weight table, risk-zone mapping, workflow) and defers detail to three well-signaled, one-level-deep reference files — 'references/market_top_methodology.md', 'references/distribution_day_guide.md', 'references/historical_tops.md' — all of which exist in the bundle with content matching their descriptions, plus a 'When to Load References' section mapping situations to files. The split matches anchor 5's clear overview with easy navigation; nothing that belongs in references is inlined and there is no nesting.

5 / 5

Total

17

/

20

Passed

Description

88%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: concrete third-person capability statements, a numeric scoring output, and an explicit 'Use when...' clause with natural trigger phrases. Its only weaknesses are a handful of missing common trigger synonyms and no in-description disambiguation from closely related market-analysis skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions in third person voice: 'Detects market top probability using O'Neil Distribution Days, Minervini Leading Stock Deterioration, and Monty Defensive Sector Rotation', 'Generates a 0-100 composite score with risk zone classification', and 'Focuses on 2-8 week tactical timing signals for 10-20% corrections'. Named methodologies, a numeric score scale, risk zones, and a timeframe give comprehensive, concrete coverage — matching the anchor 5 example's density of specific actions rather than the anchor 4 example's minor gaps.

5 / 5

Completeness

It explicitly answers both questions: 'what' is 'Detects market top probability... Generates a 0-100 composite score with risk zone classification', and 'when' is the explicit clause 'Use when user asks about market top risk, distribution days, defensive rotation, leadership breakdown, or whether to reduce equity exposure'. This is a direct match for the anchor 5 example structure; neither half is missing or vague.

5 / 5

Trigger Term Quality

Natural trigger phrases are present — 'market top risk', 'distribution days', 'defensive rotation', 'leadership breakdown', 'whether to reduce equity exposure' — plus the named methodologies users might cite directly. A few common variations are missing ('is the market topping', 'market peak', 'correction risk', 'sell-off timing'), so it fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (tactical 2-8 week market-top timing via three named frameworks) and triggers like 'distribution days' and 'defensive rotation' are distinctive, but the description itself doesn't disambiguate from a sibling Bubble Detector skill (that differentiation only appears in the body), leaving minor overlap risk for general 'market risk' queries — fitting anchor 4 rather than anchor 5's minimal-conflict clear niche.

4 / 5

Total

18

/

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
tradermonty/claude-trading-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.