Skip to main content
skill CX Codex

spread-analysis — Claude Code skill: what it does, how to install

The spread-analysis skill performs quantitative analysis of multi-leg option strategies for Claude Code. It triggers on requests concerning vertical spreads, iron condors, straddles, or strangle strategies.

MIT 105 installs ★ 417 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add staskh/trading_skills --skill spread-analysis -a claude-code
Open on GitHub

What spread-analysis does

The utility analyzes option strategies by calculating net credit or debit, maximum potential profit, and loss. It generates a JSON output providing breakeven prices and an estimated probability of success based on implied volatility using scripts/spreads.py.

It depends on pandas and yfinance libraries. All timestamp calculations strictly follow the America/New_York timezone. If uv is unavailable or pyproject.toml is missing, the tool defaults to standard python execution.

The resulting JSON includes generated_at and data_delay fields for auditability. Successful operation depends on providing accurate input parameters like expiration dates and strike prices specific to the chosen strategy.

What it helps with

  • calculate option breakeven points
  • evaluate vertical spread risk profile
  • estimate iron condor potential profit
  • compute straddle probability of success

Example prompts for the agent

  • Analyze risk and reward for a vertical spread on AAPL expiring 2026-01-16
  • Calculate iron condor for AAPL with short strikes 175 and 185
  • Evaluate strangle for AAPL with put strike 175 and call strike 185

How to install spread-analysis

1Skills CLI (Vercel)

npx skills add staskh/trading_skills --skill spread-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/spread-analysis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/spread-analysis/

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

Questions about spread-analysis

How to install spread-analysis in Claude Code?

Run npx skills add staskh/trading_skills --skill spread-analysis -a claude-code.

What does spread-analysis do?

It analyzes complex multi-leg option strategies to output risk, reward, and probability metrics in JSON format.

What is required to run spread-analysis?

You need the pandas and yfinance libraries installed. Calculations strictly use America/New_York time.

Source text

SKILL.md · MIT
---
name: spread-analysis
description: Analyze option spread strategies like vertical spreads, iron condors, straddles, strangles. Use when user asks about spreads, multi-leg strategies, vertical spread, iron condor, straddle, strangle, or strategy analysis.
dependencies: ["trading-skills"]
---

# Spread Analysis

Analyze multi-leg option strategies.

## Instructions

> **Note:** If `uv` is not installed or `pyproject.toml` is not found, replace `uv run python` with `python` in all commands below.

```bash
uv run python scripts/spreads.py SYMBOL --strategy STRATEGY --expiry YYYY-MM-DD [options]
```

## Strategies and Options

**Vertical Spread** (bull/bear call/put spread):
```bash
uv run python scripts/spreads.py AAPL --strategy vertical --expiry 2026-01-16 --type call --long-strike 180 --short-strike 185
```

**Straddle** (long call + long put at same strike):
```bash
uv run python scripts/spreads.py AAPL --strategy straddle --expiry 2026-01-16 --strike 180
```

**Strangle** (long call + long put at different strikes):
```bash
uv run python scripts/spreads.py AAPL --strategy strangle --expiry 2026-01-16 --put-strike 175 --call-strike 185
```

**Iron Condor** (sell strangle + buy wider strangle):
```bash
uv run python scripts/spreads.py AAPL --strategy iron-condor --expiry 2026-01-16 --put-short 175 --put-long 170 --call-short 185 --call-long 190
```

## Output

Returns JSON with:
- `strategy` - Strategy name and legs
- `cost` - Net debit or credit
- `max_profit` - Maximum potential profit
- `max_loss` - Maximum potential loss
- `breakeven` - Breakeven price(s)
- `probability` - Estimated probability of profit (based on IV)

Explain the risk/reward and when this strategy is appropriate.

## Dependencies

- `pandas`
- `yfinance`


## Timezone

All timestamps and time-based calculations must use the `America/New_York` timezone. All JSON output must include `generated_at` (NY time string) and `data_delay` fields.

© staskh · MIT · staskh/trading_skills

Similar skills

All skills for Finance and business →
options-strategy-advisor tradermonty options-strategy-advisor is a Claude Code skill that prices options via the Black-Scholes formula, calculates Greeks, and simulates strategy P/L. It evaluates trade risks around earnings events. CX Codex +1 4,100installs HPSILab - Quant Finance MCP Server for Stock Analysis and Options Analytics g-scorpiosky HPSILab - Quant Finance MCP Server for Stock Analysis and Options Analytics is a Claude Code MCP server for equity research and options analytics, with volatility checks and Monte Carlo price paths. CX Codex +1 796installs llmquant-options LLMQuant llmquant-options — a router skill for options work: ranks contracts, computes Greeks, builds strategies and simulates P&L. Useful when you trade IV and hedges. CX Codex +1 517installs Options Analysis Suite Options-Analysis-Suite Options Analysis Suite connects advanced options analytics, dealer positioning data, and dark pool feeds to your AI assistant. Ideal for evaluating volatility surfaces and trading flows directly in chat. CX Codex +1 ★ 1repo stars market-environment-analysis tradermonty market-environment-analysis is a Claude Code skill that gathers stock indices, currency rates, commodity prices and economic data via web search, then reports on market trends, risk sentiment and sector rotation. CX Codex +1 4,300installs data-analysis claude-office-skills data-analysis is a Claude Code skill that analyzes Excel and CSV spreadsheets, finds trends, and creates visualizations. It runs on requests to examine data or prepare a report. CX Codex +1 8,300installs

From the same set12

The whole set →
stock-quote stock-quote is a Claude Code skill that fetches current price, volume, change, and 52-week range for any ticker. CX Codex +1 138installs greeks Skill computes option Greeks (delta, gamma, theta, vega) and implied volatility using the Black-Scholes model. Use it to understand how your position reacts to price changes, time decay, and shifts in volatility. CX Codex +1 137installs report-stock report-stock builds stock research reports in Markdown or PDF covering market trends, PMCC viability, and company fundamentals. CX Codex +1 123installs option-chain Skill pulls option chain data from Yahoo Finance: calls and puts with strike prices, bids, asks, volumes, and implied volatility. Use it to check option quotes for a specific expiration date. CX Codex +1 117installs risk-assessment risk-assessment calculates risk metrics for stocks and positions: volatility, beta, Value at Risk, and maximum drawdown. Use it to assess position risk and determine sizing. CX Codex +1 113installs ib-portfolio ib-portfolio — a skill for Claude Code fetches open positions and holdings from Interactive Brokers. The agent invokes it when asked about current stocks, portfolio value, or account assets. CX Codex +1 107installs ib-account The ib-account Claude Code skill fetches an Interactive Brokers account summary. It activates for questions about balances, buying power, or available cash. CX Codex +1 103installs price-history The price-history Claude Code skill fetches historical OHLCV data for a stock. It activates for requests about past prices or data for chart analysis. CX Codex +1 102installs

Project sponsors

Companies that keep this analytics open