market-top-detector

Compute a 0-100 market top score from distribution days, leadership health, and defensive rotation.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/kavi-lin/stock --skill market-top-detector-kavi-lin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: market-top-detector
Source: https://github.com/kavi-lin/stock/tree/main/skills/market-top-detector
Command: npx skills add https://github.com/kavi-lin/stock --skill market-top-detector-kavi-lin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The Market Top Detector provides a structured, quantitative assessment of the probability that a market top is forming by aggregating six diverse signals into a single, interpretable score.

Core Features & Use Cases

  • Unified top-detection score: Combines distribution days, leading stock health, defensive rotation, breadth divergence, index technicals, and sentiment into a single 0-100 score.
  • Early warning and tactical guidance: Indicates risk zones (Green to Critical) and delivers recommended actions for varying market conditions.
  • Scenario planning & historical context: Generates what-if scenarios and compares current patterns to major historical tops to aid decision-making.
  • Operational data integration: Uses live price data, breadth metrics (via TraderMonty CSV), and FMP API data to produce up-to-date analyses.

Quick Start

Ask your AI to run a Market Top Detector analysis with the latest data to see a composite score and recommended actions.

Frequently Asked Questions about market-top-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect a market top using distribution days and breadth divergence?

Market top detection aggregates O'Neil distribution days, breadth divergence, and leading stock health into a unified 0-100 composite score. This structured quantitative assessment indicates the probability that a market top is forming and signals when to reduce equity exposure.

What is the best way to quantify market top risk for tactical timing signals?

Quantifying market top risk combines defensive sector rotation, index technicals, and sentiment into a single 0-100 score. This approach assesses 2-8 week tactical timing signals, categorizes risk zones from Green to Critical, and delivers recommended actions for varying market conditions.

How do I calculate a market top composite score using FMP API and breadth CSV data?

Calculating the market top composite score requires fetching live price data from S&P 500 indices and leading ETFs via FMP API calls, alongside breadth metrics from TraderMonty CSV data. These inputs compute the score and generate actionable guidance for equity exposure.

Does market top detection work with Minervini leading stock health analysis?

Market top detection integrates Minervini leading stock health as a core component of its composite score. It evaluates the health of leading stocks alongside O'Neil distribution days and Monty defensive sector rotation to assess whether a market top is forming.

When should I reduce equity exposure based on market top risk zones?

You should reduce equity exposure when the market top composite score enters elevated risk zones. The detector maps the 0-100 score to Green to Critical risk zones, delivering recommended actions and scenario planning to help you adjust equity exposure during 2-8 week tactical windows.

Can I compare current market top patterns to major historical tops for scenario planning?

Comparing current market top patterns to major historical tops is a core feature of market top detection. The tool generates what-if scenarios and historical context alongside the composite score, aiding decision-making by mapping current breadth divergence and distribution days to past market tops.