$npx -y skills add mphinance/alpha-skills --skill breadth-chart-analystThis 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 assessmen
| 1 | # Breadth Chart Analyst |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | ## When to Use |
| 8 | |
| 9 | Use this skill when: |
| 10 | - User provides S&P 500 Breadth Index (200-Day MA based) chart images for analysis |
| 11 | - User provides US Stock Market Uptrend Stock Ratio chart images for analysis |
| 12 | - User requests market breadth assessment or market health evaluation |
| 13 | - User asks about medium-term strategic positioning based on breadth indicators |
| 14 | - User needs short-term tactical timing signals for swing trading |
| 15 | - User wants combined strategic and tactical market outlook |
| 16 | - **User requests breadth analysis WITHOUT providing chart images** (CSV data mode) |
| 17 | |
| 18 | Do NOT use this skill when: |
| 19 | - User asks about individual stock analysis (use `us-stock-analysis` skill instead) |
| 20 | - User needs sector rotation analysis without breadth charts (use `sector-analyst` skill instead) |
| 21 | - User wants news-based market analysis (use `market-news-analyst` skill instead) |
| 22 | |
| 23 | ## Prerequisites |
| 24 | |
| 25 | - **Chart Images Optional**: CSV data from public sources is the PRIMARY data source; chart images provide supplementary visual context |
| 26 | - **No API Keys Required**: CSV data is fetched from public GitHub Pages; no external API subscriptions needed |
| 27 | - **Language**: All analysis and output conducted in English |
| 28 | |
| 29 | ## Output |
| 30 | |
| 31 | This skill generates markdown analysis reports saved to the `reports/` directory: |
| 32 | - Chart 1 only: `breadth_200ma_analysis_[YYYY-MM-DD].md` |
| 33 | - Chart 2 only: `uptrend_ratio_analysis_[YYYY-MM-DD].md` |
| 34 | - Both charts: `breadth_combined_analysis_[YYYY-MM-DD].md` |
| 35 | |
| 36 | Reports include executive summaries, current readings, signal identification, scenario analysis with probabilities, and actionable positioning recommendations for different trader types. |
| 37 | |
| 38 | ## Core Principles |
| 39 | |
| 40 | 1. **Dual-Timeframe Analysis**: Combine strategic (Chart 1: 200MA Breadth) and tactical (Chart 2: Uptrend Ratio) perspectives |
| 41 | 2. **Backtested Strategy Focus**: Apply proven systematic strategies based on historical patterns |
| 42 | 3. **Objective Signal Identification**: Focus on clearly defined thresholds, transitions, and markers |
| 43 | 4. **English Communication**: Conduct all analysis and generate all reports in English |
| 44 | 5. **Actionable Recommendations**: Provide specific positioning guidance for different investor types |
| 45 | |
| 46 | ## Chart Types and Purposes |
| 47 | |
| 48 | ### Chart 1: S&P 500 Breadth Index (200-Day MA Based) |
| 49 | |
| 50 | **Purpose**: Medium to long-term strategic market positioning |
| 51 | |
| 52 | **Key Elements**: |
| 53 | - **8-Day MA (Orange Line)**: Short-term breadth trend, primary entry signal generator |
| 54 | - **200-Day MA (Green Line)**: Long-term breadth trend, primary exit signal generator |
| 55 | - **Red Dashed Line (73%)**: Average peak level - market overheating threshold |
| 56 | - **Blue Dashed Line (23%)**: Average 8MA trough level - extreme oversold, excellent buying opportunity |
| 57 | - **Triangles**: |
| 58 | - Purple ▼ = 8MA troughs (buy signal when reverses) |
| 59 | - Blue ▼ = 200MA troughs (major cycle lows) |
| 60 | - Red ▲ = 200MA peaks (sell signal) |
| 61 | - **Pink Background**: Downtrend periods |
| 62 | |
| 63 | **Backtested Strategy**: |
| 64 | - **BUY**: When 8MA reverses from a trough (especially below 23%) |
| 65 | - **SELL**: When 200MA forms a peak (typically near/above 73%) |
| 66 | - **Result**: Historically high performance, avoids bear markets |
| 67 | |
| 68 | ### Chart 2: US Stock Market - Uptrend Stock Ratio |
| 69 | |
| 70 | **Purpose**: Short-term tactical timing and swing trading |
| 71 | |
| 72 | **Key Elements**: |
| 73 | - **Uptrend Stock Definition**: Stocks above 200MA/50MA/20MA with positive 1-month performance |
| 74 | - **Green Regions**: Market in uptrend phase |
| 75 | - **Red Regions**: Market in downtrend phase |
| 76 | - **~10% Level (Lower Orange Dashed)**: Short-term bottom, extreme oversold |
| 77 | - **~40% Level (Upper Orange Dashed)**: Short-term top, market overheating |
| 78 | |
| 79 | **Swing Trading Strategy**: |
| 80 | - **ENTER LONG**: When color changes from red to green (especially from <10-15% levels) |
| 81 | - **EXIT LONG**: When color changes from green to red (especially from >35-40% levels) |
| 82 | - **Timeframe**: Days to weeks |
| 83 | |
| 84 | ## Analysis Workflow |
| 85 | |
| 86 | ### Step 0: Fetch CSV Data (PRIMARY SOURCE - MANDATORY) |
| 87 | |
| 88 | **CRITICAL**: CSV data is the PRIMARY source for all Breadth values |