Agent skill · business finance · tradermonty
vcp-screener
Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP) and detect historical VCPs in a single ticker's price path. Identifies Stage 2 uptrend stocks forming tight bases with contracting volatility near breakout pivot points; in historical single-ticker mode walks a multi-year history and emits every VCP that formed with forward-outcome stats (breakout / stop-hit / timeout). Use when user requests VCP screening, Minervini-style setups, tight base patterns, volatility contraction breakout candidates, Stage 2 momentum stock scanning, or historical VCP pattern study on a specific ticker (e.g. FIX, TSLA).
Why this skill is useful
Adds a specialized screening tool for identifying stocks based on Mark Minervini's VCP, which includes unique historical analysis and forward-outcome statistics not commonly available.
What it needs
Requires python3 installed locally. Requires fmp account access. About 4k tokens when loaded. Last updated 2026-08-06. 2,581 stars on the source repository.
What this skill does
VCP Screener - Minervini Volatility Contraction Pattern Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP), identifying Stage 2 uptrend stocks with contracting volatility near breakout pivot points. When to Use User asks for VCP screening or Minervini-style setups User wants to find tight base / volatility contraction patterns User requests Stage 2 momentum stock scanning User asks for breakout candidates with defined risk User asks "find every historical VCP in <TICKER>" or wants to study one ticker's past VCP setups with forward outcomes (--history --ticker SYM) Prerequisites FMP API key (set FMPAPIKEY environment variable or pass --api-key) Free tier (250 calls/day) is sufficient for default screening (top 100 candidates) Paid tier recommended for full S&P 500 screening (--full-sp500) Workflow Step 1: Prepare and Execute Screening Run the VCP screener script: Strict Mode (Minervini pure setup) Only return stocks with validvcp=True AND executionstate in (Pre-breakout, Breakout): Historical single-ticker mode Walk one ticker's multi-year history, detect every VCP that ever formed, and attach forward-outcome stats (breakout / stop-hit / timeout, days-to-outcome, max gain, max loss) per detection. Useful for pattern study and backtesting context — not a real-time screener. Outputs (timestamped): vcphistory<SYM><YYYY-MM-DDHHMMSS>.json — timeline of detections with full analyzer payload + forwardoutcome per detection + summary stats. vcphistory<SYM><YYYY-MM-DDHHMMSS>.md — human-readable timeline. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills tradermonty/vcp-screener