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). Use when user has VCP screener results and wants actionable trade plans with entry/stop/target levels and position sizing.
Esta skill incluye scripts que tu agente puede ejecutar. Ver qué archivos
Resumen
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:
- 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
- Broker and intraday constraints: these templates are planning artifacts, not broker permission. If the plan could create same-day round trips or use margin, confirm the user's broker-specific intraday/day-trading controls. FINRA replaced the old pattern-day-trader day-count and $25,000 minimum-equity requirements with intraday margin standards effective 2026-06-04, with broker phase-in allowed through 2027-10-20.
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 templatesbreakout_trade_plan_YYYY-MM-DD_HHMMSS.md— Human-readable report
Exchange Calendar and Replay
Install requirements.txt before running the planner. --as-of accepts either YYYY-MM-DD (00:00 America/New_York) or an offset-bearing ISO-8601 timestamp. Plan validity uses the current not-yet-closed XNYS session or the next real session after a close, weekend, or exchange holiday.
Resources
references/minervini_entry_rules.md— Entry methodology and rules
Archivos 12 archivos
- scripts/_market_calendar.pyScript
- scripts/order_builder.pyScript
- scripts/plan_breakout_trades.pyScript
- scripts/risk_calculator.pyScript
- scripts/tests/conftest.pyScript
- scripts/tests/test_market_calendar_contract.pyScript
- scripts/tests/test_order_builder.pyScript
- scripts/tests/test_plan_breakout_trades.pyScript
- scripts/tests/test_risk_calculator.pyScript
- SKILL.mdMarkdown
- references/minervini_entry_rules.mdMarkdown
- requirements.txtArchivo
Instálala a mano
Deska ejecuta esto por ti, para cada agente que elijas. Para ejecutarlo tú en una terminal:
npx skills add tradermonty/claude-trading-skills --skill breakout-trade-plannerMás de tradermonty
- us-stock-analysistradermontyComprehensive US stock analysis including fundamental analysis (financial metrics, business quality, valuation), technical analysis (indicators, chart patterns, support/resistance), stock comparisons, and investment report generation. Use when user requests analysis of US stock tickers (e.g., "analyze AAPL", "compare TSLA vs NVDA", "give me a report on Microsoft"), evaluation of financial metrics, technical chart analysis, or investment recommendations for American stocks.5,300 instalaciones en skills.sh0
- market-news-analysttradermontyThis skill should be used when analyzing recent market-moving news events and their impact on equity markets and commodities. Use this skill when the user requests analysis of major financial news from the past 10 days, wants to understand market reactions to monetary policy decisions (FOMC, ECB, BOJ), needs assessment of geopolitical events' impact on commodities, or requires comprehensive review of earnings announcements from mega-cap stocks. The skill automatically collects news using WebSearch/WebFetch tools and produces impact-ranked analysis reports. All analysis thinking and output are conducted in English.3,900 instalaciones en skills.sh0
- backtest-experttradermontyExpert guidance for systematic backtesting of trading strategies. Use when developing, testing, stress-testing, or validating quantitative trading strategies. Covers "beating ideas to death" methodology, parameter robustness testing, slippage modeling, bias prevention, and interpreting backtest results. Applicable when user asks about backtesting, strategy validation, robustness testing, avoiding overfitting, or systematic trading development.3,800 instalaciones en skills.sh0
- market-environment-analysistradermontyComprehensive market environment analysis and reporting tool. Analyzes global markets including US, European, Asian markets, forex, commodities, and economic indicators. Provides risk-on/risk-off assessment, sector analysis, and technical indicator interpretation. Triggers on keywords like market analysis, market environment, global markets, trading environment, market conditions, investment climate, market sentiment, forex analysis, stock market analysis, 相場環境, 市場分析, マーケット状況, 投資環境.3,700 instalaciones en skills.sh0
- portfolio-managertradermontyComprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and generate rebalancing recommendations. Use when user requests portfolio review, position analysis, risk assessment, performance evaluation, or rebalancing suggestions for their brokerage account.3,600 instalaciones en skills.sh0