Index of every page on this site: llms.txt
All skills
tradermonty avatar

/uptrend-analyzer

@f95e770
Run it yourself

Analyzes market breadth using Monty's Uptrend Ratio Dashboard data to diagnose the current market environment. Generates a 0-100 composite score from 5 components (breadth, sector participation, rotation, momentum, historical context). Use when asking about market breadth, uptrend ratios, or whether the market environment supports equity exposure. No API key required.

Use this Skill: https://skilld.dev/gh/tradermonty/claude-trading-skills/uptrend-analyzer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈97 tokens for metadata: the name and description. ≈1.5k when used: this file. ≈3.5k more on demand in 1 file.

Description uses 4.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈389 characters, or 4.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Uptrend Analyzer Skill

Purpose

Diagnose market breadth health using Monty's Uptrend Ratio Dashboard, which tracks ~2,800 US stocks across 11 sectors. Generates a 0-100 composite score (higher = healthier) with exposure guidance.

Unlike the Market Top Detector (API-based risk scorer), this skill uses free CSV data to assess "participation breadth" - whether the market's advance is broad or narrow.

When to Use This Skill

English:

  • User asks "Is the market breadth healthy?" or "How broad is the rally?"
  • User wants to assess uptrend ratios across sectors
  • User asks about market participation or breadth conditions
  • User needs exposure guidance based on breadth analysis
  • User references Monty's Uptrend Dashboard or uptrend ratios

Japanese:

  • 「市場のブレドスは健全?」「上昇の裾野は広い?」
  • セクター別のアップトレンド比率を確認したい
  • 相場参加率・ブレドス状況を診断したい
  • ブレドス分析に基づくエクスポージャーガイダンスが欲しい
  • Montyのアップトレンドダッシュボードについて質問

Prerequisites

  • Python 3.9+ with the requests library (CSV parsing uses the stdlib csv/io modules)
  • Internet connection to fetch CSV data from GitHub (no API key required)
  • No paid API subscriptions needed

Difference from Market Top Detector

Aspect Uptrend Analyzer Market Top Detector
Score Direction Higher = healthier Higher = riskier
Data Source Free GitHub CSV FMP API (paid)
Focus Breadth participation Top formation risk
API Key Not required Required (FMP)
Methodology Monty Uptrend Ratios O'Neil/Minervini/Monty

Execution Workflow

Phase 1: Execute Python Script

Run the analysis script (no API key needed):

python3 skills/uptrend-analyzer/scripts/uptrend_analyzer.py

The script will:

  1. Download CSV data from Monty's GitHub repository
  2. Calculate 5 component scores
  3. Generate composite score and reports

Phase 2: Present Results

Present the generated Markdown report to the user, highlighting:

  • Composite score and zone classification
  • Exposure guidance (Full/Normal/Reduced/Defensive/Preservation)
  • Sector heatmap showing strongest and weakest sectors
  • Key momentum and rotation signals

5-Component Scoring System

# Component Weight Key Signal
1 Market Breadth (Overall) 30% Ratio level + trend direction
2 Sector Participation 25% Uptrend sector count + ratio spread
3 Sector Rotation 15% Cyclical vs Defensive balance
4 Momentum 20% Slope direction + acceleration
5 Historical Context 10% Percentile rank in history

Scoring Zones

Score Zone Exposure Guidance
80-100 Strong Bull Full Exposure (100%)
60-79 Bull Normal Exposure (80-100%)
40-59 Neutral Reduced Exposure (60-80%)
20-39 Cautious Defensive (30-60%)
0-19 Bear Capital Preservation (0-30%)

7-Level Zone Detail

Each scoring zone is further divided into sub-zones for finer-grained assessment:

Score Zone Detail Color
80-100 Strong Bull Green
70-79 Bull-Upper Light Green
60-69 Bull-Lower Light Green
40-59 Neutral Yellow
30-39 Cautious-Upper Orange
20-29 Cautious-Lower Orange
0-19 Bear Red

Warning System

Active warnings trigger exposure penalties that tighten guidance even when the composite score is high:

Warning Condition Penalty
Late Cycle Commodity avg > both Cyclical and Defensive -5
High Spread Max-min sector ratio spread > 40pp -3
Divergence Intra-group std > 8pp, spread > 20pp, or trend dissenters -3

Penalties stack (max -10) + multi-warning discount (+1 when ≥2 active). Applied after composite scoring.

Momentum Smoothing

Slope values are smoothed using EMA(3) (Exponential Moving Average, span=3) before scoring. Acceleration is calculated by comparing the recent 10-point average vs prior 10-point average of smoothed slopes (10v10 window), with fallback to 5v5 when fewer than 20 data points are available.

Historical Confidence Indicator

The Historical Context component includes a confidence assessment based on:

  • Sample size: Number of historical data points available
  • Regime coverage: Proportion of distinct market regimes (bull/bear/neutral) observed
  • Recency: How recent the latest data point is

Confidence levels: High, Medium, Low.


API Requirements

Required: None (uses free GitHub CSV data)

Output Files

  • JSON: uptrend_analysis_YYYY-MM-DD_HHMMSS.json
  • Markdown: uptrend_analysis_YYYY-MM-DD_HHMMSS.md

Reference Documents

references/uptrend_methodology.md

  • Uptrend Ratio definition and thresholds
  • 5-component scoring methodology
  • Sector classification (Cyclical/Defensive/Commodity)
  • Historical calibration notes

When to Load References

  • First use: Load uptrend_methodology.md for full framework understanding
  • Regular execution: References not needed - script handles scoring

Same-run provenance

Pass --run-id daily-20261017-unique to both required market-regime-daily producers. Without it each producer generates its own unique ID. JSON includes schema 1.0 data_provenance with actual primary timeseries business date, UTC retrieval time, source and run ID. Unknown adjustment, point-in-time, survivorship and corporate-action flags are false. Auxiliary summary dates are unverified; this does not certify the freshness of every composite input. Missing or malformed primary dates stop report generation.

Pass the exact JSON paths printed by these invocations to Exposure Coach's --require-provenance --run-id … --as-of … mode. Run IDs are caller-provided consistency markers, not authenticity or point-in-time proof.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning25d5 checks · Risk SAFE
  • Gen Agent Trust Hub25d

    The skill is safe. It performs market breadth analysis by fetching CSV data from the author's official GitHub repository and processing it using standard Python scripts. No malicious behavior or security risks were identified.

  • Socket25d

    No alerts

  • Snyk25d

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    3/24 files flagged

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at f95e770. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month

README badge

README badge for tradermonty/claude-trading-skills/uptrend-analyzer