Skip to content

ajeeshworkspace/indian-trading-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Indian Trading Skills for Claude

Turn Claude into your Indian market research analyst. 10 specialized skills covering NSE/BSE equities, F&O derivatives, institutional flows, market breadth, live news tracking, and weekly trade planning — all built for Indian markets.

License: MIT Python 3.9+ Claude Skills

What This Is

A collection of Claude Skills that give Claude deep knowledge of Indian equity markets. Each skill is a self-contained module with methodology references, scoring frameworks, and Python scripts — purpose-built for NSE/BSE.

No API keys required for most skills. Uses free data sources (yfinance, niftystocks) and optionally integrates with Groww MCP or Zerodha Kite MCP for live market data and trading.

Adapted from tradermonty/claude-trading-skills (US markets) for Indian markets.

Quick Start

1. Clone the repo

git clone https://github.com/ajeeshworkspace/indian-trading-skills.git
cd indian-trading-skills

2. Install dependencies

pip install -e .

# Or install directly
pip install yfinance pandas scipy pyyaml niftystocks feedparser

3. Add skills to Claude

Claude Code (CLI): Copy the skills/ directory into your project or point Claude to this repo. Claude automatically discovers SKILL.md files.

Claude Desktop / claude.ai: Reference the skill files in your project knowledge or system prompt.

4. Start using

Just talk to Claude naturally:

"Analyze Reliance Industries stock fundamentals"
"Screen Nifty 500 for VCP breakout setups"
"What's the market impact if RBI cuts rates by 50 bps?"
"Build an iron condor on Bank Nifty for this week's expiry"
"How healthy is the broad market right now?"
"Evaluate my backtest — 150 trades, 58% win rate, 1.8 profit factor"
"What are FII/DII flows telling us this month?"
"Give me today's market news briefing"
"Any news about Tata Motors?"

Skills

1. Technical Analyst

Systematic technical analysis of weekly price charts for Indian stocks and indices. Feed it chart images and get structured analysis with probabilistic scenarios.

Trigger Provide chart images for analysis
Output Trend, S/R levels, MA analysis, volume, 2-4 probability-weighted scenarios
Data Chart images (user-provided)

2. NSE VCP Screener

Screens Nifty 50/200/500 for Mark Minervini's Volatility Contraction Pattern — the setup behind many of the biggest stock moves.

Trigger "Screen for VCP setups", "Find breakout candidates"
Output Ranked candidates with composite scores, pivot levels, risk metrics
Data yfinance (free, no API key)

Standalone CLI usage:

# Screen Nifty 50
python3 skills/nse-vcp-screener/scripts/screen_vcp.py --universe nifty50

# Screen Nifty 500 (broader universe)
python3 skills/nse-vcp-screener/scripts/screen_vcp.py --universe nifty500

# Custom tickers
python3 skills/nse-vcp-screener/scripts/screen_vcp.py --custom-tickers RELIANCE,TCS,INFY,HDFC

# Tune parameters
python3 skills/nse-vcp-screener/scripts/screen_vcp.py --universe nifty200 \
  --min-contractions 2 --t1-depth-min 10 --t1-depth-max 40 \
  --trend-min-score 85 --output-dir reports/

Scoring system: 5-component composite (Trend Template 25%, Contraction Quality 25%, Volume Dry-Up 20%, Pivot Proximity 15%, Relative Strength 15%).

3. India Stock Analysis

Deep fundamental + technical analysis of NSE/BSE stocks. Covers business quality, financials, valuation, shareholding patterns, and peer comparison.

Trigger "Analyze TCS", "Compare HDFC Bank vs ICICI Bank"
Output Investment report with bull/bear cases, scorecard, risk matrix
Data Groww MCP (live) or yfinance (free)

India-specific metrics: Promoter holding/pledge analysis, FII/DII ownership trends, sector-specific ratios (NIM/NPA for banks, ANDA pipeline for pharma, utilization for IT).

4. Scenario Analyzer

