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.
pinned to #4ff3f81updated 2 weeks ago
Ask your AI client: “install skills/breakout-trade-planner”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/breakout-trade-plannermetahub onboarded this repo on the author's behalf.
If you own github.com/tradermonty/claude-trading-skills on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
2,337
Last commit
2 weeks ago
Latest release
published
About this skill
Pulled from SKILL.md at publish time.
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.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.4ff3f81· 2 weeks ago
Documentation
41Description quality
46 words · 369 chars — "Generate Minervini-style breakout trade plans from VCP screener output with wors…"
README is present and substantial
43,541 chars · 15 sections · 4 code blocks
Tags / topics declaredwarn
No manifest tags and no GitHub repo topics
Add tags to the manifest (or GitHub topics on the repo) so the registry's search and category filters surface this artifact.
README has usage / example sections
found: Getting Started
Homepage / docs URL declared
https://tradermonty.github.io/claude-trading-skills/
Release history
1- releasecurrent4ff3f81warn2 weeks ago
Contents
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
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
Resources
references/minervini_entry_rules.md— Entry methodology and rules
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/breakout-trade-planner