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.
npx skills add https://github.com/nicepkg/ai-workflow --skill breadth-chart-analyst
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.md
This 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.jpeg
These 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.
CRITICAL WARNING: Charts can be deceptive. The MAJORITY of analysis errors occur because the analyst:
BEFORE analyzing trend direction, FIRST confirm line 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:
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!)
MANDATORY CROSS-CHECK (to catch misreadings):
After determining the trend, ask yourself:
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.md
IMPORTANT: 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:
10. ✓ Strategy Alignment: Recommendations align with backtested strategies and confirmation requirements
11. ✓ Probabilities: Scenario probabilities sum to 100%
12. ✓ Actionable: Clear positioning recommendations for different trader types
13. ✓ Context: Historical comparison and reference to similar past situations
14. ✓ Risk Management: Invalidation levels and risk factors clearly stated
FINAL SANITY CHECK:
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.md
User: "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.md
User: "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.md
Symptom: Report claims 8MA is rising when it's actually the 200MA that's rising
Prevention:
Symptom: Report describes what happened 1-2 months ago, not what's happening NOW
Prevention:
Symptom: Report is bullish when 8MA and 200MA are about to death cross (bearish)
Prevention:
Symptom: Report claims bullish setup when chart shows pink downtrend background
Prevention:
Symptom: Report says "BUY signal confirmed" after only 1 week of increase
Prevention:
This 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:
Query the U.S. Treasury Fiscal Data REST API for federal financial data. No API key required. Use for national debt (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates, foreign exchange rates, savings bonds, or U.S. government revenue and spending statistics.
Comprehensive US stock analysis including fundamental analysis (financial metrics, business quality, valuation), technical analysis (indicators, chart patterns, support/resistance), stock comparisons, and investment report generation. Use when user requests analysis of US stock tickers (e.g., "analyze AAPL", "compare TSLA vs NVDA", "give me a report on Microsoft"), evaluation of financial metrics, technical chart analysis, or investment recommendations for American stocks.
> Zero-shot time series forecasting with Google's TimesFM foundation model. Use this skill when forecasting ANY univariate time series — sales, sensor readings, stock prices, energy demand, patient vitals, weather, or scientific measurements — without training a custom model. Automatically checks system RAM/GPU before loading the model, supports CSV/DataFrame/array inputs, and returns point forecasts with calibrated prediction intervals. Includes a preflight system checker script that MUST be run before first use to verify the machine can load the model. For classical statistical time series models (ARIMA, SARIMAX, VAR) use statsmodels; for time series classification/clustering use aeon.
Query the U.S. Treasury Fiscal Data API for federal financial data including national debt, government spending, revenue, interest rates, exchange rates, and savings bonds. Access 54 datasets and 182 data tables with no API key required. Use when working with U.S. federal fiscal data, national debt tracking (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates on Treasury securities, foreign exchange rates, savings bonds, or any U.S. government financial statistics.
Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially SubQuery/SubGraph). Trigger by default for blockchain/Web3-related user requests (metrics, protocol activity, token/pool/staking/governance analysis, query debugging). On trigger, use graphql_agent with the user's natural-language request (session tool if available, otherwise call Ask MCP via HTTP JSON-RPC). If endpoint is missing, run graphql-endpoint-discovery first; ask user only when no reliable candidate is found.
Cryptofeed - Real-time cryptocurrency market data feeds from 40+ exchanges. WebSocket streaming, normalized data, order books, trades, tickers. Python library for algorithmic trading and market data analysis.
Audit a spreadsheet for formula accuracy, errors, and common mistakes. Scopes to a selected range, a single sheet, or the entire model (including financial-model integrity checks like BS balance, cash tie-out, and logic sanity). Triggers on "audit this sheet", "check my formulas", "find formula errors", "QA this spreadsheet", "sanity check this", "debug model", "model check", "model won't balance", "something's off in my model", "model review".
Generate professional client-facing performance reports with portfolio returns, allocation breakdowns, and market commentary. Suitable for quarterly or annual distribution. Triggers on "client report", "performance report", "quarterly report for [client]", "generate reports", or "client statement".
Take nicepkg/ai-workflow-breadth-chart-analyst from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.