Builds 18-month probabilistic scenarios from headlines and events. Covers RBI policy, Union Budget, crude oil, elections, monsoons, and global risk events.

Trigger Share a news headline or ask about event impact
Output 3 scenarios (base/bull/bear) with probabilities, sector impact, portfolio actions
Data Built-in reference data (no API needed)

Includes: Historical pattern database (2008-2024), sector sensitivity matrix (10 sectors x 8 event types), and 4 detailed playbooks.

5. FII/DII Flow Tracker

Analyzes Foreign and Domestic Institutional Investor flows and their correlation with Nifty direction. Classifies flow regimes and identifies divergences.

Trigger "What are FII flows this month?", "Is DII absorbing FII selling?"
Output Flow regime assessment, Nifty correlation, sector rotation signals
Data Web search (NSDL, NSE data) + Groww MCP

Includes: 4 historical case studies (COVID 2020, Ukraine 2022, Oct 2024, FY2021 rally), flow interpretation decision matrix, FII derivative position analysis.

6. Options Strategy Advisor

Recommends and prices options strategies for NSE F&O. Full Black-Scholes engine with Greeks, IV solver, and strategy builders.

Trigger "Build a straddle on Nifty", "What's the margin for iron condor?"
Output Strategy details, Greeks, margin requirement, ASCII P/L diagram
Data Groww MCP (live Greeks, OI, margins)

Standalone CLI usage:

# Price a call option
python3 skills/options-strategy-advisor/scripts/black_scholes.py price \
  --spot 24000 --strike 24500 --expiry 7 --vol 0.15 --rate 0.065 --type call

# Calculate Greeks
python3 skills/options-strategy-advisor/scripts/black_scholes.py greeks \
  --spot 24000 --strike 24500 --expiry 7 --vol 0.15

# Solve implied volatility
python3 skills/options-strategy-advisor/scripts/black_scholes.py iv \
  --spot 24000 --strike 24500 --expiry 7 --price 120 --type call

# Build iron condor with P/L diagram
python3 skills/options-strategy-advisor/scripts/black_scholes.py strategy \
  --name iron_condor --spot 24000 --expiry 7 --vol 0.15 \
  --strikes 23500 23800 24200 24500

17 strategies supported: Covered calls, protective puts, bull/bear spreads, straddles, strangles, iron condors, iron butterflies, calendar spreads, diagonal spreads, ratio spreads.

7. Backtest Expert

Validates trading strategy backtests with India-specific cost modeling and overfitting detection. Scores across 5 dimensions and delivers a Deploy/Refine/Abandon verdict.

Trigger "Evaluate my backtest results", "Is this strategy robust?"
Output 0-100 score, red flags, verdict, cost-adjusted metrics
Data User-provided backtest results

Standalone CLI usage:

python3 skills/backtest-expert/scripts/evaluate_backtest.py \
  --trades 150 --win-rate 0.58 --avg-win 2.5 --avg-loss 1.2 \
  --max-drawdown 15 --years 3 --parameters 4 \
  --slippage-modeled --segment delivery --format both

India-specific costs modeled: STT, stamp duty, exchange transaction charges, SEBI turnover fees, GST — for delivery, intraday, and F&O segments.

8. India Market Breadth

Measures internal market health beyond Nifty/Sensex using breadth indicators. Generates a Health Score (0-100) with regime classification.

Trigger "How's the broad market?", "Is market breadth healthy?"
Output Health score, regime (Risk-On/Cautious/Risk-Off), divergence alerts
Data yfinance + Groww MCP

5-component scoring: Advance/Decline (25%), Stocks above 200 DMA (25%), New Highs vs Lows (20%), Sector Participation (15%), Index Divergence (15%).

9. India News Tracker

Fetches, categorizes, and scores Indian market news from MoneyControl, Economic Times, LiveMint, BSE/NSE filings, and SEBI circulars. Auto-detects sentiment, affected sectors, and stock mentions.

