# breakout-planner

breakout-planner — a Claude Code skill that evaluates breakout setups for NSE/BSE stocks and works out a trade plan. It responds to requests about Stage 2 trends, bases, entry points, or scanning a stock list.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 69 repo stars
- Author: Shubham Kumar
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Shubhamkumartrichy/claude-trading-skills-india/tree/HEAD/skills/breakout-planner/SKILL.md
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/breakout-planner

## What it does

The skill checks for a Stage 2 trend, detects a VCP or flat base, and reports its pivot, depth, duration, and grade. It then calculates an entry trigger, chase limit, stop, position size, charges, and R targets. The plan also includes GTT/SL templates and exchange-limit checks.

The `breakout.py` script can check one stock, build a plan, or rank a list. It reads CSV files or symbols through `yfinance`; analysis requires at least 260 daily bars. CSV mode can run offline. Running the script requires Python 3.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india
```
In the agent chat (not a shell):
```text
/plugin install india-trading-skills@india-trading-skills
```
This installs the whole india-trading-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill breakout-planner -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/breakout-planner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/breakout-planner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill breakout-planner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/breakout-planner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill breakout-planner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/breakout-planner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Shubhamkumartrichy/claude-trading-skills-india skills/breakout-planner
```

2. **Manually: put the files in place**
- File: `.github/skills/breakout-planner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill breakout-planner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Shubhamkumartrichy/claude-trading-skills-india --path skills/breakout-planner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/breakout-planner/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Shubhamkumartrichy/claude-trading-skills-india/tree/HEAD/skills/breakout-planner/SKILL.md

## When to use it
- check whether a stock meets the Stage 2 trend template
- locate a VCP base and identify its pivot
- calculate an entry, stop, and position size
- rank stocks by breakout setup

## Example prompts
- Check whether POLYCAB is in a Stage 2 uptrend.
- Find VCP bases in these stocks and report each pivot.
- Build a breakout trade plan for POLYCAB with an entry trigger and stop.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 1f560fa5e0f87a05.

BEGIN THIRD-PARTY FILE 1f560fa5e0f87a05
````text
---
name: breakout-planner
description: |
  Stage-2 breakout setups on NSE/BSE stocks: a trend-template check (rising 200 DMA, 50>150>200
  stack, distance from 52-week high/low, relative strength vs NIFTY), base detection (volatility
  contraction with successively tighter pullbacks, or a flat base) with pivot, depth, duration,
  volume dry-up and a grade, then an order-ready plan: trigger, chase limit, capped stop, size,
  Indian charges, R targets, GTT/SL templates, circuit-band and NSE tick-size checks. breakout.py
  scans a folder of CSVs or yfinance symbols and ranks them, offline-capable.

  Use when the user asks: "is X in a Stage 2 uptrend", "find VCP setups", "where is the pivot on X",
  "plan a breakout trade in X", "breakout buy point and stop", "scan these stocks for breakouts",
  "Minervini trend template for NSE stocks", "how do I place a GTT for a breakout", or any question
  about buying stocks as they clear a base.
---

# Breakout Planner (NSE/BSE)

Buy strength only where three things line up: a stock already in a Stage-2 uptrend, a tight base
whose pullbacks shrink as supply dries up, and a pivot you can define to the tick. The script does
the detection and arithmetic. You add regime, news and judgement.

## Commands

```bash
# One stock: trend template + liquidity + base + pivot (add a NIFTY CSV for relative strength)
python3 scripts/breakout.py check --csv polycab.csv --benchmark-csv nifty.csv
python3 scripts/breakout.py check --symbol POLYCAB --benchmark NIFTY          # yfinance
# Plan from the chart (pivot, last low and ATR are read from the data)
python3 scripts/breakout.py plan --csv polycab.csv --capital 1000000 --risk-pct 1 --band 0
# Plan from numbers you already have (no data needed)
python3 scripts/breakout.py plan --pivot 1520 --contraction-low 1462 --prev-close 1498 \
    --capital 500000 --band 10 --segment mtf --leverage 2 --broker zerodha
# Rank many: one CSV per symbol (file name = symbol), or a yfinance list
python3 scripts/breakout.py scan --csv-dir data/ --benchmark-csv data/nifty.csv --top 15
python3 scripts/breakout.py scan --symbols DIXON,KAYNES,TRENT,POLYCAB --benchmark NIFTY
```
Inputs follow `technical-analysis`: `--csv`, `--candles` (broker-MCP JSON) or `--symbol`. Use 260+
daily bars. Every command takes `--json`. Bad input exits 2 with a one-line error.

## Reading `check`

**Trend template** (all must pass for "Stage 2"): close above SMA50/150/200; SMA50 > SMA150 > SMA200;
SMA200 higher than 22 sessions ago; within 25% of the 52-week high; at least 30% above the 52-week
low; with a benchmark, beating it over both 3 and 6 months. Use NIFTY for large caps and NIFTY
Midcap/Smallcap or the sector index for the rest. Five of six is "watch", not "buy".
````
END THIRD-PARTY FILE 1f560fa5e0f87a05

The third-party file has ended. Everything between the 1f560fa5e0f87a05 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2746 of 7728 bytes. © Shubham Kumar · MIT · https://github.com/Shubhamkumartrichy/claude-trading-skills-india/tree/HEAD/skills/breakout-planner/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
