vcp-screener

Screen S&P 500 stocks for Minervini's Volatility Contraction Pattern.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/MileniumTick/skills --skill vcp-screener-mileniumtick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vcp-screener
Source: https://github.com/MileniumTick/skills/tree/main/skills/vcp-screener
Command: npx skills add https://github.com/MileniumTick/skills --skill vcp-screener-mileniumtick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP) to identify Stage 2 uptrends forming tight bases and imminent breakouts, reducing manual screening time and enabling data-driven decisions.

Core Features & Use Cases

  • 3-phase VCP screening pipeline (pre-filter, trend template, VCP scoring) that ranks candidates by quality and entry-readiness.
  • Supports custom universes or default S&P 500, with detailed reports and market-context data.
  • Provides actionable insights: entry-ready status, pivot proximity, risk and reward metrics, and RS rankings for portfolio prioritization.

Quick Start

Run the vcp-screener with the default S&P 500 universe to generate top VCP candidates and accompanying JSON/Markdown reports.

Frequently Asked Questions about vcp-screener

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

FAQPage Schema
How do I screen stocks for Minervini's Volatility Contraction Pattern?

Screen stocks for the Volatility Contraction Pattern by running a 3-phase pipeline that applies pre-filters, a trend template, and VCP scoring to identify Stage 2 uptrends forming tight bases. It outputs ranked candidates and detailed JSON/Markdown reports.

What is a VCP stock screener and how does it identify breakouts?

A VCP stock screener identifies breakouts by analyzing volume patterns and price volatility contractions within a defined universe. It applies a 5-component scoring model and state-cap rules to rank candidates by entry-readiness and pivot proximity.

Can I screen a custom stock universe for VCP setups instead of the S&P 500?

You can screen a custom stock universe for VCP setups by providing your own ticker list, or default to the S&P 500. The screener applies its trend template and volatility contraction pattern scoring to generate actionable entry reports.

How does the trend template filter work in VCP screening?

The trend template filter works in VCP screening by evaluating price and volume criteria to confirm a Stage 2 uptrend before applying the 5-component VCP scoring model. This ensures only stocks in valid technical structures are scored for breakouts.

What market data do I need to run a VCP screener with Python?

Running a VCP screener requires fetching historical market data using the requests dependency. The pipeline includes fallback data validation and error handling to manage missing data points during the trend template and volatility pattern analysis.

What limitations exist when screening S&P 500 stocks for VCP patterns?

Screening S&P 500 stocks for VCP patterns is limited by the availability of accurate historical price and volume data. Built-in fallback data validation handles missing inputs, but poor data quality can impact the 5-component scoring model and entry-ready reports.