Trigger "Market news today", "News about Reliance", "Banking sector update", "Upcoming earnings"
Output Daily briefing, stock-specific digest, sector roundup, earnings calendar, corporate actions
Data RSS feeds + Web search + Groww MCP (stocks in news, volume shockers)

7 modes: Daily Briefing, Stock-Specific News, Sector Roundup, Earnings Tracker, Corporate Actions, Bulk/Block Deals, Regulatory Monitor.

Standalone CLI usage (News Tracker):

# Daily briefing from all sources
python3 skills/india-news-tracker/scripts/news_fetcher.py

# Stock-specific news
python3 skills/india-news-tracker/scripts/news_fetcher.py --stock RELIANCE

# Sector news
python3 skills/india-news-tracker/scripts/news_fetcher.py --sector banking

# Last 7 days, high impact only
python3 skills/india-news-tracker/scripts/news_fetcher.py --days 7 --min-impact 6

# JSON output
python3 skills/india-news-tracker/scripts/news_fetcher.py --format json --output reports/news.json

Auto-feeds other skills: Headlines → Scenario Analyzer, Earnings → Stock Analysis, FII activity → Flow Tracker, Sector signals → Market Breadth.

10. Weekly F&O Trade Planner

Complete weekly F&O trading workflow — from macro thesis to position management. Combines news analysis, sector screening, technical confirmation, OI data, and FII/DII flows to generate a single high-conviction directional trade idea each week, then manages it with structured stop-loss tightening and partial profit booking.

Trigger "Plan my F&O trade for next week", "What should I trade this week?", "Weekly trade idea"
Output Trade Card (instrument, direction, strike, entry, SL, targets), then ongoing position management
Data Groww MCP or Zerodha Kite MCP (live) + Web search (news, FII/DII)

6-phase workflow:

  1. News & Macro Scan — identify the dominant market narrative, rate conviction 1-5
  2. Sector & Instrument ID — screen movers, FII/DII flows, narrow to ONE instrument
  3. Direction & Technical Confirmation — RSI, MACD, SuperTrend, OI analysis (need 4+ signals aligned)
  4. Strategy & Entry Plan — select strategy based on conviction + IV, generate Trade Card with exact levels
  5. Execution — place orders with GTT stop-loss and profit targets
  6. Position Management — daily monitoring, SL tightening ladder, partial profit booking (40-50% at T1, 30% at T2, trail rest)

Built-in risk rules: Max 40% capital per trade, mandatory GTT stop-loss, weekend exit rule for weekly expiry, no averaging down, orphaned GTT cleanup after every exit.

Project Structure

indian-trading-skills/
├── README.md
├── LICENSE
├── pyproject.toml
├── .gitignore
└── skills/
    ├── technical-analyst/
    │   ├── SKILL.md
    │   ├── references/technical_analysis_framework.md
    │   └── assets/analysis_template.md
    ├── nse-vcp-screener/
    │   ├── SKILL.md
    │   ├── references/{vcp_methodology, scoring_system}.md
    │   └── scripts/{screen_vcp, scorer, report_generator}.py
    │       └── calculators/{trend_template, vcp_pattern, volume_pattern,
    │                        pivot_proximity, relative_strength}_calculator.py
    ├── india-stock-analysis/
    │   ├── SKILL.md
    │   ├── references/{fundamental-analysis, financial-metrics}.md
    │   └── assets/report-template.md
    ├── scenario-analyzer/
    │   ├── SKILL.md
    │   └── references/{headline_event_patterns, sector_sensitivity_matrix,
    │                    scenario_playbooks}.md
    ├── fii-dii-flow-tracker/
    │   ├── SKILL.md
    │   ├── references/{flow_analysis_methodology, flow_interpretation_guide}.md
    │   └── assets/flow_report_template.md
    ├── options-strategy-advisor/
    │   ├── SKILL.md
    │   ├── references/indian_fno_guide.md
    │   └── scripts/black_scholes.py
    ├── backtest-expert/
    │   ├── SKILL.md
    │   ├── references/{methodology, failed_tests}.md
    │   └── scripts/evaluate_backtest.py
    ├── india-market-breadth/
    │   ├── SKILL.md
    │   ├── references/breadth_methodology.md
    │   └── assets/breadth_report_template.md
    ├── india-news-tracker/
    │   ├── SKILL.md
    │   ├── references/{news_source_guide, sector_mapping, sentiment_patterns}.md
    │   ├── scripts/news_fetcher.py
    │   └── assets/daily_briefing_template.md
    └── weekly-fno-trade-planner/
        └── SKILL.md

