Breadth Chart Analyst

Breadth Chart Analyst

Overview

This skill enables specialized analysis of two complementary market breadth charts that provide strategic (medium to long-term) and tactical (short-term) market perspectives. Analyze breadth chart images to assess market health, identify trading signals based on backtested strategies, and develop positioning recommendations. All thinking and output are conducted exclusively in English.

When to Use

Use this skill when:

• User provides S&P 500 Breadth Index (200-Day MA based) chart images for analysis
• User provides US Stock Market Uptrend Stock Ratio chart images for analysis
• User requests market breadth assessment or market health evaluation
• User asks about medium-term strategic positioning based on breadth indicators
• User needs short-term tactical timing signals for swing trading
• User wants combined strategic and tactical market outlook
• User requests breadth analysis WITHOUT providing chart images (CSV data mode)

Do NOT use this skill when:

• User asks about individual stock analysis (use us-stock-analysis skill instead)
• User needs sector rotation analysis without breadth charts (use sector-analyst skill instead)
• User wants news-based market analysis (use market-news-analyst skill instead)

Prerequisites

• Chart Images Optional: CSV data from public sources is the PRIMARY data source; chart images provide supplementary visual context
• No API Keys Required: CSV data is fetched from public GitHub Pages; no external API subscriptions needed
• Language: All analysis and output conducted in English

Output

This skill generates markdown analysis reports saved to the reports/ directory:

• Chart 1 only: breadth_200ma_analysis_[YYYY-MM-DD].md
• Chart 2 only: uptrend_ratio_analysis_[YYYY-MM-DD].md
• Both charts: breadth_combined_analysis_[YYYY-MM-DD].md

Reports include executive summaries, current readings, signal identification, scenario analysis with probabilities, and actionable positioning recommendations for different trader types.

Core Principles

1. Dual-Timeframe Analysis: Combine strategic (Chart 1: 200MA Breadth) and tactical (Chart 2: Uptrend Ratio) perspectives
2. Backtested Strategy Focus: Apply proven systematic strategies based on historical patterns
3. Objective Signal Identification: Focus on clearly defined thresholds, transitions, and markers
4. English Communication: Conduct all analysis and generate all reports in English
5. Actionable Recommendations: Provide specific positioning guidance for different investor types

Chart Types and Purposes

Chart 1: S&P 500 Breadth Index (200-Day MA Based)

Purpose: Medium to long-term strategic market positioning

Key Elements:

• 8-Day MA (Orange Line): Short-term breadth trend, primary entry signal generator
• 200-Day MA (Green Line): Long-term breadth trend, primary exit signal generator
• Red Dashed Line (73%): Average peak level - market overheating threshold
• Blue Dashed Line (23%): Average 8MA trough level - extreme oversold, excellent buying opportunity
• Triangles:
• Purple ▼ = 8MA troughs (buy signal when reverses)
• Blue ▼ = 200MA troughs (major cycle lows)
• Red ▲ = 200MA peaks (sell signal)
• Pink Background: Downtrend periods

Backtested Strategy:

• BUY: When 8MA reverses from a trough (especially below 23%)
• SELL: When 200MA forms a peak (typically near/above 73%)
• Result: Historically high performance, avoids bear markets

Chart 2: US Stock Market - Uptrend Stock Ratio

Purpose: Short-term tactical timing and swing trading

Key Elements:

• Uptrend Stock Definition: Stocks above 200MA/50MA/20MA with positive 1-month performance
• Green Regions: Market in uptrend phase
• Red Regions: Market in downtrend phase
• ~10% Level (Lower Orange Dashed): Short-term bottom, extreme oversold
• ~40% Level (Upper Orange Dashed): Short-term top, market overheating

Swing Trading Strategy:

• ENTER LONG: When color changes from red to green (especially from 35-40% levels)
• Timeframe: Days to weeks

Analysis Workflow

Step 0: Fetch CSV Data (PRIMARY SOURCE - MANDATORY)

CRITICAL: CSV data is the PRIMARY source for all Breadth values. This step MUST be executed BEFORE any image analysis.

