breadth-chart-analyst
This skill should be used when analyzing market breadth charts, specifically the S&P 500 Breadth Index (200-Day MA based) and the US Stock Market Uptrend Stock Ratio charts.
Install / Use
npx skills add tradermonty/claude-trading-skills --skill breadth-chart-analystInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Data & AnalyticsSupported Platforms
Our assessment of breadth-chart-analyst
breadth-chart-analyst scores 95/100 on our quality scale, 79th of 604 Data & Analytics skills we index (top 14%).
Its SKILL.md is 32 KB long, well organised into 67 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
With 2,885 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so breadth-chart-analyst is actively maintained.
- Our last check on 2026-11-16 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
breadth-chart-analyst compared with similar skills
All 4 of these similar skills score higher than breadth-chart-analyst; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| breadth-chart-analyst (this skill)by tradermonty | 95 | 2.9k | 53d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| LocalAIby mudler | 100 | 50.4k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install breadth-chart-analyst?
- Run
npx skills add tradermonty/claude-trading-skills --skill breadth-chart-analyst. The install tabs above show the steps for each supported agent. - Which AI agents does breadth-chart-analyst work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is breadth-chart-analyst safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is breadth-chart-analyst still maintained?
- The repository was last updated about 2 months ago, so breadth-chart-analyst is actively maintained.
Skill content
View source on GitHubname: breadth-chart-analyst description: This skill should be used when analyzing market breadth charts, specifically the S&P 500 Breadth Index (200-Day MA based) and the US Stock Market Uptrend Stock Ratio charts. Use this skill when the user provides breadth chart images for analysis, requests market breadth assessment, positioning strategy recommendations, or wants to understand medium-term strategic and short-term tactical market outlook based on breadth indicators. Also works WITHOUT chart images by fetching CSV data directly from public sources. All analysis and output are conducted in English.
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-analysisskill instead) - User needs sector rotation analysis without breadth charts (use
sector-analystskill instead) - User wants news-based market analysis (use
market-news-analystskill 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
- Dual-Timeframe Analysis: Combine strategic (Chart 1: 200MA Breadth) and tactical (Chart 2: Uptrend Ratio) perspectives
- Backtested Strategy Focus: Apply proven systematic strategies based on historical patterns
- Objective Signal Identification: Focus on clearly defined thresholds, transitions, and markers
- English Communication: Conduct all analysis and generate all reports in English
- 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 <10-15% levels)
- EXIT LONG: When color changes from green to red (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:
- Market Breadth:
tradermonty.github.io/market-breadth-analysis/market_breadth_data.csv- Provides: 200-Day MA, 8-Day MA, Trend, Dead Cross status
- Uptrend Ratio:
tradermonty/uptrend-dashboard/data/uptrend_ratio_timeseries.csv- Provides: Current ratio, 10MA, slope, trend (UP/DOWN), color (GREEN/RED)
- Sector Summary:
tradermonty/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 detect_breadth_values.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 < 200MA = dead cross)
- [ ] Uptrend Ratio value + color + trend recorded
- [ ] Use these CSV values as the authoritative source for all subsequent analysis
Step 1: Receive Chart Images and Prepare Analysis
When the user provides breadth chart images for analysis:
- Confirm receipt of chart image(s)
- Identify which chart(s) are provided:
- Chart 1 only (200MA Breadth)
- Chart 2 only (Uptrend Ratio)
- Both charts
- Note any specific focus areas or questions from the user
- CRITICAL: Extract right edge of chart images before analysis (Step 1.5)
If NO chart images are provided: Skip Steps 1, 1.5, and image-based analysis. Use CSV data from Step 0 as the sole data source and proceed directly to the analysis and report generation steps.
Language Note: All subsequent thinking, analysis, and output will be in English.
Step 1.5: Two-Stage Chart Analysis (MANDATORY when charts provided)
CRITICAL: Use a two-stage analysis approach to prevent misreading historical data as current values.
Stage 1: Full Chart Analysis (Historical Context)
First, analyze the FULL chart image to understand:
- Overall historical trend and cycles
- Key historical events (troughs, peaks, recoveries)
- Long-term patterns and context
Stage 2: Right Edge Focused Analysis (Current Values)
Then, extract and analyze the rightmost 25% of the chart to accurately determine CURRENT values.
Execute the Python script to extract the right edge:
python3 skills/breadth-chart-analyst/scripts/extract_chart_right_edge.py <image_path> --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
- Read full chart → Document historical context
- Run extraction script → Generate right edge image
- Read right edge image → Document current values with HIGH CONFIDENCE
- Cross-check: If Stage 1 and Stage 2 values differ significantly, Stage 2 (right edge) takes precedence
- 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/breadth_chart_methodology.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: assets/SP500_Breadth_Index_200MA_8MA.jpeg
View: assets/US_Stock_Market_Uptrend_Ratio.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:
- Confuses the 8MA (orange) with the 200MA (green)
- Reads historical trends instead of the CURRENT rightmost data points
- 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:
- **Identify
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
LocalAI
50.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
