Skip to main content
skill CX Codex

indian-tax-for-traders — Claude Code skill: taxes and setup

The indian-tax-for-traders Claude Code skill explains Indian tax treatment of stock-market income for resident individuals. It helps classify trades, estimate tax, and choose an ITR form.

MIT ★ 69 updated 2026-11-13

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india
/plugin install india-trading-skills@india-trading-skills
Open on GitHub

What indian-tax-for-traders does

The skill covers tax on Indian residents’ market income, distinguishing short- and long-term capital gains, intraday trading, and F&O. It explains loss set-off and carry-forward, F&O turnover and audit conditions, dividends, buybacks, and ITR selection. It also covers rate changes from 23 July 2024 and the new section numbers in effect from 1 April 2026.

The package includes a tax estimator and a FIFO script for tradebooks. The estimate, tradebook, turnover, and harvest commands accept CSV files; the skill describes the columns for tradebook and holdings data. Run the scripts with python3.

It activates for questions about tax on trading profits, STCG versus LTCG, F&O loss set-off, ITR choice, audit requirements, or an uploaded broker tax report. Carry-forward of losses requires filing by the original due date.

What it helps with

  • classify income from equity and F&O trades
  • estimate tax from income and trading losses
  • choose an ITR form for trading income
  • calculate F&O turnover and check audit conditions
  • derive FIFO gains from a tradebook

Example prompts for the agent

  • Estimate my tax on equity and F&O profits for tax year 2026-27.
  • Can my F&O loss offset income from intraday trades?
  • Analyze this tradebook and separate STCG from LTCG.

How to install indian-tax-for-traders

1Plugin marketplace

/plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india
/plugin install india-trading-skills@india-trading-skills

This installs the whole india-trading-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Shubhamkumartrichy/claude-trading-skills-india --skill indian-tax-for-traders -a claude-code

3Manually: put the files in place

~/.claude/skills/indian-tax-for-traders/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/indian-tax-for-traders/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about indian-tax-for-traders

How do I install indian-tax-for-traders in Claude Code?

Run /plugin marketplace add Shubhamkumartrichy/claude-trading-skills-india, then run /plugin install india-trading-skills@india-trading-skills.

What does indian-tax-for-traders do?

It explains Indian tax rules for residents earning income from equity, intraday trading, and F&O. It also includes a tax estimator and a FIFO tradebook script.

What does indian-tax-for-traders need to run?

The scripts use python3. For trade calculations, the script accepts CSV files; tradebook data uses the columns date, symbol, side, qty, price.

Source text

SKILL.md · MIT
---
name: indian-tax-for-traders
description: |
  Income-tax treatment of Indian stock-market income for resident individuals: STCG (20%) and LTCG
  (12.5% above ₹1.25 lakh) on listed equity and equity funds, grandfathering for pre-2018 shares,
  intraday as speculative business income, F&O as non-speculative business income, set-off and
  carry-forward rules, F&O turnover and tax audit, ITR form choice, dividends, buybacks, the new
  Income-tax Act 2025 section numbers, and tax-loss / LTCG-exemption harvesting. Includes an estimator
  and tradebook FIFO script.

  Use when the user asks "how much tax on my profit", "STCG or LTCG", "can F&O loss be set off",
  "which ITR", "F&O turnover / audit", "tax-loss harvesting", "should I wait a few days to sell",
  "tax on dividends or buyback", or uploads a broker tax P&L/tradebook.
---

# Indian Tax for Traders and Investors

Covers resident individuals for **FY 2025-26** and **tax year 2026-27**, which use the same slabs and
rates. From 1 Apr 2026 the **Income-tax Act, 2025** replaced the 1961 Act. It renamed "previous year"
as "tax year" and renumbered sections. Commonly cited mappings are 111A → 196, 112A → 198, and loss
carry-forward 72/73/74 → 112/113/111. Confirm the numbering against the official CBDT mapping before
quoting it in a filing.

**Always end with:** "Estimate only, not tax advice. Confirm with a Chartered Accountant before filing."

## Calculator

```bash
python3 scripts/tax.py estimate --salary 1800000 --stcg 120000 --ltcg 300000 --fno -80000
python3 scripts/tax.py estimate --other-income 600000 --intraday -40000 --fno 250000 --regime old
python3 scripts/tax.py estimate ... --bf-business-loss 100000 --bf-stcl 20000      # brought-forward losses
python3 scripts/tax.py tradebook tradebook.csv --fy 2026-27 --details              # FIFO STCG/LTCG/intraday
python3 scripts/tax.py turnover --csv fno_trades.csv                                # Σ|P&L| and audit hint
python3 scripts/tax.py harvest holdings.csv --as-of 2027-03-10 --realized-ltcg 40000
```

