momentum-scan

Score US large-cap momentum by trailing returns, drawdown, and streak persistence.

4|Updated May 5, 2026
One-click install
npx skills add https://github.com/mthli/skills --skill momentum-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: momentum-scan
Source: https://github.com/mthli/skills/tree/main/momentum-scan
Command: npx skills add https://github.com/mthli/skills --skill momentum-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, pandas, numpy, and includes scripts (resource) components.

What problem does it solve?

It helps you discover which large-cap US stocks are exhibiting smooth, persistent uptrends—so you can focus research on leaders that keep showing up rather than one-off rallies.

Core Features & Use Cases

  • Momentum persistence tracking: Scores stocks on trailing return versus max drawdown, logs one snapshot per US market day, and computes streaks, rank changes, dropouts, and new entrants.
  • Entry-timing overlays: Adds a pullback “buyability right now” signal (MA20 proximity + RSI(14) classifier) and an ATR-based Stop% to support risk-aware investigation.
  • Vol-collapse acquisition/lock-in filter: Excludes names whose first/second-half volatility collapses in a way consistent with deal/lock-in patterns, reducing misleading momentum signals.

Quick Start

Run momentum-scan with the default 3-month window to see the current top persistent momentum leaders plus their pullback Sig and ATR Stop% risk reference.

Frequently Asked Questions about momentum-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I screen for durable momentum stocks with low drawdown?

To screen for durable momentum stocks, this tool scores trailing returns against max drawdown and tracks streak persistence across US market days. It identifies smooth, persistent uptrends in large-cap equities rather than one-off rallies.

How does momentum persistence tracking work for daily stock discovery?

Momentum persistence tracking works by logging one snapshot per US market day, scoring trailing return versus max drawdown, and computing streaks, rank changes, dropouts, and new entrants. This helps you monitor which leaders keep showing up over time.

Can I filter out misleading momentum signals caused by volatility collapse?

Yes, you can filter misleading momentum signals by applying the vol-collapse acquisition/lock-in filter. It excludes stocks whose first or second-half volatility collapses in patterns consistent with deal or lock-in activity.

How do I refine momentum stock entries using pullback indicators and ATR stops?

You refine momentum stock entries by applying a pullback signal using MA20 proximity and an RSI(14) classifier, alongside an ATR-based Stop% annotation. This supports risk-aware investigation for timing your entry into durable leaders.

Does this momentum screener work with yfinance and Python for US large-cap equities?

Yes, this momentum screener works with yfinance and Python 3.10+ to fetch a cached universe and download OHLCV bars for US large-cap equities. It scores and persists results to state/history.csv for daily or scheduled discovery.

What are the limitations of using a 3-month window for momentum scanning?

A 3-month window limits momentum scanning to short-term trailing return analysis. You can adjust the window via CLI parameters, but shorter periods may increase sensitivity to market noise and reduce the reliability of streak persistence tracking.