[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B9JPHND78AM9DFTPHB4RCX":3,"skill-same:01M7B9JPHND78AM9DFTPHB4RCX":60},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7B9JPHND78AM9DFTPHB4RCX","jerryliu369-breadth-chart-analyst",null,"jiayaoqijia\u002Fcryptoskill","jiayaoqijia","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1453879?v=4","01M6GMYTX7Q7S504VC6E756ENR","YQ","01M6GMYV1QKJ1CC75MTTGT9PR0",81,"MIT","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"\u003C!--\n  Imported from: https:\u002F\u002Fgithub.com\u002Ftradermonty\u002Fclaude-trading-skills\n  Source Path: skills\u002Fbreadth-chart-analyst\u002FSKILL.md\n  Curated for awesome-quant-skills\n-->\n\n---\nname: breadth-chart-analyst\ndescription: 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.\n---\n\n# Breadth Chart Analyst\n\n## Overview\n\nThis 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.\n\n## When to Use\n\nUse this skill when:\n- User provides S&P 500 Breadth Index (200-Day MA based) chart images for analysis\n- User provides US Stock Market Uptrend Stock Ratio chart images for analysis\n- User requests market breadth assessment or market health evaluation\n- User asks about medium-term strategic positioning based on breadth indicators\n- User needs short-term tactical timing signals for swing trading\n- User wants combined strategic and tactical market outlook\n- **User requests breadth analysis WITHOUT providing chart images** (CSV data mode)\n\nDo NOT use this skill when:\n- User asks about individual stock analysis (use `us-stock-analysis` skill instead)\n- User needs sector rotation analysis without breadth charts (use `sector-analyst` skill instead)\n- User wants news-based market analysis (use `market-news-analyst` skill instead)\n\n## Prerequisites\n\n- **Chart Images Optional**: CSV data from public sources is the PRIMARY data source; chart images provide supplementary visual context\n- **No API Keys Required**: CSV data is fetched from public GitHub Pages; no external API subscriptions needed\n- **Language**: All analysis and output conducted in English\n\n## Output\n\nThis skill generates markdown analysis reports saved to the `reports\u002F` directory:\n- Chart 1 only: `breadth_200ma_analysis_[YYYY-MM-DD].md`\n- Chart 2 only: `uptrend_ratio_analysis_[YYYY-MM-DD].md`\n- Both charts: `breadth_combined_analysis_[YYYY-MM-DD].md`\n\nReports include executive summaries, current readings, signal identification, scenario analysis with probabilities, and actionable positioning recommendations for different trader types.\n\n## Core Principles\n\n1. **Dual-Timeframe Analysis**: Combine strategic (Chart 1: 200MA Breadth) and tactical (Chart 2: Uptrend Ratio) perspectives\n2. **Backtested Strategy Focus**: Apply proven systematic strategies based on historical patterns\n3. **Objective Signal Identification**: Focus on clearly defined thresholds, transitions, and markers\n4. **English Communication**: Conduct all analysis and generate all reports in English\n5. **Actionable Recommendations**: Provide specific positioning guidance for different investor types\n\n## Chart Types and Purposes\n\n### Chart 1: S&P 500 Breadth Index (200-Day MA Based)\n\n**Purpose**: Medium to long-term strategic market positioning\n\n**Key Elements**:\n- **8-Day MA (Orange Line)**: Short-term breadth trend, primary entry signal generator\n- **200-Day MA (Green Line)**: Long-term breadth trend, primary exit signal generator\n- **Red Dashed Line (73%)**: Average peak level - market overheating threshold\n- **Blue Dashed Line (23%)**: Average 8MA trough level - extreme oversold, excellent buying opportunity\n- **Triangles**:\n  - Purple ▼ = 8MA troughs (buy signal when reverses)\n  - Blue ▼ = 200MA troughs (major cycle lows)\n  - Red ▲ = 200MA peaks (sell signal)\n- **Pink Background**: Downtrend periods\n\n**Backtested Strategy**:\n- **BUY**: When 8MA reverses from a trough (especially below 23%)\n- **SELL**: When 200MA forms a peak (typically near\u002Fabove 73%)\n- **Result**: Historically high performance, avoids bear markets\n\n### Chart 2: US Stock Market - Uptrend Stock Ratio\n\n**Purpose**: Short-term tactical timing and swing trading\n\n**Key Elements**:\n- **Uptrend Stock Definition**: Stocks above 200MA\u002F50MA\u002F20MA with positive 1-month performance\n- **Green Regions**: Market in uptrend phase\n- **Red Regions**: Market in downtrend phase\n- **~10% Level (Lower Orange Dashed)**: Short-term bottom, extreme oversold\n- **~40% Level (Upper Orange Dashed)**: Short-term top, market overheating\n\n**Swing Trading Strategy**:\n- **ENTER LONG**: When color changes from red to green (especially from \u003C10-15% levels)\n- **EXIT LONG**: When color changes from green to red (especially from >35-40% levels)\n- **Timeframe**: Days to weeks\n\n## Analysis Workflow\n\n### Step 0: Fetch CSV Data (PRIMARY SOURCE - MANDATORY)\n\n**CRITICAL**: CSV data is the PRIMARY source for all Breadth values. This step MUST be executed BEFORE any image analysis.\n\n```bash\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Ffetch_breadth_csv.py\n```\n\n**Why CSV is PRIMARY**:\n- OpenCV image detection is fragile -- chart format changes cause catastrophic failures (Issue #7)\n- CSV provides exact numerical values directly from the data source\n- Image analysis is SUPPLEMENTARY only (for visual trend context)\n\n**Data Sources**:\n1. **Market Breadth**: `tradermonty.github.io\u002Fmarket-breadth-analysis\u002Fmarket_breadth_data.csv`\n   - Provides: 200-Day MA, 8-Day MA, Trend, Dead Cross status\n2. **Uptrend Ratio**: `tradermonty\u002Fuptrend-dashboard\u002Fdata\u002Fuptrend_ratio_timeseries.csv`\n   - Provides: Current ratio, 10MA, slope, trend (UP\u002FDOWN), color (GREEN\u002FRED)\n3. **Sector Summary**: `tradermonty\u002Fuptrend-dashboard\u002Fdata\u002Fsector_summary.csv`\n   - Provides: Per-sector ratio, trend, status (overbought\u002Foversold)\n\n**Data Source Priority**:\n| Priority | Source | Use For | Reliability |\n|----------|--------|---------|-------------|\n| 1 (PRIMARY) | **CSV Data** | All numerical values, dead cross status, color | HIGH |\n| 2 (SUPPLEMENTARY) | **Chart Image** | Visual trend context, pattern confirmation | MEDIUM |\n| 3 (DEPRECATED) | ~~OpenCV detect_breadth_values.py~~ | ~~Breadth detection~~ | **UNRELIABLE** |\n| 4 (LAST RESORT) | ~~LLM visual reading~~ | ~~Emergency only~~ | LOW |\n\n**Expected Output**:\n```\n============================================================\nBreadth Data (CSV) - 2026-02-13\n============================================================\n--- Market Breadth (S&P 500) ---\n200-Day MA: 62.26% (healthy (>=60%))\n8-Day MA:   67.56% (healthy_bullish (60-73%))\n8MA vs 200MA: +5.30pt (8MA ABOVE -- NO dead cross)\nTrend: UPTREND\n--- Uptrend Ratio (All Markets) ---\nCurrent: 33.03% GREEN (neutral_bullish)\n10MA: 32.65%, Slope: +0.0055, Trend: UP\n--- Sector Summary ---\n...\n============================================================\n```\n\n**Validation**: After running CSV fetch, verify:\n- [ ] CSV data retrieved successfully\n- [ ] 200-Day MA value recorded\n- [ ] 8-Day MA value recorded\n- [ ] Dead cross status determined (8MA \u003C 200MA = dead cross)\n- [ ] Uptrend Ratio value + color + trend recorded\n- [ ] Use these CSV values as the authoritative source for all subsequent analysis\n\n---\n\n### Step 1: Receive Chart Images and Prepare Analysis\n\nWhen the user provides breadth chart images for analysis:\n\n1. Confirm receipt of chart image(s)\n2. Identify which chart(s) are provided:\n   - Chart 1 only (200MA Breadth)\n   - Chart 2 only (Uptrend Ratio)\n   - Both charts\n3. Note any specific focus areas or questions from the user\n4. **CRITICAL: Extract right edge of chart images before analysis** (Step 1.5)\n\n**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.\n\n**Language Note**: All subsequent thinking, analysis, and output will be in English.\n\n### Step 1.5: Two-Stage Chart Analysis (MANDATORY when charts provided)\n\n**CRITICAL**: Use a **two-stage analysis** approach to prevent misreading historical data as current values.\n\n#### Stage 1: Full Chart Analysis (Historical Context)\n\nFirst, analyze the FULL chart image to understand:\n- Overall historical trend and cycles\n- Key historical events (troughs, peaks, recoveries)\n- Long-term patterns and context\n\n#### Stage 2: Right Edge Focused Analysis (Current Values)\n\nThen, extract and analyze the **rightmost 25%** of the chart to accurately determine CURRENT values.\n\n**Execute the Python script to extract the right edge:**\n\n```bash\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Fextract_chart_right_edge.py \u003Cimage_path> --percent 25\n```\n\n#### Why Two-Stage Analysis is Mandatory\n\n| Stage | Purpose | What to Extract |\n|-------|---------|-----------------|\n| **Stage 1 (Full)** | Historical context, trend cycles | Overall patterns, past troughs\u002Fpeaks |\n| **Stage 2 (Right Edge)** | **Current values (CRITICAL)** | 8MA value, 200MA value, current color, current slope |\n\n**Common Error This Prevents:**\n- LLM reads 2025 mid-year dip (8MA ~25-30%) instead of current value (8MA ~60-65%)\n- By isolating the right edge, the \"current\" data is unambiguous\n\n#### Analysis Protocol\n\n1. **Read full chart** → Document historical context\n2. **Run extraction script** → Generate right edge image\n3. **Read right edge image** → Document current values with HIGH CONFIDENCE\n4. **Cross-check**: If Stage 1 and Stage 2 values differ significantly, **Stage 2 (right edge) takes precedence**\n5. **Report both**: Include Stage 1 context AND Stage 2 current values in analysis\n\n### Step 2: Load Breadth Chart Methodology\n\nBefore beginning analysis, read the comprehensive breadth chart methodology:\n\n```\nRead: references\u002Fbreadth_chart_methodology.md\n```\n\nThis reference contains detailed guidance on:\n- Chart 1: 200MA-based breadth index interpretation and strategy\n- Chart 2: Uptrend stock ratio interpretation and strategy\n- Signal identification and threshold significance\n- Strategy rules and risk management\n- Combining both charts for optimal decision-making\n- Common pitfalls to avoid\n\n### Step 3: Examine Sample Charts (First Time or for Reference)\n\nTo understand the chart format and visual elements, review the sample charts included in this skill:\n\n```\nView: assets\u002FSP500_Breadth_Index_200MA_8MA.jpeg\nView: assets\u002FUS_Stock_Market_Uptrend_Ratio.jpeg\n```\n\nThese samples demonstrate:\n- Visual appearance and structure of each chart type\n- How signals and thresholds are displayed\n- Color coding and marker systems\n- Historical patterns and cycles\n\n### Step 4: Analyze Chart 1 (200MA-Based Breadth Index)\n\nIf Chart 1 is provided, conduct systematic analysis:\n\n#### 4.1 Extract Current Readings\n\nFrom the chart image, identify:\n- **Current 8MA level** (orange line): Specific percentage\n- **Current 200MA level** (green line): Specific percentage\n- **8MA slope**: Rising, falling, or flat\n- **200MA slope**: Rising, falling, or flat\n- **Distance from 73% threshold**: How close to overheating\n- **Distance from 23% threshold**: How close to extreme oversold\n- **Most recent date** visible on the chart\n\n#### 4.1.5 CRITICAL: Latest Data Point Detailed Trend Analysis\n\n**This step is MANDATORY to avoid misreading recent trend changes.**\n\n**CRITICAL WARNING**: Charts can be deceptive. The MAJORITY of analysis errors occur because the analyst:\n1. Confuses the 8MA (orange) with the 200MA (green)\n2. Reads historical trends instead of the CURRENT rightmost data points\n3. Misidentifies which line is rising vs falling\n\n**BEFORE analyzing trend direction, FIRST confirm line colors**:\n- ✓ **8MA = ORANGE line** (fast-moving, more volatile)\n- ✓ **200MA = GREEN line** (slow-moving, smoother)\n- If unsure which is which, STOP and re-examine the chart legend\u002Fcolors\n\nFocus intensively on the **rightmost 3-5 data points** of the chart (most recent weeks):\n\n**For 8MA (Orange Line) - Analyze the very latest trajectory**:\n1. **Identify the absolute latest position**: Where is the 8MA at the rightmost edge of the chart?\n2. **Trace back 3-5 data points** (approximately 3-5 weeks):\n   - What was the 8MA level 1 week ago?\n   - What was the 8MA level 2 weeks ago?\n   - What was the 8MA level 3 weeks ago?\n3. **Calculate the directional change**:\n   - Is the latest value HIGHER or LOWER than 1 week ago?\n   - Is the latest value HIGHER or LOWER than 2 weeks ago?\n   - What is the trend: consistently rising, consistently falling, or mixed?\n4. **Determine the CURRENT slope** (not historical slope):\n   - **Rising**: Latest data point is higher than previous 2-3 points AND shows upward curvature\n   - **Falling**: Latest data point is lower than previous 2-3 points AND shows downward curvature\n   - **Flat**: Latest data point is approximately equal to previous points (within 2-3%)\n\n**Critical Questions to Answer**:\n- [ ] Is the 8MA currently moving UP or DOWN at the rightmost edge?\n- [ ] If there was a recent trough, has the 8MA **sustained** the upward move, or has it rolled over?\n- [ ] Count consecutive periods of increase: How many consecutive periods has 8MA risen? (Need 2-3 for confirmation)\n- [ ] Count consecutive periods of decrease: How many consecutive periods has 8MA fallen? (Indicates failed reversal if declining after trough)\n\n**For 200MA (Green Line) - Analyze the very latest trajectory**:\n1. **Identify the absolute latest position**: Where is the 200MA at the rightmost edge?\n2. **Trace back 4-6 weeks**:\n   - What was the 200MA level 2 weeks ago?\n   - What was the 200MA level 4 weeks ago?\n3. **Determine the CURRENT slope**:\n   - Is it rising, falling, or flat in the most recent period?\n\n**Failed Reversal Detection** (CRITICAL):\nIf an 8MA trough (purple ▼) was recently identified:\n- [ ] Did the 8MA rise for only 1-2 periods and then turn back down?\n- [ ] Did the 8MA fail to reach 60% before turning down?\n- [ ] Is the 8MA currently declining again after the bounce?\n- **If YES to any**: This is a **FAILED REVERSAL** - DO NOT ENTER, signal is INVALID\n\n**Example Analysis Format**:\n```\nLatest 8MA Data Points (rightmost to left):\n- Current (Week 0): 48%\n- 1 week ago: 52%\n- 2 weeks ago: 55%\n- 3 weeks ago: 50%\n\nAnalysis: 8MA is FALLING. It rose from 50% to 55% (weeks 3-2), but has since declined to 48%.\nThis shows a failed reversal pattern - bounce was temporary, downtrend has resumed.\nSLOPE: Falling (not rising!)\n```\n\n**MANDATORY CROSS-CHECK** (to catch misreadings):\nAfter determining the trend, ask yourself:\n- [ ] \"If I claimed 8MA is RISING, but it's actually been FALLING for weeks, what would that look like?\"\n  - Answer: The rightmost data points would be LOWER than previous points (confirming FALLING)\n- [ ] \"Does my analysis match the visual slope of the orange line at the rightmost edge?\"\n  - If orange line visually slopes DOWN at the right edge → It's FALLING\n  - If orange line visually slopes UP at the right edge → It's RISING\n- [ ] \"Is there any pink background shading (downtrend) near the rightmost edge?\"\n  - If YES → This confirms downtrend conditions, 8MA is likely FALLING\n- [ ] \"Are the 8MA and 200MA converging (getting closer) or diverging?\"\n  - Converging from below → Potential death cross forming → BEARISH\n  - Converging from above → Potential golden cross forming → BULLISH\n\n#### 4.2 Identify Signal Markers\n\nLook for and document:\n- **Most recent 8MA trough (purple ▼)**: Date and level\n- **Most recent 200MA trough (blue ▼)**: Date and level (if visible in timeframe)\n- **Most recent 200MA peak (red ▲)**: Date and level\n- **Days\u002Fweeks since most recent signals**\n- **Any pink background shading** (downtrend periods)\n\n#### 4.3 Assess Market Regime\n\nBased on readings and patterns, classify the current market as:\n- Healthy Bull Market\n- Overheated Bull Market\n- Market Top\u002FDistribution Phase\n- Bear Market\u002FCorrection\n- Capitulation\u002FExtreme Oversold\n- Early Recovery\n\nSupport the classification with specific evidence from the chart.\n\n#### 4.4 Determine Strategy Position\n\nApply the backtested strategy rules with STRICT confirmation requirements:\n\n**Check for BUY signal** (ALL criteria must be met):\n1. ✓ **Trough Formation**: Has 8MA formed a clear trough (purple ▼)?\n2. ✓ **Reversal Initiated**: Has 8MA begun to move upward from the trough?\n3. ✓ **Confirmation Achieved**: Has 8MA risen for 2-3 CONSECUTIVE periods after the trough?\n4. ✓ **No Recent Reversal**: Based on Step 4.1.5 analysis, is 8MA CURRENTLY rising (not falling)?\n5. ✓ **Sustained Move**: Has 8MA maintained the upward trajectory without rolling over?\n6. ⭐ **Optional but Strong**: Is 8MA below or near 23% (extreme oversold) at trough?\n\n**BUY Signal Status**:\n- **CONFIRMED**: All 5 required criteria met → ENTER LONG\n- **DEVELOPING**: Trough formed, but \u003C 2-3 consecutive increases → WAIT, MONITOR\n- **FAILED**: Trough formed, but 8MA has rolled over and is declining → DO NOT ENTER, WAIT FOR NEXT TROUGH\n- **NO SIGNAL**: No trough formed → WAIT\n\n**Check for SELL signal**:\n- Has 200MA formed a peak (red ▲)?\n- Is 200MA near or above 73%?\n- Is this an active sell signal requiring position exit?\n\n**Current position determination**:\n- **Long**: BUY signal confirmed, position entered and held\n- **Preparing to Enter**: BUY signal developing (trough formed, watching for confirmation)\n- **WAIT \u002F Flat**: No valid signal OR failed reversal detected\n- **Preparing to Exit**: SELL signal developing (200MA approaching peak)\n\n#### 4.5 Develop Scenarios\n\nCreate 2-3 scenarios with probability estimates:\n- Base case scenario (highest probability)\n- Alternative scenario(s)\n- Each scenario includes: description, supporting factors, strategy implications, key levels\n\n### Step 5: Analyze Chart 2 (Uptrend Stock Ratio)\n\nIf Chart 2 is provided, conduct systematic analysis:\n\n#### 5.0 ~~MANDATORY~~ DEPRECATED: Uptrend Ratio Detection Script (Superseded by Step 0 CSV Fetch)\n\n**NOTE (Issue #7)**: This OpenCV detection step is **DEPRECATED**. Use CSV data from Step 0 as the PRIMARY source. The OpenCV script may be run for supplementary validation only, but CSV values take precedence in all cases.\n\n```bash\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Fdetect_uptrend_ratio.py \u003Cimage_path> [--debug]\n```\n\n#### 5.1 Extract Current Readings\n\nFrom the chart image, identify:\n- **Current uptrend stock ratio**: Specific percentage\n- **Current color**: Green (uptrend) or Red (downtrend)\n- **Ratio slope**: Rising, falling, or flat\n- **Distance from 10% threshold**: How close to extreme oversold\n- **Distance from 40% threshold**: How close to overbought\n- **Most recent date** visible on the chart\n\n#### 5.2 Identify Trend Transitions\n\nLook for and document:\n- **Most recent red-to-green transition**: Date and ratio level at transition\n- **Most recent green-to-red transition**: Date and ratio level at transition\n- **Duration of current color phase**: How long in current trend\n- **Days\u002Fweeks since most recent transition**\n\n#### 5.3 Assess Market Condition\n\nBased on current ratio and color, classify as:\n- Extreme Oversold (\u003C10%)\n- Moderate Bearish (10-20%, red)\n- Neutral\u002FTransitional (20-30%)\n- Moderate Bullish (30-37%, green)\n- Extreme Overbought (>37-40%)\n\nSupport the classification with specific evidence from the chart.\n\n#### 5.4 Determine Trading Position\n\nApply the swing trading strategy rules:\n\n**Check for ENTER LONG signal**:\n- Has color changed from red to green?\n- Was the transition from an oversold level (\u003C15%)?\n- Is the transition confirmed (2-3 days of green)?\n\n**Check for EXIT LONG signal**:\n- Has color changed from green to red?\n- Was the transition from an overbought level (>35%)?\n- Is momentum weakening?\n\n**Current position**: Long, Flat, Preparing to Enter, or Preparing to Exit\n\n#### 5.5 Develop Scenarios\n\nCreate 2-3 scenarios with probability estimates:\n- Base case scenario (highest probability)\n- Alternative scenario(s)\n- Each scenario includes: description, supporting factors, trading implications, key levels\n\n### Step 6: Combined Analysis (When Both Charts Provided)\n\nIf both charts are provided, integrate the strategic and tactical perspectives:\n\n#### 6.1 Alignment Assessment\n\nCreate a positioning matrix:\n- **Chart 1 (Strategic)**: Bullish \u002F Bearish \u002F Neutral + signal status\n- **Chart 2 (Tactical)**: Bullish \u002F Bearish \u002F Neutral + signal status\n- **Combined Implication**: How do they align or conflict?\n\n#### 6.2 Scenario Classification\n\nDetermine which of the four scenarios applies:\n\n**Scenario 1: Both Bullish**\n- Chart 1: 8MA rising, 200MA not yet peaked\n- Chart 2: Green (uptrend), ratio rising from oversold\n- Implication: Maximum bullish stance, aggressive positioning\n\n**Scenario 2: Strategic Bullish, Tactical Bearish**\n- Chart 1: 8MA rising, 200MA not yet peaked\n- Chart 2: Red (downtrend), ratio falling or elevated\n- Implication: Hold core long positions, wait for tactical entry\n\n**Scenario 3: Strategic Bearish, Tactical Bullish**\n- Chart 1: 200MA peaked or declining\n- Chart 2: Green (uptrend), ratio rising\n- Implication: Short-term tactical trades only, tight stops\n\n**Scenario 4: Both Bearish**\n- Chart 1: Both MAs declining\n- Chart 2: Red (downtrend), ratio falling\n- Implication: Defensive positioning, cash or shorts\n\n#### 6.3 Unified Recommendation\n\nProvide integrated positioning guidance for:\n- **Long-term investors** (based primarily on Chart 1)\n- **Swing traders** (based primarily on Chart 2)\n- **Active tactical traders** (based on combination)\n\nAddress any conflicts between charts and explain resolution.\n\n### Step 7: Generate Analysis Report in English\n\nCreate a comprehensive markdown report using the template structure:\n\n```\nRead and use as template: assets\u002Fbreadth_analysis_template.md\n```\n\n**IMPORTANT**: All analysis and output must be in English.\n\nThe report structure varies based on which chart(s) are analyzed:\n\n**If Chart 1 only**:\n- Executive Summary\n- Chart 1 full analysis sections\n- Summary and Conclusion\n- Omit Chart 2 and Combined Analysis sections\n\n**If Chart 2 only**:\n- Executive Summary\n- Chart 2 full analysis sections\n- Summary and Conclusion\n- Omit Chart 1 and Combined Analysis sections\n\n**If Both Charts**:\n- Executive Summary\n- Chart 1 full analysis sections\n- Chart 2 full analysis sections\n- Combined Analysis section (mandatory)\n- Summary and Conclusion\n\n**File Naming Convention**: Save each analysis as:\n- Chart 1 only: `breadth_200ma_analysis_[YYYY-MM-DD].md`\n- Chart 2 only: `uptrend_ratio_analysis_[YYYY-MM-DD].md`\n- Both charts: `breadth_combined_analysis_[YYYY-MM-DD].md`\n\n### Step 8: Quality Assurance\n\nBefore finalizing the report, verify:\n\n1. ✓ **Language**: All content is in English (thinking and output)\n2. ✓ **Line Color Verification**: Explicitly confirmed 8MA = ORANGE, 200MA = GREEN before trend analysis\n3. ✓ **Latest Data Trend Analysis**: Step 4.1.5 was thoroughly completed - the most recent 3-5 data points were analyzed to determine CURRENT trend direction\n4. ✓ **Trend Direction Accuracy**: The stated 8MA slope (Rising\u002FFalling\u002FFlat) accurately reflects the RIGHTMOST data points, not historical movement\n5. ✓ **Cross-Check Completed**: MANDATORY CROSS-CHECK questions were answered to confirm trend direction matches visual slope\n6. ✓ **Death\u002FGolden Cross Check**: If 8MA and 200MA are converging, explicitly identified whether death cross or golden cross is forming\n7. ✓ **Failed Reversal Check**: If a trough was identified, explicitly verified whether the reversal sustained or failed by analyzing latest trajectory\n8. ✓ **Specific Values**: All readings include specific percentages\u002Flevels, not vague descriptions\n9. ✓ **Signal Status**: Clear identification of active signals (CONFIRMED BUY \u002F DEVELOPING \u002F FAILED \u002F SELL \u002F WAIT)\n10. ✓ **Strategy Alignment**: Recommendations align with backtested strategies and confirmation requirements\n11. ✓ **Probabilities**: Scenario probabilities sum to 100%\n12. ✓ **Actionable**: Clear positioning recommendations for different trader types\n13. ✓ **Context**: Historical comparison and reference to similar past situations\n14. ✓ **Risk Management**: Invalidation levels and risk factors clearly stated\n\n**FINAL SANITY CHECK**:\n- [ ] If report claims \"BUY signal\" or \"8MA rising\", confirm this doesn't contradict user's chart showing death cross or downtrend\n- [ ] If report claims \"bullish\", confirm there's no pink background shading or death cross visible\n- [ ] If unsure about ANY trend direction, explicitly state uncertainty rather than guessing\n\n## Quality Standards\n\n### Objectivity Requirements\n\n- Base all analysis strictly on observable chart data\n- Do not incorporate external information (news, fundamentals) unless specifically relevant\n- Use precise technical terminology consistently\n- Distinguish clearly between factual observations and probabilistic forecasts\n- Acknowledge uncertainty when signals are ambiguous\n\n### Completeness Requirements\n\n- Address all relevant sections of the analysis template\n- Provide specific numerical values for all key metrics\n- Justify probability estimates with technical factors\n- Include invalidation levels for each scenario\n- Compare current readings to historical patterns visible on the charts\n\n### Clarity Requirements\n\n- Write in professional, analytical English\n- Use clear section headings and structure\n- Present information in tables where appropriate\n- Make recommendations specific and actionable\n- Avoid jargon without explanation\n\n### Strategy Adherence Requirements\n\n- Apply backtested strategy rules correctly\n- Distinguish between strategic (Chart 1) and tactical (Chart 2) signals\n- Provide clear position status (Long\u002FFlat\u002FEntering\u002FExiting)\n- Include specific entry\u002Fexit levels when applicable\n- Address risk management (stop losses, position sizing)\n\n## Common Analysis Errors and How to Avoid Them\n\n### Error 1: Confusing 8MA with 200MA\n\n**Symptom**: Report claims 8MA is rising when it's actually the 200MA that's rising\n\n**Prevention**:\n- ALWAYS verify: 8MA = ORANGE, 200MA = GREEN\n- Check line volatility: 8MA moves faster with more volatility\n- If unsure, state: \"Based on line color, I identify the [orange\u002Fgreen] line as [8MA\u002F200MA]\"\n\n### Error 2: Reading Historical Trends Instead of Current Direction\n\n**Symptom**: Report describes what happened 1-2 months ago, not what's happening NOW\n\n**Prevention**:\n- Focus ONLY on rightmost 3-5 data points\n- Explicitly write: \"At the CURRENT rightmost edge, 8MA is at X% and is [rising\u002Ffalling]\"\n- Ignore what happened in September if we're analyzing November\n\n### Error 3: Missing Death Cross or Golden Cross Formation\n\n**Symptom**: Report is bullish when 8MA and 200MA are about to death cross (bearish)\n\n**Prevention**:\n- ALWAYS check: \"Are 8MA and 200MA getting closer (converging) or further apart (diverging)?\"\n- If converging with 8MA above 200MA → Potential death cross → BEARISH\n- If converging with 8MA below 200MA → Potential golden cross → BULLISH\n- Explicitly state: \"8MA is currently [above\u002Fbelow] 200MA, and they are [converging\u002Fdiverging]\"\n\n### Error 4: Ignoring Pink Background Shading\n\n**Symptom**: Report claims bullish setup when chart shows pink downtrend background\n\n**Prevention**:\n- Check for pink shading at the rightmost edge\n- Pink background = Downtrend period = Bearish conditions\n- If pink shading present, report MUST acknowledge bearish conditions\n\n### Error 5: Claiming Reversal Too Early\n\n**Symptom**: Report says \"BUY signal confirmed\" after only 1 week of increase\n\n**Prevention**:\n- Require 2-3 CONSECUTIVE weeks of 8MA increase for confirmation\n- If only 1 week: Signal is \"DEVELOPING\", not \"CONFIRMED\"\n- If 8MA rises then falls again: Signal is \"FAILED\", not valid\n\n## Example Usage Scenarios\n\n### Example 1: CSV-Only Analysis (No Charts)\n\n```\nUser: \"breadth分析して\" (Analyze breadth)\n[No chart images provided]\n\nBreadth Analyst:\n1. Executes fetch_breadth_csv.py to get latest CSV data\n2. Reads breadth_chart_methodology.md\n3. Analyzes CSV data:\n   - 200MA: 62.26% (healthy)\n   - 8MA: 67.56% (healthy_bullish)\n   - 8MA vs 200MA: +5.30pt (NO dead cross)\n   - Uptrend Ratio: 33.03% GREEN (neutral_bullish)\n   - Sector summary with overbought\u002Foversold sectors\n4. Assesses market regime based on CSV values\n5. Generates report: breadth_combined_analysis_2026-03-16.md\n```\n\n### Example 2: Strategic Breadth Analysis (Chart 1 Only)\n\n```\nUser: \"Please analyze this S&P 500 breadth chart and tell me where we are in the market cycle.\"\n[Provides Chart 1 image: 200MA Breadth Index]\n\nBreadth Analyst (thinking in English):\n1. Executes CSV fetch for authoritative numerical values\n2. Confirms receipt of Chart 1 (200MA-based breadth index)\n3. Reads breadth_chart_methodology.md for Chart 1 guidance\n4. Two-stage analysis: full chart → right edge extraction\n5. Cross-checks CSV values with chart readings\n6. Generates comprehensive report in English\n```\n\n### Example 3: Combined Strategic + Tactical Analysis (Both Charts)\n\n```\nUser: \"Analyze both of these breadth charts and give me your overall market view.\"\n[Provides both Chart 1 and Chart 2 images]\n\nBreadth Analyst (thinking in English):\n1. Executes CSV fetch as PRIMARY source\n2. Confirms receipt of both charts\n3. Reads full breadth_chart_methodology.md\n4. Two-stage analysis for each chart\n5. Cross-checks all values against CSV data\n6. Combined assessment and unified recommendation\n7. Generates comprehensive combined report\n```\n\n## Resources\n\nThis skill includes the following bundled resources:\n\n### references\u002Fbreadth_chart_methodology.md\n\nComprehensive methodology covering:\n- **Chart 1 (200MA Breadth)**: Components, interpretation, market regimes, backtested strategy, analysis checklist\n- **Chart 2 (Uptrend Ratio)**: Components, interpretation, market conditions, swing trading strategy, analysis checklist\n- **Combined Analysis**: Alignment scenarios, integrated decision-making\n- **Common Pitfalls**: Mistakes to avoid for each chart type\n\n**Usage**: Read this file before conducting any breadth chart analysis to ensure systematic, accurate interpretation.\n\n### assets\u002Fbreadth_analysis_template.md\n\nStructured template for breadth analysis reports in English.\n\n**Usage**: Use this template structure for every analysis report.\n\n### assets\u002FSP500_Breadth_Index_200MA_8MA.jpeg\n\nSample Chart 1 image for format reference.\n\n### assets\u002FUS_Stock_Market_Uptrend_Ratio.jpeg\n\nSample Chart 2 image for format reference.\n\n### scripts\u002Ffetch_breadth_csv.py\n\n**PRIMARY data source**. Fetches market breadth, uptrend ratio, and sector summary data from public CSV sources. Uses only stdlib (urllib + csv) -- no external dependencies.\n\n```bash\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Ffetch_breadth_csv.py        # Human-readable\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Ffetch_breadth_csv.py --json  # JSON output\n```\n\n### scripts\u002Fextract_chart_right_edge.py\n\nExtracts the rightmost portion of chart images to help focus on latest data points. Requires PIL\u002FPillow.\n\n```bash\npython3 skills\u002Fbreadth-chart-analyst\u002Fscripts\u002Fextract_chart_right_edge.py \u003Cimage_path> --percent 25\n```\n\n### scripts\u002Fdetect_uptrend_ratio.py (DEPRECATED)\n\nOpenCV-based uptrend ratio detection. Superseded by CSV fetch. Requires opencv-python + numpy.\n\n### scripts\u002Fdetect_breadth_values.py (DEPRECATED)\n\nOpenCV-based breadth value detection. Superseded by CSV fetch. Requires opencv-python + numpy.\n\n## Special Notes\n\n### Language Requirement\n\n**CRITICAL**: All analysis, thinking, and output MUST be in English. This includes:\n- Internal analysis and reasoning\n- Report generation\n- Tables and data presentation\n- Scenario descriptions\n- Recommendations\n\nDo not translate or use any other language. The user expects English output exclusively.\n\n### Strategy Focus\n\nThis skill emphasizes backtested, systematic strategies rather than discretionary interpretation. Always:\n- Apply the strategy rules as documented\n- Reference historical performance patterns\n- Provide specific entry\u002Fexit criteria\n- Include risk management guidance\n\n### Practical Application\n\nThe goal is actionable intelligence. Every analysis should answer:\n- **Strategic**: Should I be long, flat, or short the market over the medium term?\n- **Tactical**: Should I enter or exit positions in the short term?\n- **Timing**: When should I act, and at what levels?\n- **Risk**: What would invalidate this view, and where should stops be?\n",{},"main","4aff87e77e63c1886a978b82902814d015f55a4f","skills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst",17,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia","https:\u002F\u002Feth2030.com","Hardcore infra. Building @alt-research and applied cryptography.","2026-11-15 02:28:10",{"source":7,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add jiayaoqijia\u002Fcryptoskill --skill jerryliu369-breadth-chart-analyst",{"tool":38,"command":39},"bunx","bunx skills add jiayaoqijia\u002Fcryptoskill --skill jerryliu369-breadth-chart-analyst",{"tool":41,"command":42},"pnpm","pnpm dlx skills add jiayaoqijia\u002Fcryptoskill --skill jerryliu369-breadth-chart-analyst","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst\u002FSKILL.md",true,[46,50,56],{"path":47,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":15},"LICENSE","许可证",1068,{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"SOURCE.md","REFERENCE","参考文档",390,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst\u002FSOURCE.md",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"TRUST.auto.yaml",2197,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fjerryliu369-breadth-chart-analyst\u002FTRUST.auto.yaml",[61,69,77,85,93,101],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":65,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7DTKCERMV0RNX3HZJP4CZ26","troves","Deposit and withdraw from Troves DeFi yield vault strategies on Starknet. View available strategies, check positions, and manage vault deposits. Use this skill when the user mentions Troves, vault, yield vault, DeFi vault, strategy, yield farming, vault deposit, vault withdraw, earning yield through vaults, passive yield strategies, or wants to deposit into or withdraw from a yield strategy — even if they don't say \"Troves\" explicitly.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-troves\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-troves\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7DTK6CJSMGC8KCQHGNYFZBD","trade","Swap tokens on Starknet via Fibrous DEX aggregator. Supports per-provider selection (avnu, ekubo, or auto to race all). Use this skill when the user wants to swap, exchange, trade, convert, buy, or sell one token for another on Starknet. Also use when the user asks about token prices, exchange rates, DEX routing, best swap route, or wants to check how much they would receive for a given amount — even if they don't explicitly say \"swap\".","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-trade\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-trade\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":81,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7DTJZ6A0X4PAW3Y8W4J9K64","staking","Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, staking pools, rewards, compounding, unstaking, earning yield, passive income on crypto, or wants to earn on their STRK or BTC tokens — even if they don't say \"stake\" explicitly.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-staking\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-staking\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M7DTJSDZJKCDMW7GHRF4BRH5","send","Send STRK, ETH, or any ERC-20 token to a Starknet address. Supports simulation (dry-run) before execution. Use this skill when the user wants to send, transfer, pay, tip, or move tokens to another wallet address on Starknet. Also trigger when the user mentions sending funds to someone, making a payment, transferring assets, or moving crypto to a specific address — even if they just say \"pay 10 STRK to 0x...\".","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-send\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-send\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":97,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7DTJG1E480D51ZQ7WKDQ26K","portfolio","View a comprehensive DeFi portfolio dashboard and optimize portfolio allocation via automated rebalancing. Use this skill when the user wants an overview, summary, dashboard, total value, net worth, portfolio rebalancing, target allocation, or wants to see all their DeFi positions across Starknet at once. Also trigger when the user asks \"what do I have\", \"show me everything\", \"how much am I worth\", \"my positions\", \"my investments\", \"rebalance my portfolio\", \"I want 50% ETH\", \"optimize my holdings\", or any request for a holistic view of their Starknet holdings — even if they don't explicitly say \"portfolio\".","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-portfolio\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-portfolio\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":105,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7DTJ7M8TE9R2N36HFBZDGVD","multi-swap","Execute multiple token swaps in a single Starknet transaction via Fibrous (default). Supports per-provider selection (avnu, ekubo, or auto to race all). Supports 2-3 swap pairs bundled into one multicall. Use this skill when the user wants to swap multiple token pairs at once, do batch swaps, execute several trades simultaneously, perform parallel swaps, or do bulk trading in one transaction. Also trigger when the user mentions \"two swaps\", \"three swaps\", \"swap X and Y at the same time\", or wants to convert multiple tokens in a single call.","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-multi-swap\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fmcp-servers\u002Fahmetenesdur-multi-swap\u002FSKILL.md",[],[]]