Tradebook CSV columns: `date, symbol, side (BUY/SELL), qty, price`, plus optional `charges` (exclude
STT) and `fmv_2018` (31-Jan-2018 FMV for grandfathered lots). Zerodha Console and Groww tradebook
exports work after renaming headers if needed. Holdings CSV columns: `symbol, buy_date, qty, buy_price, ltp`.

## How market income is classified

| Activity | Head / type | Rate | Losses |
|---|---|---|---|
| Delivery equity or equity MF held **≤ 12 months** | STCG (STT paid) | **20%** | Offset STCG or LTCG. Carry forward 8 years |
| Delivery held **> 12 months** | LTCG | **12.5% above ₹1.25 lakh** per year | Offset only LTCG. Carry forward 8 years |
| Intraday equity (same-day square-off) | **Speculative** business income | Slab | Offset only speculative income. Carry forward **4 years** |
| F&O (futures, options, equity or index) | **Non-speculative** business income | Slab | Offset any head **except salary** in the same year. Carry forward 8 years (against business income) |
| Dividends | Other sources | Slab | — (TDS 10% above ₹10,000 per company per year) |
| Buyback proceeds (from 1 Apr 2026) | Capital gains | As STCG/LTCG | Promoters face additional tax |

Rates for STCG and LTCG changed on **23 Jul 2024** (from 15%/10% with a ₹1 lakh exemption). Older sales
use old rates.

Holding period is **more than 12 months**. Bought 15 Jan 2025 and sold 15 Jan 2026 is still short-term;
sold 16 Jan 2026 is long-term.

**Grandfathering:** for shares bought before 1 Feb 2018, cost = higher of actual cost and the lower of
(FMV on 31 Jan 2018, sale price).

## Slabs (new regime, default)

| Income | Rate |
|---|---|
| Up to ₹4 lakh | 0 |
| ₹4–8 lakh | 5% |
| ₹8–12 lakh | 10% |
| ₹12–16 lakh | 15% |
| ₹16–20 lakh | 20% |
| ₹20–24 lakh | 25% |
| Above ₹24 lakh | 30% |

- Salaried standard deduction is ₹75,000 (₹50,000 in the old regime).
- **Section 87A rebate:** zero tax up to ₹12 lakh of total income in the new regime (rebate up to
  ₹60,000) with marginal relief just above. The rebate does **not** apply to tax on STCG/LTCG at special
  rates, which is a common surprise.
- Residents can use any unused basic exemption (₹4 lakh new, ₹2.5 lakh old) against STCG and LTCG.
- Surcharge applies at 10%/15%/25% above ₹50 lakh, ₹1 crore and ₹2 crore (new regime max 25%). It is
  capped at 15% on equity capital gains. Cess is 4% on top.

## Set-off order (what the script applies)

1. Intraday loss stays isolated and carries forward 4 years.
2. F&O loss → intraday profit → other non-salary income → STCG → LTCG. The remainder carries forward
   8 years against business income.
3. Short-term capital loss → LTCG. Long-term capital loss carries forward (LTCG only).
4. Brought-forward losses are then used under their own restrictions.
5. **Carry-forward requires filing the return by the original due date.** A late return loses the
   right to carry forward losses (except house property).

## F&O and intraday compliance

- **ITR-3** is needed for any F&O or intraday income. ITR-2 covers capital gains without business
  income. ITR-1 now allows LTCG up to ₹1.25 lakh only.
- **Turnover** (ICAI guidance) = sum of absolute profits and losses per trade, not contract value or
  premium. Use `tax.py turnover`.
- **Tax audit** is required if turnover exceeds ₹10 crore (when cash transactions are ≤5%, which is
  always true for exchange trading). An audit can also apply below that if you opted out of presumptive
  taxation (44AD) within the last 5 years and declare a profit under 6% (or a loss) with total income
  above the basic exemption. Refer to a CA.
- Deductible business expenses for F&O include brokerage, STT, exchange fees, GST, internet/phone (a
  share of it), data subscriptions, advisory fees, and depreciation on a trading computer. Keep proofs.
- **Advance tax** is due on business income and capital gains (15 Jun, 15 Sep, 15 Dec, 15 Mar). Capital
  gains are due only after they arise. Shortfalls attract interest.