python3 skills/breadth-chart-analyst/scripts/fetch_breadth_csv.py

Why CSV is PRIMARY:

• OpenCV image detection is fragile -- chart format changes cause catastrophic failures (Issue #7)
• CSV provides exact numerical values directly from the data source
• Image analysis is SUPPLEMENTARY only (for visual trend context)

Data Sources:

1. Market Breadth: xonevn-ai.github.io/market-breadth-analysis/market_breadth_data.csv

• Provides: 200-Day MA, 8-Day MA, Trend, Dead Cross status

1. Uptrend Ratio: xonevn-ai/uptrend-dashboard/data/uptrend_ratio_timeseries.csv

• Provides: Current ratio, 10MA, slope, trend (UP/DOWN), color (GREEN/RED)

1. Sector Summary: xonevn-ai/uptrend-dashboard/data/sector_summary.csv

• Provides: Per-sector ratio, trend, status (overbought/oversold)

Data Source Priority: | Priority | Source | Use For | Reliability | |----------|--------|---------|-------------| | 1 (PRIMARY) | CSV Data | All numerical values, dead cross status, color | HIGH | | 2 (SUPPLEMENTARY) | Chart Image | Visual trend context, pattern confirmation | MEDIUM | | 3 (DEPRECATED) | ~~OpenCV detectbreadthvalues.py~~ | ~~Breadth detection~~ | UNRELIABLE | | 4 (LAST RESORT) | ~~LLM visual reading~~ | ~~Emergency only~~ | LOW |

Expected Output:

============================================================
Breadth Data (CSV) - 2026-02-13
============================================================
--- Market Breadth (S&P 500) ---
200-Day MA: 62.26% (healthy (>=60%))
8-Day MA:   67.56% (healthy_bullish (60-73%))
8MA vs 200MA: +5.30pt (8MA ABOVE -- NO dead cross)
Trend: UPTREND
--- Uptrend Ratio (All Markets) ---
Current: 33.03% GREEN (neutral_bullish)
10MA: 32.65%, Slope: +0.0055, Trend: UP
--- Sector Summary ---
...
============================================================

Validation: After running CSV fetch, verify:

• [ ] CSV data retrieved successfully
• [ ] 200-Day MA value recorded
• [ ] 8-Day MA value recorded
• [ ] Dead cross status determined (8MA --percent 25

#### Why Two-Stage Analysis is Mandatory

| Stage | Purpose | What to Extract |
|-------|---------|-----------------|
| **Stage 1 (Full)** | Historical context, trend cycles | Overall patterns, past troughs/peaks |
| **Stage 2 (Right Edge)** | **Current values (CRITICAL)** | 8MA value, 200MA value, current color, current slope |

**Common Error This Prevents:**
- LLM reads 2025 mid-year dip (8MA ~25-30%) instead of current value (8MA ~60-65%)
- By isolating the right edge, the "current" data is unambiguous

#### Analysis Protocol

1. **Read full chart** → Document historical context
2. **Run extraction script** → Generate right edge image
3. **Read right edge image** → Document current values with HIGH CONFIDENCE
4. **Cross-check**: If Stage 1 and Stage 2 values differ significantly, **Stage 2 (right edge) takes precedence**
5. **Report both**: Include Stage 1 context AND Stage 2 current values in analysis

### Step 2: Load Breadth Chart Methodology

Before beginning analysis, read the comprehensive breadth chart methodology:

Read: references/breadthchartmethodology.md

This reference contains detailed guidance on:
- Chart 1: 200MA-based breadth index interpretation and strategy
- Chart 2: Uptrend stock ratio interpretation and strategy
- Signal identification and threshold significance
- Strategy rules and risk management
- Combining both charts for optimal decision-making
- Common pitfalls to avoid

### Step 3: Examine Sample Charts (First Time or for Reference)

To understand the chart format and visual elements, review the sample charts included in this skill:

View: skills/breadth-chart-analyst/assets/SP500BreadthIndex200MA8MA.jpeg View: skills/breadth-chart-analyst/assets/USStockMarketUptrendRatio.jpeg

These samples demonstrate:
- Visual appearance and structure of each chart type
- How signals and thresholds are displayed
- Color coding and marker systems
- Historical patterns and cycles

### Step 4: Analyze Chart 1 (200MA-Based Breadth Index)

If Chart 1 is provided, conduct systematic analysis:

#### 4.1 Extract Current Readings

From the chart image, identify:
- **Current 8MA level** (orange line): Specific percentage
- **Current 200MA level** (green line): Specific percentage
- **8MA slope**: Rising, falling, or flat
- **200MA slope**: Rising, falling, or flat
- **Distance from 73% threshold**: How close to overheating
- **Distance from 23% threshold**: How close to extreme oversold
- **Most recent date** visible on the chart

#### 4.1.5 CRITICAL: Latest Data Point Detailed Trend Analysis

**This step is MANDATORY to avoid misreading recent trend changes.**

**CRITICAL WARNING**: Charts can be deceptive. The MAJORITY of analysis errors occur because the analyst:
1. Confuses the 8MA (orange) with the 200MA (green)
2. Reads historical trends instead of the CURRENT rightmost data points
3. Misidentifies which line is rising vs falling

**BEFORE analyzing trend direction, FIRST confirm line colors**:
- ✓ **8MA = ORANGE line** (fast-moving, more volatile)
- ✓ **200MA = GREEN line** (slow-moving, smoother)
- If unsure which is which, STOP and re-examine the chart legend/colors

Focus intensively on the **rightmost 3-5 data points** of the chart (most recent weeks):

**For 8MA (Orange Line) - Analyze the very latest trajectory**:
1. **Identify the absolute latest position**: Where is the 8MA at the rightmost edge of the chart?
2. **Trace back 3-5 data points** (approximately 3-5 weeks):
   - What was the 8MA level 1 week ago?
   - What was the 8MA level 2 weeks ago?
   - What was the 8MA level 3 weeks ago?
3. **Calculate the directional change**:
   - Is the latest value HIGHER or LOWER than 1 week ago?
   - Is the latest value HIGHER or LOWER than 2 weeks ago?
   - What is the trend: consistently rising, consistently falling, or mixed?
4. **Determine the CURRENT slope** (not historical slope):
   - **Rising**: Latest data point is higher than previous 2-3 points AND shows upward curvature
   - **Falling**: Latest data point is lower than previous 2-3 points AND shows downward curvature
   - **Flat**: Latest data point is approximately equal to previous points (within 2-3%)

**Critical Questions to Answer**:
- [ ] Is the 8MA currently moving UP or DOWN at the rightmost edge?
- [ ] If there was a recent trough, has the 8MA **sustained** the upward move, or has it rolled over?
- [ ] Count consecutive periods of increase: How many consecutive periods has 8MA risen? (Need 2-3 for confirmation)
- [ ] Count consecutive periods of decrease: How many consecutive periods has 8MA fallen? (Indicates failed reversal if declining after trough)

**For 200MA (Green Line) - Analyze the very latest trajectory**:
1. **Identify the absolute latest position**: Where is the 200MA at the rightmost edge?
2. **Trace back 4-6 weeks**:
   - What was the 200MA level 2 weeks ago?
   - What was the 200MA level 4 weeks ago?
3. **Determine the CURRENT slope**:
   - Is it rising, falling, or flat in the most recent period?

**Failed Reversal Detection** (CRITICAL):
If an 8MA trough (purple ▼) was recently identified:
- [ ] Did the 8MA rise for only 1-2 periods and then turn back down?
- [ ] Did the 8MA fail to reach 60% before turning down?
- [ ] Is the 8MA currently declining again after the bounce?
- **If YES to any**: This is a **FAILED REVERSAL** - DO NOT ENTER, signal is INVALID

**Example Analysis Format**:

Latest 8MA Data Points (rightmost to left):

• Current (Week 0): 48%
• 1 week ago: 52%
• 2 weeks ago: 55%
• 3 weeks ago: 50%

Analysis: 8MA is FALLING. It rose from 50% to 55% (weeks 3-2), but has since declined to 48%. This shows a failed reversal pattern - bounce was temporary, downtrend has resumed. SLOPE: Falling (not rising!)

**MANDATORY CROSS-CHECK** (to catch misreadings):
After determining the trend, ask yourself:
- [ ] "If I claimed 8MA is RISING, but it's actually been FALLING for weeks, what would that look like?"
  - Answer: The rightmost data points would be LOWER than previous points (confirming FALLING)
- [ ] "Does my analysis match the visual slope of the orange line at the rightmost edge?"
  - If orange line visually slopes DOWN at the right edge → It's FALLING
  - If orange line visually slopes UP at the right edge → It's RISING
- [ ] "Is there any pink background shading (downtrend) near the rightmost edge?"
  - If YES → This confirms downtrend conditions, 8MA is likely FALLING
- [ ] "Are the 8MA and 200MA converging (getting closer) or diverging?"
  - Converging from below → Potential death cross forming → BEARISH
  - Converging from above → Potential golden cross forming → BULLISH

#### 4.2 Identify Signal Markers

Look for and document:
- **Most recent 8MA trough (purple ▼)**: Date and level
- **Most recent 200MA trough (blue ▼)**: Date and level (if visible in timeframe)
- **Most recent 200MA peak (red ▲)**: Date and level
- **Days/weeks since most recent signals**
- **Any pink background shading** (downtrend periods)

#### 4.3 Assess Market Regime

Based on readings and patterns, classify the current market as:
- Healthy Bull Market
- Overheated Bull Market
- Market Top/Distribution Phase
- Bear Market/Correction
- Capitulation/Extreme Oversold
- Early Recovery

Support the classification with specific evidence from the chart.

#### 4.4 Determine Strategy Position

Apply the backtested strategy rules with STRICT confirmation requirements:

**Check for BUY signal** (ALL criteria must be met):
1. ✓ **Trough Formation**: Has 8MA formed a clear trough (purple ▼)?
2. ✓ **Reversal Initiated**: Has 8MA begun to move upward from the trough?
3. ✓ **Confirmation Achieved**: Has 8MA risen for 2-3 CONSECUTIVE periods after the trough?
4. ✓ **No Recent Reversal**: Based on Step 4.1.5 analysis, is 8MA CURRENTLY rising (not falling)?
5. ✓ **Sustained Move**: Has 8MA maintained the upward trajectory without rolling over?
6. ⭐ **Optional but Strong**: Is 8MA below or near 23% (extreme oversold) at trough?

**BUY Signal Status**:
- **CONFIRMED**: All 5 required criteria met → ENTER LONG
- **DEVELOPING**: Trough formed, but  [--debug]

5.1 Extract Current Readings

From the chart image, identify:

• Current uptrend stock ratio: Specific percentage
• Current color: Green (uptrend) or Red (downtrend)
• Ratio slope: Rising, falling, or flat
• Distance from 10% threshold: How close to extreme oversold
• Distance from 40% threshold: How close to overbought
• Most recent date visible on the chart

5.2 Identify Trend Transitions

Look for and document:

• Most recent red-to-green transition: Date and ratio level at transition
• Most recent green-to-red transition: Date and ratio level at transition
• Duration of current color phase: How long in current trend
• Days/weeks since most recent transition

5.3 Assess Market Condition

Based on current ratio and color, classify as:

• Extreme Oversold (37-40%)

Support the classification with specific evidence from the chart.

5.4 Determine Trading Position

Apply the swing trading strategy rules:

Check for ENTER LONG signal:

• Has color changed from red to green?
• Was the transition from an oversold level (35%)?
• Is momentum weakening?

Current position: Long, Flat, Preparing to Enter, or Preparing to Exit

5.5 Develop Scenarios

Create 2-3 scenarios with probability estimates:

• Base case scenario (highest probability)
• Alternative scenario(s)
• Each scenario includes: description, supporting factors, trading implications, key levels

Step 6: Combined Anal

…

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xonevn-ai
• Source: xonevn-ai/xone-trading-skills
• License: MIT
• Homepage: https://xone.vn

Install and usage instructions live in the source repository linked above.