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
npx skills add staskh/trading_skills --skill spread-analysis -a claude-codeWhat 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
AAPLexpiring 2026-01-16 - Calculate iron condor for
AAPLwith short strikes 175 and 185 - Evaluate strangle for
AAPLwith 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-code2Manually: put the files in place
~/.claude/skills/spread-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/spread-analysis/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill spread-analysis -a codex2Manually: put the files in place
.agents/skills/spread-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill spread-analysis -a cursor2Manually: put the files in place
.cursor/skills/spread-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install staskh/trading_skills .claude/skills/spread-analysis2Manually: put the files in place
.github/skills/spread-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill spread-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/staskh/trading_skills --path .claude/skills/spread-analysisManually: put the files in place
.devin/skills/spread-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add staskh/trading_skills --skill spread-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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