Skill

breakout-trade-planner

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

Python

cli-tools

automation

Install

npx claudepluginhub joshuarweaver/cascade-business-ops --plugin tradermonty-claude-trading-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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.

Supporting Assets

references/minervini_entry_rules.mdscripts/order_builder.pyscripts/plan_breakout_trades.pyscripts/risk_calculator.pyscripts/tests/conftest.pyscripts/tests/test_order_builder.pyscripts/tests/test_plan_breakout_trades.pyscripts/tests/test_risk_calculator.py

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

167.4k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

167.4k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

167.4k

Stats

Stars1056

Forks235

Last CommitApr 13, 2026

Actions

View Source View Plugin View on GitHub View README

Breakout Trade Planner

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:

Actionable Orders — Pre-breakout candidates with order templates
Revalidation — Breakout-state candidates needing live confirmation
Watchlist — Developing VCP candidates to monitor
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: pre_place (stop-limit) vs post_confirm (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
risk_pct_worst	<= 8.0%	<= 8.0%
breakout_volume	—	True
distance_from_pivot	—	<= max_chase_pct
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

breakout_trade_plan_YYYY-MM-DD_HHMMSS.json — Structured plans with order templates
breakout_trade_plan_YYYY-MM-DD_HHMMSS.md — Human-readable report

Resources

references/minervini_entry_rules.md — Entry methodology and rules