Install any skill in seconds. Free to start, no credit card required.
Get Started Free →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. All analysis and output are conducted in English.
.claude/skills/nicepkg-breadth-chart-analyst/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-02 | ✗→✓ | ▲ Improved | 181% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 296% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 277% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 270% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 283% | 0% |
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.
Purpose: Medium to long-term strategic market positioning
Key Elements:
Backtested Strategy:
Purpose: Short-term tactical timing and swing trading
Key Elements:
Swing Trading Strategy:
When the user provides breadth chart images for analysis:
Language Note: All subsequent thinking, analysis, and output will be in English.
Before beginning analysis, read the comprehensive breadth chart methodology:
Read: references/breadth_chart_methodology.mdThis reference contains detailed guidance on:
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.jpegThese samples demonstrate:
If Chart 1 is provided, conduct systematic analysis:
From the chart image, identify:
This step is MANDATORY to avoid misreading recent trend changes.
Focus intensively on the rightmost 3-5 data points of the chart (most recent weeks):
For 8MA (Orange Line) - Analyze the very latest trajectory:
Critical Questions to Answer:
For 200MA (Green Line) - Analyze the very latest trajectory:
Failed Reversal Detection (CRITICAL): If an 8MA trough (purple ▼) was recently identified:
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!)Look for and document:
Based on readings and patterns, classify the current market as:
Support the classification with specific evidence from the chart.
Apply the backtested strategy rules with STRICT confirmation requirements:
Check for BUY signal (ALL criteria must be met):
BUY Signal Status:
Check for SELL signal:
Current position determination:
Create 2-3 scenarios with probability estimates:
If Chart 2 is provided, conduct systematic analysis:
From the chart image, identify:
Look for and document:
Based on current ratio and color, classify as:
Support the classification with specific evidence from the chart.
Apply the swing trading strategy rules:
Check for ENTER LONG signal:
Check for EXIT LONG signal:
Current position: Long, Flat, Preparing to Enter, or Preparing to Exit
Create 2-3 scenarios with probability estimates:
If both charts are provided, integrate the strategic and tactical perspectives:
Create a positioning matrix:
Determine which of the four scenarios applies:
Scenario 1: Both Bullish
Scenario 2: Strategic Bullish, Tactical Bearish
Scenario 3: Strategic Bearish, Tactical Bullish
Scenario 4: Both Bearish
Provide integrated positioning guidance for:
Address any conflicts between charts and explain resolution.
Create a comprehensive markdown report using the template structure:
Read and use as template: assets/breadth_analysis_template.mdIMPORTANT: All analysis and output must be in English.
The report structure varies based on which chart(s) are analyzed:
If Chart 1 only:
If Chart 2 only:
If Both Charts:
File Naming Convention: Save each analysis as:
breadth_200ma_analysis_[YYYY-MM-DD].mduptrend_ratio_analysis_[YYYY-MM-DD].mdbreadth_combined_analysis_[YYYY-MM-DD].mdBefore finalizing the report, verify:
User: "Please analyze this S&P 500 breadth chart and tell me where we are in the market cycle."
[Provides Chart 1 image: 200MA Breadth Index]
Breadth Analyst (thinking in English):
1. Confirms receipt of Chart 1 (200MA-based breadth index)
2. Reads breadth_chart_methodology.md for Chart 1 guidance
3. Views sample chart for format reference
4. Extracts current readings:
- 8MA: 68%
- 200MA: 75%
- 8MA slope: Flat to slightly declining
- 200MA slope: Rising but may be forming peak
- Distance from 73% threshold: +2% (above threshold = overheated)
5. Identifies signals:
- Most recent 8MA trough: 3 months ago at 25%
- Most recent 200MA peak: None visible yet, but 200MA at 75% suggests potential peak forming
6. Assesses regime: Overheated Bull Market approaching Distribution Phase
7. Determines strategy position: Long position should prepare to exit; watch for 200MA peak confirmation
8. Develops scenarios:
- Base Case (55%): 200MA forms peak in next 1-2 weeks, sell signal activates
- Alternative (35%): Further consolidation at elevated levels before eventual peak
- Bear Case (10%): Immediate rollover without clear peak formation
9. Generates comprehensive report in English: breadth_200ma_analysis_2025-11-02.mdUser: "Should I be buying or selling here? Analyze this uptrend ratio chart."
[Provides Chart 2 image: Uptrend Stock Ratio]
Breadth Analyst (thinking in English):
1. Confirms receipt of Chart 2 (Uptrend stock ratio)
2. Reads breadth_chart_methodology.md for Chart 2 guidance
3. Views sample chart for format reference
4. Extracts current readings:
- Current ratio: 12%
- Current color: Green (uptrend)
- Ratio slope: Rising sharply
- Just transitioned from red to green 3 days ago at 11%
5. Identifies transitions:
- Most recent red-to-green: 3 days ago at 11% (from extreme oversold)
- Prior green-to-red: 2 weeks ago at 28%
6. Assesses condition: Early in new uptrend from extreme oversold
7. Determines trading position: ENTER LONG signal active, excellent risk/reward
8. Develops scenarios:
- Base Case (65%): Ratio continues higher to 30-35% over next 2-3 weeks
- Alternative (25%): Choppy advance, consolidates around 20% before next leg
- Bear Case (10%): False breakout, returns to red quickly
9. Generates tactical report in English: uptrend_ratio_analysis_2025-11-02.mdUser: "Analyze both of these breadth charts and give me your overall market view."
[Provides both Chart 1 and Chart 2 images]
Breadth Analyst (thinking in English):
1. Confirms receipt of both charts
2. Reads full breadth_chart_methodology.md
3. Views both sample charts
4. Analyzes Chart 1:
- 8MA: 55%, rising from trough 2 weeks ago at 30%
- 200MA: 60%, still rising
- Regime: Early Recovery to Healthy Bull Market
- Strategy: Long position, hold
5. Analyzes Chart 2:
- Ratio: 22%, green (uptrend)
- Transitioned red-to-green 10 days ago from 14%
- Condition: Moderate Bullish, building momentum
- Trading: Hold long, entered on transition
6. Combined assessment:
- Scenario 1: Both Bullish ✓
- Strategic: Bullish (8MA reversal confirmed)
- Tactical: Bullish (uptrend established from oversold)
- Alignment: Strong alignment = Maximum conviction
7. Unified recommendation:
- Long-term investors: Aggressive long positioning, core holdings
- Swing traders: Hold longs entered on red-to-green, target 35%+
- Active traders: Full position, favorable environment for longs
8. Develops integrated scenarios with probabilities
9. Generates comprehensive combined report in English: breadth_combined_analysis_2025-11-02.mdThis skill includes the following bundled resources:
Comprehensive methodology covering:
Usage: Read this file before conducting any breadth chart analysis to ensure systematic, accurate interpretation.
Structured template for breadth analysis reports in English:
Usage: Use this template structure for every analysis report. Adapt sections based on which chart(s) are being analyzed.
Sample Chart 1 image showing:
Usage: Reference this sample to understand Chart 1 visual format and identify similar patterns in user-provided charts.
Sample Chart 2 image showing:
Usage: Reference this sample to understand Chart 2 visual format and identify similar patterns in user-provided charts.
CRITICAL: All analysis, thinking, and output MUST be in English. This includes:
Do not translate or use any other language. The user expects English output exclusively.
This skill emphasizes backtested, systematic strategies rather than discretionary interpretation. Always:
The goal is actionable intelligence. Every analysis should answer:
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 24,760 | 16,758 | -32% | 1 | 1 | 0% | 3,875 | 6,329 | +63% | 0 | 0 | — |
case-02 | fail→pass | 22,822 | 24,369 | +7% | 1 | 1 | 0% | 3,490 | 9,802 | +181% | 0 | 0 | — |
case-03 | fail→pass | 20,095 | 37,520 | +87% | 1 | 1 | 0% | 3,074 | 12,170 | +296% | 0 | 0 | — |
case-04 | fail→pass | 11,215 | 5,493 | -51% | 1 | 1 | 0% | 1,805 | 6,812 | +277% | 0 | 0 | — |
case-05 | fail→pass | 11,533 | 5,353 | -54% | 1 | 1 | 0% | 1,854 | 6,856 | +270% | 0 | 0 | — |
case-06 | pass→pass | 10,570 | 4,528 | -57% | 1 | 1 | 0% | 1,682 | 6,682 | +297% | 0 | 0 | — |
case-07 | pass→pass | 10,570 | 6,875 | -35% | 1 | 1 | 0% | 1,503 | 6,972 | +364% | 0 | 0 | — |
case-08 | fail→pass | 10,384 | 2,969 | -71% | 1 | 1 | 0% | 1,669 | 6,394 | +283% | 0 | 0 | — |
case-09 | fail→pass | 10,476 | 7,106 | -32% | 1 | 1 | 0% | 1,481 | 7,017 | +374% | 0 | 0 | — |
case-10 | fail→pass | 9,459 | 4,601 | -51% | 1 | 1 | 0% | 1,366 | 6,688 | +390% | 0 | 0 | — |
case-11 | fail→pass | 9,927 | 9,349 | -6% | 1 | 1 | 0% | 1,462 | 7,509 | +414% | 0 | 0 | — |
case-12 | fail→pass | 8,589 | 3,052 | -64% | 1 | 1 | 0% | 1,397 | 6,512 | +366% | 0 | 0 | — |
case-13 | fail→pass | 8,265 | 2,879 | -65% | 1 | 1 | 0% | 1,304 | 6,493 | +398% | 0 | 0 | — |
case-14 | fail→pass | 7,152 | 2,991 | -58% | 1 | 1 | 0% | 1,185 | 6,466 | +446% | 0 | 0 | — |
case-15 | pass→pass | 8,517 | 2,761 | -68% | 1 | 1 | 0% | 1,275 | 6,382 | +401% | 0 | 0 | — |
case-16 | fail→pass | 12,079 | 6,496 | -46% | 1 | 1 | 0% | 1,999 | 6,975 | +249% | 0 | 0 | — |
case-17 | pass→pass | 14,320 | 5,156 | -64% | 1 | 1 | 0% | 1,985 | 6,753 | +240% | 0 | 0 | — |
case-18 | pass→pass | 6,986 | 6,135 | -12% | 1 | 1 | 0% | 1,103 | 6,750 | +512% | 0 | 0 | — |
case-19 | pass→pass | 4,990 | 3,570 | -28% | 1 | 1 | 0% | 829 | 6,424 | +675% | 0 | 0 | — |
case-20 | pass→pass | 10,504 | 6,725 | -36% | 1 | 1 | 0% | 1,586 | 6,951 | +338% | 0 | 0 | — |
case-21 | pass→pass | 11,627 | 9,242 | -21% | 1 | 1 | 0% | 2,169 | 7,685 | +254% | 0 | 0 | — |
case-22 | pass→pass | 15,877 | 18,183 | +15% | 1 | 1 | 0% | 3,172 | 9,998 | +215% | 0 | 0 | — |
case-23 | pass→pass | 13,615 | 9,591 | -30% | 1 | 1 | 0% | 2,523 | 7,599 | +201% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted, and 22 counted toward the lift figure. The other 1 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +52 percentage points is the difference between those two pass rates over the 22 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.