Skip to content
Back to search

trading_skills

SkillWorks with Claude CodeGitHub

Claude powered advisor system for option traders

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/staskh/trading_skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/staskh/trading_skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/staskh--trading-skills/badge.svg)](/listings/staskh--trading-skills)

HTML

<a href="/listings/staskh--trading-skills"><img src="/api/listings/staskh--trading-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.

git clone https://github.com/staskh/trading_skills.git
cd trading_skills
uv sync

Run Claude Code or Cursor in the repository root. All skills are available as interactive commands — ask questions about your IBKR portfolio, symbols, or companies of interest.

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 · 334 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Trading Skills — AI-Powered Market Analysis
  2. Most retail traders juggle 5+ tabs — broker, charting platform, screener, news feed, spreadsheet — just to decide whether to enter a trade. This project collapses all of that into a single conversational interface powered by Claude.
  3. Ask a question in plain English, get back real data: technicals, fundamentals, option Greeks, risk metrics, earnings dates, correlation matrices, and full PDF reports. Connect your Interactive Brokers account and it manages your portfolio too — finds roll candidates for expiring shorts, flags earnings risk, and generates action reports.
  4. [![Star History Chart](https://star-history.dera.page/svg?repos=staskh/trading_skills&type=date&legend=bottom-right)](https://star-history.dera.page/#staskh/trading_skills&type=date&legend=bottom-right)
  5. **Who is this for?**
  6. - **Retail options traders** who sell premium, run PMCCs, or manage covered calls
  7. - **Self-directed investors** who want quick fundamental + technical scans without switching tools
  8. - **Python-literate traders** who want to extend the analysis with custom scripts
  9. - **IBRK users** who want AI-assisted portfolio management
  10. **Quick example** — scan for bullish setups and check PMCC viability:
  11. ```
  12. You: Scan AAPL,MSFT,NVDA,GOOGL,AMZN for bullish trends, then check the top picks for PMCC suitability
  13. Claude: [runs scanner-bullish → filters top scores → runs scanner-pmcc]
  14. NVDA: Bullish score 8/10, PMCC score 9.2/11 — LEAPS $95 call (Δ0.82),
  15. sell $140 call (Δ0.18), net debit $5,420, annual yield 47%...
  16. ```
  17. **Another example** — correlation check before adding to a portfolio:
  18. ```
  19. You: Show correlation for SPY,GOOG,NVDA,ZM,RTX,PFE,XOM
  20. Claude: NVDA is the standout diversifier — near-zero correlation with everything.
  21. RTX/XOM at 0.86 — little diversification benefit between them.
  22. ```
  23. ### Real sessions in Claude Desktop (free account)
  24. > *"Analyze option spread strategies and probability of profit for SPY, QQQ and DIA"*
  25. ![Spread analysis with POP metrics for SPY, QQQ, DIA](assets/analyze%20option%20spread%20strategies%20SPY,%20QQQ%20and%20DIA.png)
  26. ## Requirements
  27. - Python 3.12+
  28. - [uv](https://docs.astral.sh/uv/) package manager
  29. - [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Claude Desktop](https://claude.ai/download), or [Cursor](https://cursor.com/) with third-party skills enabled (fully installed and authenticated)
  30. - Optional: TWS or IB Gateway for portfolio features
  31. ## Two Ways to Use
  32. ### Claude Code / Cursor (Full Experience)
  33. #### Installation
  34. ```bash
  35. git clone https://github.com/staskh/trading_skills.git
  36. cd trading_skills
  37. uv sync
  38. ```
  39. Run Claude Code or Cursor in the repository root. All skills are available as interactive commands — ask questions about your IBKR portfolio, symbols, or companies of interest.
  40. ### MCP Server (Claude Desktop)
  41. The MCP server is a lightweight alternative for use with Claude Desktop (including the free tier). It exposes 23 trading analysis tools directly to Claude Desktop without needing Claude Code.
  42. #### Installation
  43. 1. Install the package (requires Python 3.12+):
  44. ```bash
  45. pip install trading-skills
  46. ```
  47. 2. Find the full path to the installed command:
  48. **macOS / Linux:**
  49. ```bash
  50. which trading-skills-mcp
  51. ```
  52. **Windows:**
  53. ```cmd
  54. where trading-skills-mcp
  55. ```
  56. If `where` doesn't find it, locate it manually:
  57. ```cmd
  58. python -c "import sysconfig; print(sysconfig.get_path('scripts'))"
  59. ```
  60. The script will be `trading-skills-mcp.exe` in that directory (typically at `C:\Users\<YourUsername>\AppData\Local\Programs\Python\Python<Version>\Scripts\`)
  61. 3. Open Claude Desktop, go to **Settings** → **Developer** → **Edit Config**:
  62. ![Claude Desktop Settings → Developer](assets/ClaudeDesktop-Settings-Developer.png)
  63. Add the following to `claude_desktop_config.json`:
  64. **macOS / Linux:**
  65. ```json
  66. {
  67. "mcpServers": {
  68. "trading-skills": {
  69. "command": "/full/path/to/trading-skills-mcp"
  70. }
  71. }
  72. }
  73. ```
  74. **Windows:**
  75. ```json
  76. {
  77. "mcpServers": {
  78. "trading-skills": {
  79. "command": "C:\\full\\path\\to\\trading-skills-mcp.exe"
  80. }
  81. }
  82. }
  83. ```
  84. Replace the path with the output from step 2.
  85. 4. Restart Claude Desktop. Don't worry if you see an MCP error message — it will disappear once you try some of the examples below.
  86. #### Installation from GitHub
  87. Add the following to `claude_desktop_config.json`:
  88. **macOS / Linux:**
  89. ```json
  90. {
  91. "mcpServers": {
  92. "trading-skills": {
  93. "command": "uvx",
  94. "args": ["--from", "git+https://github.com/staskh/trading_skills.git", "trading-skills-mcp"]
  95. }
  96. }
  97. }
  98. ```
  99. **Windows:**
  100. ```json
  101. {
  102. "mcpServers": {
  103. "trading-skills": {
  104. "command": "cmd",
  105. "args": ["/c", "uvx", "--from", "git+https://github.com/staskh/trading_skills.git", "trading-skills-mcp"]
  106. }
  107. }
  108. }
  109. ```
  110. ## Example Queries
  111. - "What's AAPL's current price and 1y range?"
  112. - "Run technical analysis on SPY with RSI/MACD"
  113. - "Scan AAPL,MSFT,NVDA,GOOGL for bullish trends"
  114. - "Find PMCC candidates from my watchlist"
  115. - "Compare risk metrics for MSFT vs AAPL"
  116. - "Show correlation between SPY,NVDA,GOOG,XOM"
  117. - "When is NVDA's next earnings?"
  118. - "Show my portfolio positions" (requires IB)
  119. - "Generate portfolio action report" (requires IB)
  120. - "Find roll candidates for my GOOG short call" (requires IB)
  121. ## Available Skills (25)
  122. ### Market Data
  123. | Skill | Description |
  124. |-------|-------------|
  125. | `stock-quote` | Real-time price, volume, change, market cap, 52-week range |
  126. | `option-chain` | Calls and puts with strikes, bids, asks, volume, OI, IV |
  127. | `price-history` | Historical OHLCV data |
  128. | `fundamentals` | Financials, earnings, key metrics, Piotroski F-Score |
  129. | `news-sentiment` | Recent headlines and sentiment |
  130. | `earnings-calendar` | Upcoming earnings dates with BMO/AMC timing and EPS estimates |
  131. | `calendar` | Scheduled US economic events (CPI, NFP, FOMC, GDP...) in ET, with optional ForexFactory cross-check |
  132. | `insider-trading` | SEC Form 4 insider transactions — executive buys/sells and sentiment |
  133. ### Analysis
  134. | Skill | Description |
  135. |-------|-------------|
  136. | `technical-analysis` | RSI, MACD, Bollinger Bands, SMA, EMA, ATR, ADX, correlation matrix |
  137. | `greeks` | Delta, gamma, theta, vega, IV (Black-Scholes) |
  138. | `spread-analysis` | Verticals, diagonals, straddles, strangles, iron condors |
  139. | `risk-assessment` | Volatility, beta, VaR, drawdown, Sharpe ratio |
  140. | `chart-ema-rsi` | JPG chart: daily candles, EMA 9/20 with crossovers marked, RSI panel |
  141. ### Scanners
  142. | Skill | Description |
  143. |-------|-------------|
  144. | `scanner-bullish` | Scan symbols for bullish trends (SMA, RSI, MACD, ADX) |
  145. | `scanner-pmcc` | Scan for PMCC suitability (delta, liquidity, spread, IV, yield) |
  146. | `whale-hunting` | Detect institutional option whale activity for an underlying (requires Massive API key) |
  147. ### Portfolio (requires TWS/Gateway)
  148. > **TWS API access levels:**
  149. > - **Read-only** — fetches positions, prices, and Greeks; places no orders: `ib-account`, `ib-portfolio`, `ib-option-chain`, `ib-find-short-roll`, `ib-collar`, `ib-pmcc-advisor`, `ib-portfolio-action-report`, `ib-create-consolidated-report`, `ib-report-delta-adjusted-notional-exposure`
  150. > - **Read-write** — can place and cancel conditional orders in TWS: `ib-stop-loss` (only when `--execute` is passed; dry-run by default)
  151. | Skill | Description |
  152. |-------|-------------|
  153. | `ib-account` | Account summary (cash, buying power, margin) |
  154. | `ib-portfolio` | Portfolio positions with market prices |
  155. | `ib-option-chain` | Real-time option chain data from IB *(under development)* |
  156. | `ib-find-short-roll` | Roll candidates for short positions or covered call/put selection |
  157. | `ib-collar` | Tactical collar strategy for earnings/event protection |
  158. | `ib-pmcc-advisor` | PMCC position analysis: assignment risk, P&L projections, ranked roll candidates |
  159. | `ib-stop-loss` | Conditional stop-loss management for PMCC, naked LEAPS, and stock positions |
  160. | `ib-portfolio-action-report` | Portfolio review with earnings risk and action items |
  161. | `ib-create-consolidated-report` | Consolidate IBRK trade CSVs into summary reports |
  162. | `ib-report-delta-adjusted-notional-exposure` | Delta-adjusted notional exposure across accounts |
  163. ### Reports
  164. | Skill | Description |
  165. |-------|-------------|
  166. | `report-stock` | Comprehensive PDF/markdown report with trend, PMCC, and fundamental analysis |
  167. ## MCP Server Tools (32 tools)
  168. The MCP server exposes skills as tools for Claude Desktop:
  169. > **TWS API access levels for MCP tools:**
  170. > - **Read-only**: `ib_account`, `ib_portfolio`, `ib_option_expiries`, `ib_option_chain`, `ib_find_short_roll`, `ib_collar`, `ib_pmcc_advisor`, `ib_portfolio_action_report`, `ib_delta_exposure`
  171. > - **Read-write** (places/cancels orders): `ib_stop_loss` when `execute=True`
  172. | Category | Tools |
  173. |----------|-------|
  174. | **Market Data** | `stock_quote`, `price_history`, `news_sentiment`, `insider_trading`, `fundamentals`, `piotroski_score`, `earnings_calendar`, `economic_calendar` |
  175. | **Technical** | `technical_indicators`, `price_correlation`, `risk_assessment` |
  176. | **Options** | `option_expiries`, `option_chain`, `option_greeks` |
  177. | **Spreads** | `spread_vertical`, `spread_diagonal`, `spread_straddle`, `spread_strangle`, `spread_iron_condor` |
  178. | **Scanners** | `scan_bullish`, `scan_pmcc` |
  179. | **Whale Hunting** | `whale_hunting` |
  180. | **Reports** | `report_stock` |
  181. | **IB Portfolio** | `ib_account`, `ib_portfolio`, `ib_option_expiries`†, `ib_option_chain`, `ib_find_short_roll`, `ib_collar`, `ib_pmcc_advisor`, `ib_stop_loss`, `ib_portfolio_action_report`, `ib_delta_exposure` |
  182. † MCP-only helper — not a standalone skill. Used in Claude Desktop to discover available expiry dates before calling `ib_option_chain`.
  183. ## Sandbox Outputs (Not Committed)
  184. Temporary reports, datasets, and notebooks are saved to `sandbox/` and are not committed to git. Report filenames include timestamps: `<name>_YYYY-MM-DD_HHmm.<ext>`.
  185. ## Interactive Brokers Setup
  186. To use IB features:
  187. 1. Install [TWS](https://www.interactivebrokers.com/en/trading/tws.php) or [IB Gateway](https://www.interactivebrokers.com/en/trading/ibgateway-stable.php)
  188. 2. Enable API connections in TWS: Configure → API → Settings → Enable ActiveX and Socket Clients
  189. 3. Note the port: 7497 (paper) or 7496 (live)
  190. ## Massive (formerly Polygon.io) Setup
  191. Whale-detection features (`option_whales`, `whales_hunter`) require a [Massive](https://massive.com/) API key (the platform was previously known as Polygon.io).
  192. ### Claude Code / Cursor
  193. Create a `.env` file in the repository root:
  194. ```bash
  195. MASSIVE_API_KEY=your_polygon_api_key_here
  196. ```
  197. The library loads it automatically via `python-dotenv`.
  198. ### MCP Server (Claude Desktop)
  199. Pass the key through the `env` field in `claude_desktop_config.json`:
  200. **macOS / Linux:**
  201. ```json
  202. {
  203. "mcpServers": {
  204. "trading-skills": {
  205. "command": "/full/path/to/trading-skills-mcp",
  206. "env": {
  207. "MASSIVE_API_KEY": "your_massive_api_key_here"
  208. }
  209. }
  210. }
  211. }
  212. ```
  213. **Windows:**
  214. ```json
  215. {
  216. "mcpServers": {
  217. "trading-skills": {
  218. "command": "C:\\full\\path\\to\\trading-skills-mcp.exe",
  219. "env": {
  220. "MASSIVE_API_KEY": "your_massive_api_key_here"
  221. }
  222. }
  223. }
  224. }
  225. ```
  226. > The `env` block is merged with the system environment, so other variables are not affected.
  227. ## Development
  228. ```bash
  229. # Run tests
  230. uv run pytest tests/ -v
  231. # Lint
  232. uv run ruff check src/ tests/
  233. uv run ruff format src/ tests/
  234. # Test individual script
  235. uv run python .claude/skills/fundamentals/scripts/fundamentals.py AAPL
  236. # Debug MCP server with MCP Inspector
  237. npx @modelcontextprotocol/inspector uv run python -m mcp_server.server
  238. ```
  239. ## Architecture
  240. ```
  241. User Query → Claude Code/Desktop → Skill or MCP Tool → Python Script → Response
  242. ```
  243. Skills are SKILL.md files in `.claude/skills/` that instruct Claude how to fetch and analyze data using Python scripts. Skill scripts live under `.claude/skills/<skill-name>/scripts/`, and progressive reference material belongs in `.claude/skills/<skill-name>/references/`.
  244. The MCP server (`mcp_server/server.py`) wraps the same Python scripts as tools for Claude Desktop via the FastMCP framework.
  245. ## Data Sources
  246. | Source | Used by | Notes |
  247. |--------|---------|-------|
  248. | [Yahoo Finance](https://finance.yahoo.com/) | All market data, fundamental, and options skills | Free; up to 15-minute delay |
  249. | [Massive](https://massive.com/) (formerly Polygon.io) | `whale-hunting` (`whale_hunting` MCP tool) | Paid API key required; see setup section below |
  250. ## License
  251. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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