SkillsAdd

mphinance/alpha-skills

breakout-trade-planner

Generate Minervini-style breakout trade plans from VCP screener output with worst-case risk calculation, portfolio heat management, and Alpaca-compatible order templates (stop-limit bracket for pre-placement, limit bracket for post-confirmation).

First seen May 9, 2026

Installation

$ npx skills add mphinance/alpha-skills --skill breakout-trade-planner
View on skills.sh ↗ GitHub repository ↗

Summary

  • Generate Minervini-style breakout trade plans from VCP screener output with worst-case risk calculation, portfolio heat management, and Alpaca-compatible order templates (stop-limit bracket for pre-placement, limit bracket for post-confirmation).
  • Use when user has VCP screener results and wants actionable trade plans with entry/stop/target levels and position sizing.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

breakout-trade-planner Linked neighbor
tradermonty/claude-trading-skills

Generate Minervini-style breakout trade plans from VCP screener output with worst-case risk cal…

1.7K installs
breakout_candidate_finder_skill Similar name
wind-information-co-ltd/wind-skills

批量识别突破形态成熟、量价结构健康、催化?

296 installs
vcp_breakout_scan_skill Similar name
wind-information-co-ltd/wind-skills

筛选波动逐级收缩、抛压减弱、结构趋于成熟的突破预备股，并输出?

102 installs
failed_breakout_exit_skill Similar name
wind-information-co-ltd/wind-skills

识别突破失败、冲高回落与关键位失守后的撤退信号，并给出减仓、止损与重新观察的动作顺序。适用于突…

100 installs
breakout_trade_execution_skill Similar name
wind-information-co-ltd/wind-skills

围绕突破交易制定从观察、触发、跟进到失效处理的落地执行方案，?

100 installs

Also in this package

Other skills from mphinance/alpha-skills · top by installs.

npx skills add mphinance/alpha-skills
us-stock-analysis 99 quant-feature-engineer 99 backtest-expert 95 pinescript-to-python-translator 95 portfolio-manager 92 finance-report 91 sprite-animation 91 data-quality-checker 89 economic-calendar-fetcher 89 invoice 89

Browse all from mphinance/alpha-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 21
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,450 B
  • docs SUMMARY.md 399 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 85 installs

SKILL.md

Breakout Trade Planner

Generate trade plans from VCP screener output following Mark Minervini's breakout methodology. Calculate position sizes using worst-case entry prices, enforce portfolio risk limits, and output Alpaca API-compatible order templates.

When to Use

  • User has VCP screener JSON output and wants trade plans
  • User asks for breakout entry/stop/target calculation
  • User wants Alpaca order templates for VCP breakout candidates
  • User needs position sizing with portfolio heat management

Prerequisites

  • VCP screener JSON output with schema_version: "1.0"
  • No API keys required (works with local JSON files)
  • No external skill dependencies (position sizing is built-in)

Workflow

Step 1: Generate Trade Plans

Run the planner with VCP screener output:

python3 skills/breakout-trade-planner/scripts/plan_breakout_trades.py \
  --input reports/vcp_screener_YYYY-MM-DD.json \
  --account-size 100000 \
  --risk-pct 0.5 \
  --output-dir reports/

Step 2: Review Output

Read the generated JSON and Markdown reports. Present:

  1. Actionable Orders — Pre-breakout candidates with order templates
  2. Revalidation — Breakout-state candidates needing live confirmation
  3. Watchlist — Developing VCP candidates to monitor
  4. Rejected/Deferred/Constrained — Candidates filtered by Gate or portfolio limits

Step 3: Explain Trade Plans

For each actionable order, explain:

  • Entry levels (signal vs worst-case) and stop-loss placement
  • R-multiple targets and reward-risk ratio
  • Two execution modes: preplace (stop-limit) vs postconfirm (limit after 5min confirmation)
  • Portfolio risk contribution and cumulative heat

Minervini Gate (Filtering Criteria)

Candidates must pass ALL conditions:

Condition Pre-breakout Breakout
valid_vcp True True
rating_band good/strong/textbook good/strong/textbook
riskpctworst <= 8.0% <= 8.0%
breakout_volume — True
distancefrompivot — <= maxchasepct
current_price — <= worst_entry

CLI Parameters

Parameter Default Description
--account-size (required) Account equity in dollars
--risk-pct 0.5 Base risk % per trade
--max-position-pct 10.0 Max single position %
--max-sector-pct 30.0 Max sector exposure %
--max-portfolio-heat-pct 6.0 Max total open risk %
--target-r-multiple 2.0 Take-profit R-multiple
--stop-buffer-pct 1.0 Stop buffer below contraction low
--max-chase-pct 2.0 Max chase above pivot
--pivot-buffer-pct 0.1 Pivot buffer for buy-stop trigger
--current-exposure-json None Existing portfolio exposure

Output

  • breakouttradeplanYYYY-MM-DDHHMMSS.json — Structured plans with order templates
  • breakouttradeplanYYYY-MM-DDHHMMSS.md — Human-readable report

Resources

  • references/minervinientryrules.md — Entry methodology and rules