## Harvesting and timing ideas (`tax.py harvest`)

- **LTCG exemption harvesting:** each year, realise up to ₹1.25 lakh of long-term gains tax-free and
  rebuy to reset cost. Cost is about 0.25% round trip.
- **Loss harvesting:** book unrealised losses to offset realised STCG. Short-term losses offset either
  kind; long-term losses offset only LTCG.
- **Wait for long-term:** if a profitable lot turns long-term within weeks, waiting cuts the rate from
  20% to 12.5%. Weigh that against price risk.
- India has no statutory wash-sale rule. Sell-and-rebuy done purely for tax can still be challenged
  under GAAR or as a sham transaction, so keep trades genuine and documented.

## Output

```
Tax estimate (new regime, FY 2026-27)
  Normal income ₹.. | STCG ₹.. @20% | LTCG ₹.. (₹.. taxable @12.5%)
  Tax ₹.. + cess ₹.. = ₹..
  Set-off steps: …   Carry forward: …
  Form: ITR-3 / ITR-2; file by the due date to keep losses
Estimate only, not tax advice. Confirm with a Chartered Accountant before filing.
```

© Shubham Kumar · MIT · Shubhamkumartrichy/claude-trading-skills-india

Similar skills

All skills for Finance and business →
indian-stocks-mcp vishalmdi indian-stocks-mcp connects Claude Code to 6+ years of minute-level Indian market data and runs strategy backtests with local regulatory costs. CX Codex +1 550installs Tapetide - Indian Stock Market MCP Tapetide-hq Tapetide - Indian Stock Market MCP connects AI assistants to NSE and BSE quotes, quarterly reports, and a stock screener. Useful for tracking more than 8,200 Indian equities and options directly in chat. CX Codex +1 ★ 151repo stars AION Indian Market Intelligence for Macro Event & Sector Impact Analysis AION-Analytics-India AION Indian Market Intelligence for Macro Event & Sector Impact Analysis is an MCP server for Claude Code that turns an Indian financial headline into a signed per-sector impact vector. CX Codex +1 ★ 24repo stars QorpIQ: Indian company and director data (MCA) QorpIQ QorpIQ: Indian company and director data (MCA) is an MCP server for Claude Code that pulls Indian corporate registry records from MCA by CIN, LLPIN, or DIN for verifying entities in AI sessions. CX Codex +1 kanchi-dividend-us-tax-accounting tradermonty kanchi-dividend-us-tax-accounting classifies US dividend streams for stocks, REITs, and BDCs while evaluating holding periods and placement across taxable and retirement accounts. CX Codex +1 3,700installs tax-prep official anthropics tax-prep prepares quarterly estimates and 1099-NEC lists for your accountant. Closes the books first, then calculates — so the number sits on reconciled data. CX Codex +1 2,000installs

From the same set36

The whole set →
market-pulse The market-pulse Claude Code skill builds Indian market briefs for pre-market, intraday and closing checks. It responds to requests about GIFT Nifty, FII/DII flows, market breadth or the day’s wrap-up. CX Codex +1 ★ 69repo stars position-sizing The position-sizing Claude Code skill calculates position size and trade risk for Indian equities and F&O. It activates for questions about share or lot counts, risk per trade, and capital allocation. CX Codex +1 ★ 69repo stars technical-analysis The technical-analysis Claude Code skill reads charts for NSE/BSE stocks and indices. The agent invokes it to assess trends, price levels, indicators, and volume. CX Codex +1 ★ 69repo stars broker-integration The broker-integration Claude Code skill connects Indian brokers through MCP servers and handles their market data and orders. It activates for broker setup, quote requests, and trade preparation. CX Codex +1 ★ 69repo stars fno-options-analysis The fno-options-analysis Claude Code skill analyses Indian futures and options, including option chains, volatility, Greeks and expiries. It activates for questions about NIFTY, PCR, India VIX, margins or expiry rules. CX Codex +1 ★ 69repo stars 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. CX Codex +1 ★ 69repo stars stock-screener The stock-screener Claude Code skill filters and ranks Indian stocks using fundamentals from a CSV. It runs on requests to screen a company list, find stocks by financial criteria, or explain a failed rule. CX Codex +1 ★ 69repo stars results-season The results-season Claude Code skill analyzes how NSE and BSE stocks move after quarterly results. It scores price gaps, trading volume, and follow-through. CX Codex +1 ★ 69repo stars

Project sponsors

Companies that keep this analytics open