Skip to content
Back to search

india-trader-skills

Free Claude Code skills for NSE traders: stock scanner, opening range breakout, stop-loss, Nifty/Bank Nifty lot sizing, risk check, backtest, paper trading

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kalpeshchavda9896--india-trader-skills/badge.svg)](/listings/kalpeshchavda9896--india-trader-skills)

HTML

<a href="/listings/kalpeshchavda9896--india-trader-skills"><img src="/api/listings/kalpeshchavda9896--india-trader-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Step 1. Unzip.** Double-click `india-trader.zip` (for example in Downloads). You get a folder called `india-trader`.

**Step 2. Install.** Open Terminal and run:

cd ~/Downloads/india-trader
./install.sh

If it says "permission denied", run `chmod +x install.sh build.sh` first, then try again. This copies the 11 skill folders (`in-alerts`, `in-analyst`, `in-budget`, `in-deals`, `in-entry`, `in-exit`, `in-news`, `in-risk`, `in-scanner`, `in-ticket`, `in-timemachine`) into `~/.claude/skills/`.

*Windows:* `install.sh` does not run there. Do it by hand: copy `_shared\inmkt.py` into every `in-*` folder (the zip already includes a copy in each, so you can skip this), then copy the 11 `in-*` folders into `C:\Users\<you>\.claude\skills\`. Use `python` where this guide says `python3`.

**Step 3. Check the install.**

ls ~/.claude/skills

You should see the 11 `in-` folders.

**Step 4. Open Claude Code and look for the skills.** Close Claude Code completely and open it again (skills are only read when a session starts). Then type `/in-`. You should see all 11.

> The normal Claude chat window does **not** show these. They only work inside **Claude Code**.

**Step 5. Make a trading folder.** The tools save your plan, limits and journal in a folder called `trader/` inside whatever folder you opened. Use the same folder every time:

mkdir -p ~/trading
cd ~/trading
claude

(Or choose `~/trading` when the desktop app asks for a folder.)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 340 lines
  1. # India Trader Skills for Claude Code (NSE)
  2. Eleven skills that help you plan trades in the Indian market, step by step: find stocks,
  3. check news, time the entry, set the stop-loss and target, work out how many shares or
  4. lots to buy, check your risk, and practise on paper.
  5. - Works with NSE stocks, the Nifty 50 index, Bank Nifty, Sensex and Nifty option lots.
  6. - Uses Indian time (09:15 to 15:30 IST) and rupees.
  7. - Free. Plain Python, nothing to pip install.
  8. - **It cannot place an order.** It has no broker connection and asks for no passwords or keys.
  9. You place every real order yourself in Upstox (or any broker).
  10. > **Read this first.** Most people who trade lose money. SEBI studies found that around nine
  11. > in ten individual F&O traders lost money in recent years. These skills do arithmetic and
  12. > keep you disciplined. They do not predict the market and they are not financial advice.
  13. > Practise on paper before you use real money, and only trade money you can afford to lose.
  14. ---
  15. ## Contents
  16. 1. [What you need](#1-what-you-need)
  17. 2. [Setup (one time)](#2-setup-one-time)
  18. 3. [Set your limits (one time)](#3-set-your-limits-one-time)
  19. 4. [How to use it: a trading day, step by step](#4-how-to-use-it-a-trading-day-step-by-step)
  20. 5. [How to scan the market](#5-how-to-scan-the-market)
  21. 6. [The 11 skills at a glance](#6-the-11-skills-at-a-glance)
  22. 7. [Options: how lots and stop-loss work here](#7-options-how-lots-and-stop-loss-work-here)
  23. 8. [Paper trading](#8-paper-trading)
  24. 9. [Troubleshooting](#9-troubleshooting)
  25. 10. [What was tested, and what was not](#10-what-was-tested-and-what-was-not)
  26. 11. [Uninstall and update](#11-uninstall-and-update)
  27. ---
  28. ## 1. What you need
  29. - A Mac or Linux computer (Windows: see the note in step 2).
  30. - **Claude Code**, the coding version of Claude. Use it from the Claude desktop app (the `</>`
  31. button) or from Terminal by typing `claude`.
  32. - **Python 3.8 or newer.** Check with `python3 --version` in Terminal.
  33. - An internet connection when you scan. Prices come from Yahoo Finance's free feed, which is
  34. **delayed** and can have gaps. Always check the live price in your broker app before you act.
  35. ## 2. Setup (one time)
  36. **Step 1. Unzip.** Double-click `india-trader.zip` (for example in Downloads). You get a folder
  37. called `india-trader`.
  38. **Step 2. Install.** Open Terminal and run:
  39. ```bash
  40. cd ~/Downloads/india-trader
  41. ./install.sh
  42. ```
  43. If it says "permission denied", run `chmod +x install.sh build.sh` first, then try again.
  44. This copies the 11 skill folders (`in-alerts`, `in-analyst`, `in-budget`, `in-deals`,
  45. `in-entry`, `in-exit`, `in-news`, `in-risk`, `in-scanner`, `in-ticket`, `in-timemachine`)
  46. into `~/.claude/skills/`.
  47. *Windows:* `install.sh` does not run there. Do it by hand: copy `_shared\inmkt.py` into every `in-*` folder
  48. (the zip already includes a copy in each, so you can skip this), then copy the 11 `in-*` folders into
  49. `C:\Users\<you>\.claude\skills\`. Use `python` where this guide says `python3`.
  50. **Step 3. Check the install.**
  51. ```bash
  52. ls ~/.claude/skills
  53. ```
  54. You should see the 11 `in-` folders.
  55. **Step 4. Open Claude Code and look for the skills.** Close Claude Code completely and open it
  56. again (skills are only read when a session starts). Then type `/in-`. You should see all 11.
  57. > The normal Claude chat window does **not** show these. They only work inside **Claude Code**.
  58. **Step 5. Make a trading folder.** The tools save your plan, limits and journal in a folder
  59. called `trader/` inside whatever folder you opened. Use the same folder every time:
  60. ```bash
  61. mkdir -p ~/trading
  62. cd ~/trading
  63. claude
  64. ```
  65. (Or choose `~/trading` when the desktop app asks for a folder.)
  66. ## 3. Set your limits (one time)
  67. In Claude Code, inside your trading folder, type:
  68. ```
  69. /in-budget config
  70. ```
  71. Claude will ask for your capital and limits and save them in `trader/config.json`. You can also
  72. create the file yourself. Copy `in-budget/config.example.json` to `trader/config.json` and edit it:
  73. | setting | meaning | default |
  74. | --- | --- | --- |
  75. | `capital_inr` | money you trade with | 10000 |
  76. | `cash_buffer_pct` | share of capital that always stays in cash | 10 |
  77. | `max_loss_per_trade_inr` | most one trade may lose if its stop-loss fills | 500 |
  78. | `max_daily_loss_inr` | stop trading for the day after this much loss | 1000 |
  79. | `max_trades_per_day` | trades allowed per day | 2 |
  80. | `min_reward_risk` | smallest acceptable reward divided by risk | 1.5 |
  81. | `no_entries_before` / `no_entries_after` | entry window (IST) | 09:30 / 14:45 |
  82. | `flat_by` | close intraday trades by this time (IST) | 15:15 |
  83. | `brokerage_per_order_inr` | flat brokerage per order, for the charges estimate | 20 |
  84. | `other_charges_pct` | taxes and fees as a percent of turnover (rough) | 0.05 |
  85. | `allow_options` | allow option sizing | true |
  86. | `blocked` | stocks you never want to trade | [] |
  87. | `lot_sizes` | lot size per index. **NSE changes these. Check your broker app.** | Nifty 65, Bank Nifty 30, Sensex 20 |
  88. Tips:
  89. - A per-trade loss limit of 1% to 5% of capital is common. A very large limit (like 20%) means a
  90. few losing trades can wipe out the account. The numbers are your decision.
  91. - With a small account (for example ₹10,000), one lot of a Nifty option can cost more than your
  92. whole loss limit. The tool will then say **0 lots** instead of letting you take the trade.
  93. ## 4. How to use it: a trading day, step by step
  94. You type these in Claude Code (they are skills, so they start with `/`). Each step uses the
  95. result of the one before it. The order is:
  96. **scan → news → entry → exit → timemachine → budget → risk → ticket → (you place the order) → alerts → close**
  97. | Step | When (IST) | Command | What you get |
  98. | --- | --- | --- | --- |
  99. | 1. Find candidates | after 15:30 the day before, or before 09:15 | `/in-scanner daily --symbols RELIANCE,TCS,INFY` | a list of charts with a setup |
  100. | 2. Check news | before the open | `/in-news check RELIANCE TCS` | headlines, flagged (results, SEBI, orders, etc.) |
  101. | 3. Wait for the entry | after 09:30 | `/in-entry check RELIANCE --write` | the exact candle that confirms the breakout |
  102. | 4. Plan the exit | before you enter | `/in-exit plan --write` | stop-loss, target, reward:risk |
  103. | 5. Test the plan | before you enter | `/in-timemachine run` | how often the target or stop came first in the past |
  104. | 6. Size it | before you enter | `/in-budget cash --write` | exact number of shares |
  105. | 7. Check risk | before you enter | `/in-risk` | PASS, WARN or BLOCK |
  106. | 8. Make the ticket | if no BLOCK | `/in-ticket show` | a ticket you copy into Upstox by hand |
  107. | 9. Place the order | you do this | (in the Upstox app) | buy, then **place the stop-loss order immediately** |
  108. | 10. Set alerts | after buying | `/in-alerts from-plan` then `/in-alerts watch` | bell when stop or target is hit |
  109. | 11. Record the result | after selling | `/in-ticket close --id 1 --exit 1503.5` | your result after charges |
  110. You can also just tell Claude what you want in plain words, for example "scan Nifty 50 for setups"
  111. or "how many shares of RELIANCE can I buy with entry 1480 and stop 1465". Claude picks the skill.
  112. ### A worked example
  113. ```
  114. /in-entry check RELIANCE --write
  115. ```
  116. Suppose it says: *TRIGGER: 5m bar closed above ₹1,478 at 09:40 IST, price ₹1,480.*
  117. ```
  118. /in-exit plan --stop price:1465 --target 2R --write
  119. ```
  120. → entry 1480, stop 1465, target 1510, reward:risk 2.00.
  121. ```
  122. /in-budget cash --write
  123. ```
  124. → it shows each limit (max loss, cash after buffer, position cap) and the shares allowed.
  125. ```
  126. /in-risk
  127. ```
  128. → if it prints `BLOCK`, **do not take the trade**. Read why. If there is no block, read the warnings.
  129. ```
  130. /in-ticket show
  131. ```
  132. → a plain ticket: instrument, BUY, quantity, product (MIS/CNC), limit price, stop-loss trigger and target.
  133. You type those into Upstox yourself.
  134. ## 5. How to scan the market
  135. The scanner reads free Yahoo charts for NSE stocks (symbols like `RELIANCE.NS`). It reports charts
  136. that match a rule. **A match is not a recommendation to buy.**
  137. ### 5.1 Build your stock list (once, and sometimes refresh)
  138. ```
  139. /in-scanner nifty50 # the Nifty 50 stocks
  140. /in-scanner universe # every NSE stock in the EQ series (2,000+)
  141. ```
  142. Both save `trader/universe.txt`. If NSE blocks the download, open the NSE website, save the CSV file
  143. in your browser, and run `/in-scanner universe --file path/to/EQUITY_L.csv` (or `nifty50 --file ...`).
  144. ### 5.2 Scan the daily charts (end of day or before the open)
  145. ```
  146. /in-scanner daily --symbols RELIANCE,TCS,INFY,HDFCBANK # stocks you name
  147. /in-scanner daily --universe --limit 100 # first 100 in your list
  148. /in-scanner daily --universe --min-price 100 --min-volume 500000
  149. ```
  150. It looks for:
  151. | Setup | Meaning |
  152. | --- | --- |
  153. | 20-day high breakout | today's close is above the highest high of the last 20 days |
  154. | reclaimed the 20-day average | price moved back above its 20-day average |
  155. | oversold (RSI under 30) / oversold bounce | fell hard, and today closed up |
  156. | bull flag | a strong rise (10%+) followed by a tight pause above the 20-day average |
  157. ### 5.3 Scan the opening range (after 09:30 IST)
  158. ```
  159. /in-scanner orb --symbols RELIANCE,TCS,SBIN
  160. ```
  161. The *opening range* is the high and low of the first 15 minutes (09:15 to 09:30). A stock shows up
  162. when a finished 5-minute candle **closes above** that high.
  163. ### 5.4 Useful options
  164. | option | what it does |
  165. | --- | --- |
  166. | `--symbols A,B,C` | scan only these NSE symbols |
  167. | `--universe` and `--limit N` | scan from `trader/universe.txt`, first N stocks |
  168. | `--watchlist watchlist.json` | scan the hits from an earlier scan |
  169. | `--min-price 50` | skip stocks below this price (default 50) |
  170. | `--min-volume 200000` | skip thinly traded stocks (default 200,000 shares a day) |
  171. | `--or-minutes 15` | length of the opening range |
  172. | `--now "2026-11-23 10:15"` | pretend it is this time (IST), to replay a day |
  173. | `--offline FILE_OR_FOLDER` | use saved Yahoo files instead of the internet |
  174. | `--no-write`, `--json`, `--show N` | don't save the result, print JSON, show N lines |
  175. ### 5.5 What to do with the results
  176. 1. The scan saves `trader/watchlist.json`.
  177. 2. Run `/in-news --watchlist watchlist.json` and read the flagged headlines.
  178. 3. Run `/in-entry check SYMBOL` on the ones you like.
  179. 4. Then continue with exit, time machine, budget and risk (see section 4).
  180. How long it takes: the scanner waits a little between requests to be polite to the free service.
  181. Roughly 100 stocks take a couple of minutes, and the whole market takes 15 minutes or more.
  182. Start with Nifty 50.
  183. For options: only stocks in NSE's F&O list have options. The scanner does not check this, so look
  184. up the lot size and premium in your broker app.
  185. ## 6. The 11 skills at a glance
  186. | Skill | What it does | Example |
  187. | --- | --- | --- |
  188. | `/in-scanner` | finds charts with setups | `/in-scanner daily --symbols TCS,INFY` |
  189. | `/in-news` | recent headlines, flagged by what moves a price | `/in-news check RELIANCE --hours 24` |
  190. | `/in-entry` | finds the one *closed* candle that confirms a breakout; never buys | `/in-entry check SBIN --write` |
  191. | `/in-exit` | sets stop-loss and target before you enter | `/in-exit plan --stop or-low --target 2R --write` |
  192. | `/in-budget` | exact shares or option lots from your max loss, plus a charges estimate | `/in-budget cash --write` |
  193. | `/in-risk` | checks the trade against your limits: PASS, WARN, BLOCK | `/in-risk` |
  194. | `/in-ticket` | a plain ticket for you to place by hand, and a paper journal | `/in-ticket show` |
  195. | `/in-timemachine` | replays your plan: 10,000 simulated sessions and past breakout days | `/in-timemachine run` |
  196. | `/in-alerts` | price, stop and target alerts; market clock | `/in-alerts clock` |
  197. | `/in-analyst` | quarterly results you paste in → what changed | `/in-analyst` (see below) |
  198. | `/in-deals` | NSE bulk and block deals: who is buying or selling | `/in-deals summary --file trader/bulk.csv` |
  199. Stops for `/in-exit`: `or-mid` (opening-range midpoint), `or-low` (opening-range low),
  200. `price:1465`, `pct:1` (1% below entry), `atr:1.5` (1.5 times the average daily-range measure).
  201. Targets: `2R` (twice your risk), `1.5R`, or `price:1510`.
  202. **`/in-analyst`**: this one does not fetch results. Get the numbers from the company's results filing
  203. (NSE or BSE announcements, or your broker app). Then:
  204. ```
  205. python3 ~/.claude/skills/in-analyst/facts.py template > results.json
  206. ```
  207. Fill in the quarters (oldest first, at least 5), and ask Claude to run `/in-analyst` on `results.json`. It shows growth,
  208. margins and what changed.
  209. **`/in-deals`**: run `fetch` to download today's bulk and block deal files. If NSE blocks it, save the CSV from the NSE
  210. website (Market Data → Large Deals) and pass it with `--file`.
  211. ## 7. Options: how lots and stop-loss work here
  212. You can only buy whole **lots** (for example, 65 units of Nifty). Cost of one lot = premium × lot size.
  213. ```
  214. /in-budget option --underlying NIFTY --premium 100 --stop-premium 70 --target-premium 160 \
  215. --contract "NIFTY 25900 CE" --expiry 2026-12-02 --write
  216. ```
  217. - **Lots** = the smaller of (max loss ÷ loss per lot) and (cash after buffer ÷ cost per lot).
  218. - If one lot already breaks a limit, the answer is **0 lots**. Don't raise the limit to make it fit.
  219. Use a cash-segment ETF, or paper trade.
  220. - No stop-premium yet? Give an estimate: `--delta 0.5 --underlying-stop-pts 60` (rough guess: delta changes).
  221. - Remember: an option can lose its whole premium, time decay costs you every day, and a stop-loss can fill
  222. at a worse price if the market gaps.
  223. - `/in-risk` warns when expiry is close (default: under 2 days) and blocks quantities that are not whole lots.
  224. ## 8. Paper trading
  225. Paper trading means practising with pretend money. Do this for several weeks before real money.
  226. ```
  227. /in-ticket log # record the planned trade as a paper trade
  228. /in-ticket close --id 1 --exit 1503.5 # close it at a price (shows result after charges)
  229. /in-ticket summary # wins, losses, total
  230. ```
  231. The journal is saved in `trader/journal.json`, and `/in-risk` reads it to enforce your daily limits.
  232. ## 9. Troubleshooting
  233. | Problem | What to do |
  234. | --- | --- |
  235. | `/in-` shows nothing | Use **Claude Code**, not the normal chat. Close and reopen it. Check `ls ~/.claude/skills`. |
  236. | "could not fetch ... HTTP 403/404" | NSE or Yahoo blocked or changed the link. Save the file from the website and use `--file` or `--offline`. |
  237. | "no data" / "market closed" | NSE is open Mon–Fri 09:15–15:30 IST, except holidays (not checked by these tools). |
  238. | Prices look old | Yahoo's free data is delayed. Check your broker app. |
  239. | `/in-risk` says `stale` | The order is from another day. Run `/in-budget ... --write` again today. |
  240. | `0 shares` or `0 lots` | One unit already breaks a limit. See your `trader/config.json`. |
  241. | An index symbol is not found | Use `NIFTY`, `BANKNIFTY` or `SENSEX`. Other indexes (FINNIFTY, MIDCPNIFTY) are best effort. |
  242. | Python not found | Install Python 3 and use `python3` (Windows: `python`). |
  243. ## 10. What was tested, and what was not
  244. - 43 automated tests pass on made-up (synthetic) data: `python3 -W ignore tests/test_all.py`.
  245. - **Not tested on live data.** The NSE download links and news feeds were written from memory and may be
  246. blocked or changed; every tool has a `--file` or `--offline` fallback.
  247. - Lot sizes, brokerage and tax rates change. Check them in your broker app and edit `trader/config.json`.
  248. - NSE holidays are not checked.
  249. - The Time Machine tests the past. The past is not a promise.
  250. ## 11. Uninstall and update
  251. **Uninstall:**
  252. ```bash
  253. cd ~/.claude/skills
  254. rm -rf in-alerts in-analyst in-budget in-deals in-entry in-exit in-news in-risk in-scanner in-ticket in-timemachine
  255. ```
  256. **Update:** unzip the new version and run `./install.sh` again. Your `trader/` folders and settings are kept.
  257. ---
  258. *Inspired by the structure of the open-source US pack
  259. [day-trader-skill](https://github.com/Jakeschincariol/day-trader-skill) (MIT). The code in this pack was
  260. written fresh for the Indian market.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.