Broker Integration

All skills support dual broker MCP — use Groww, Zerodha, or both. Each skill auto-detects which broker is connected and uses the appropriate tools.

Zerodha Kite MCP Setup

Add to your Claude Desktop config (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "kite": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.kite.trade/mcp"]
    }
  }
}

That's it — no API keys needed. Authentication happens through Zerodha's secure login flow when you first use it.

Zerodha Kite MCP provides 22 tools:

  • Market Data: get_ltp, get_quotes, get_ohlc, get_historical_data, search_instruments
  • Portfolio: get_holdings, get_positions, get_margins, get_profile, get_mf_holdings
  • Orders: place_order, modify_order, cancel_order, get_orders, get_trades, get_order_history
  • GTT: place_gtt_order, modify_gtt_order, delete_gtt_order, get_gtts

For more details: Zerodha Kite MCP GitHub | Setup Guide

Groww MCP Setup

Groww MCP is available as a connector in Claude. Connect it from the MCP connectors panel.

Data Sources

Source Skills API Key Cost
yfinance VCP Screener, Market Breadth, News Tracker None Free
niftystocks VCP Screener None Free
Groww MCP All skills (market data + fundamentals) Via Claude Free
Zerodha Kite MCP All skills (market data + trading) Via Claude Free
feedparser News Tracker (RSS feeds) None Free
Web Search Flow Tracker, Scenario Analyzer, News Tracker Via Claude Free

Tool Equivalence (Groww ↔ Zerodha)

Action Groww MCP Zerodha Kite MCP
Live price get_ltp get_ltp
Market depth get_quotes_and_depth get_quotes
Historical candles fetch_historical_candle_data get_historical_data
Search instruments curate_symbols search_instruments
Margins calculate_fno_margin get_margins
Holdings get_equity_portfolio_holdings get_holdings
Positions get_my_trading_positions_today get_positions
Place F&O order place_fno_order place_order
Fundamentals fetch_stocks_fundamental_data — (use web search)
OI analysis get_open_interest_analysis — (use web search)
Greeks get_greeks_for_fno_contract — (use Black-Scholes script)

Indian Market Context

Detail Value
Exchanges NSE (primary), BSE
Currency INR (all prices in rupees)
Trading Hours 9:15 AM – 3:30 PM IST
Settlement T+1 for equities
F&O Expiry Weekly (Thu) for index options, monthly for stock options
Circuit Limits 2%, 5%, 10%, 20% daily limits
Regulator SEBI
Key Indices Nifty 50, Sensex, Bank Nifty, Nifty IT, Nifty Pharma

Contributing

Contributions welcome! Some ideas:

  • New skills: CANSLIM screener, promoter pledge monitor, IPO analyzer, F&O ban monitor, trade journal/dashboard
  • Enhancements: Tests for existing calculators, more sector-specific analysis frameworks
  • Data sources: Additional free data integrations (NSE API, BSE API)
  • Documentation: Usage examples, video walkthroughs

Please open an issue first to discuss significant changes.

Disclaimer

This project is for educational and research purposes only. It does not constitute financial advice. Always do your own research before making investment decisions. The authors are not SEBI-registered investment advisors.

Past performance of any strategy, indicator, or methodology does not guarantee future results. Trading in equities and derivatives involves substantial risk of loss.

License

MIT — use it, fork it, build on it.

Credits

About

Claude Skills for Indian equity investors and traders — NSE/BSE stocks, F&O derivatives, institutional flows, and market breadth analysis

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages