options-strategy-advisor
Options trading strategy analysis and simulation tool. Provides theoretical pricing using Black-Scholes model, Greeks calculation, strategy P/L simulation, and risk management guidance. Use when user requests options strategy analysis, covered calls, protective puts, spreads, iron condors, earnings
By tradermonty · 2,508 installs
npx skills add tradermonty/claude-trading-skills --skill options-strategy-advisor
Source repository · Upstream listing
Options Strategy Advisor
Overview
This skill provides comprehensive options strategy analysis and education using theoretical pricing models. It helps traders understand, analyze, and simulate options strategies without requiring real time market data subscriptions.
Core Capabilities:
Black Scholes Pricing : Theoretical option prices and Greeks calculation
Strategy Simulation : P/L analysis for major options strategies
Earnings Strategies : Pre earnings volatility plays integrated with Earnings Calendar
Risk Management : Position sizing, Greeks exposure, max loss/profit analysis
Educational Focus : Detailed explanations of strategies and risk metrics
Data Sources:
FMP API: Stock prices, historical volatility, dividends, earnings dates
User Input: Implied volatility (IV), risk free rate
Theoretical Models: Black Scholes for pricing and Greeks
Prerequisites
Required:
Python 3.9+ with numpy , scipy , requests
Optional:
FMP API key (for real time stock prices and historical volatility)
Set via FMP API KEY environment variable or api key argument
Without API key: Use manual inputs for stock price and volatility
Installation:
Quick Start Examples:
When to Use This Skill
Use this skill when:
User asks about options strategies ("What's a covered call?", "How does an iron condor work?")
User wants to simulate strategy P/L ("What's my max profit on a bull call spread?")
User needs Greeks analysis ("What's my delta exposure?")
User asks about earnings strategies ("Should I buy a straddle before earnings?")
User wants to compare strategies ("Covered call vs protective put?")
User needs position sizing guidance ("How many contracts should I trade?")
User asks about volatility ("Is IV high right now?")
Example requests:
"Analyze a covered call on AAPL"
"What's the P/L on a $100/$105 bull call spread on MSFT?"
"Should I trade a straddle before NVDA earnings?"
"Calculate Greeks for my iron condor position"
"Compare protective put vs covered call for downside protection"
Supported Strategies
Income Strategies
1. Covered Call Own stock, sell call (generate income, cap upside)
2. Cash Secured Put Sell put with cash backing (collect premium, willing to buy stock)
3. Poor Man's Covered Call LEAPS call + short near term call (capital efficient)
Protection Strategies
4. Protective Put Own stock, buy put (insurance, limited downside)
5. Collar Own stock, sell call + buy put (limited upside/downside)
Directional Strategies
6. Bull Call Spread Buy lower strike call, sell higher strike call (limited risk/reward bullish)
7. Bull Put Spread Sell higher strike put, buy lower strike put (credit spread, bullish)
8. Bear Call Spread Sell lower strike call, buy higher strike call (credit spread, bearish)
9. Bear Put Spread Buy higher strike put, sell lower strike put (limited risk/reward bearish)
Volatility Strategies
10. Long Straddle Buy ATM call + ATM put (profit from big move either direction)
11. Long Strangle Buy OTM call + OTM put (cheaper than straddle, bigger move needed)
12. Short Straddle Sell ATM call + ATM put (profit from no movement, unlimited risk)
13. Short Strangle Sell OTM call + OTM put (profit from no movement, wider range)
Range Bound Strategies
14. Iron Condor Bull put spread + bear call spread (profit from range bound movement)
15. Iron Butterfly Sell ATM straddle, buy OTM strangle (profit from tight range)
Advanced Strategies
16. Calendar Spread Sell near term option, buy longer term option (profit from time decay)
17. Diagonal Spread Calendar spread with different strikes (directional + time decay)
18. Ratio Spread Unbalanced spread (more contracts on one leg)
Analysis Workflow
Step 1: Gather Input Data
Required from User:
Ticker symbol
Strategy type
Strike prices
Expiration date(s)
Position size (number of contracts)
Optional from User:
Implied Volatility (IV) if not provided, use Historical Volatility (HV)
Risk free rate default to current 3 month T bill rate (~5.3% as of 2025)
Fetched from FMP API:
Current stock price
Historical prices (for HV calculation)
Dividend yield
Upcoming earnings date (for earnings strategies)
Example User Input:
Step 2: Calculate Historical Volatility (if IV not provided)
Objective: Estimate volatility from historical price movements.
Method:
Output:
Historical Volatility (annualized percentage)
Note to user: "HV = 24.5%, consider using current market IV for more accuracy"
User Can Override:
Provide IV from broker platform (ThinkorSwim, TastyTrade, etc.)
Script accepts iv 28.0 parameter
Step 3: Price Options Using Black Scholes
Black Scholes Model:
For European style options:
Adjustments:
Subtract present value of dividends from S for calls
American options: Use approximation or note "European pricing, may undervalue American options"
Python Implementation:
Output for Each Option Leg:
Theoretical price
Note: "Market price may differ due to bid ask spread and American vs European pricing"
Step 4: Calculate Greeks
The Greeks measure option price sensitivity to various factors:
Delta (Δ): Change in option price per $1 change in stock price
Gamma (Γ): Change in delta per $1 change in stock price
Theta (Θ): Change in option price per day (time decay)
Vega (ν): Change in option price per 1% change in volatility
Rho (ρ): Change in option price per 1% change in interest rate
Position Greeks:
For a strategy with multiple legs, sum Greeks across all legs:
Greeks Interpretation:
Greek Meaning Example
Delta Directional exposure Δ = 0.50 → $50 profit if stock +$1
Gamma Delta acceleration Γ = 0.05 → Delta increases by 0.05 if stock +$1
Theta Daily time decay Θ = $5 → Lose $5/day from time passing
Vega Volatility sensitivity ν = $10 → Gain $10 if IV increases 1%
Rho Interest rate sensitivity ρ = $2 → Gain $2 if rates increase 1%
Step 5: Simulate Strategy P/L
Objective: Calculate profit/loss at various stock prices at expiration.
Method:
Generate stock price range (e.g., ±30% from current price):
For each price point, calculate P/L:
Key Metrics:
Max Profit : Highest possible P/L
Max Loss : Worst possible P/L
Breakeven Point(s) : Stock price(s) where P/L = 0
Profit Probability : Percentage of price range that's profitable (simplified)
Example Output:
Step 6: Generate P/L Diagram (ASCII Art)
Visual representation of P/L across stock prices:
Example Output:
Step 7: Strategy Specific Analysis
Provide tailored guidance based on strategy type:
Covered Call:
Protective Put:
Iron Condor:
Step 8: Earnings Strategy Analysis
Integration with Earnings Calendar:
When user asks about earnings strategies, fetch earnings date:
Pre Earnings Strategies:
Long Straddle/Strangle:
Short Iron Condor:
Step 9: Risk Management Guidance
Position Sizing:
Portfolio Greeks Management:
Adjustments and Exits:
Output Format
Strategy Analysis Report Template:
File Naming Convention:
Example: options analysis AAPL BullCallSpread 2025 11 08.md
Key Principles
Theoretical Pricing Limitations
What Users Should Know:
1. Black Scholes Assumptions:
European style options (can't exercise early)
Constant volatility (IV changes in reality)
No transaction costs
Continuous trading
2. Real vs Theoretical:
Bid ask spread: Actual cost higher than theoretical
American options: Can be exercised early (especially ITM puts)
Liquidity: Wide markets on illiquid options
Dividends: Ex dividend dates affect pricing
3. Best Practices:
Use as educational tool and comparative analysis
Get real quotes from broker before trading
Understand theoretical price ≈ mid market price
Account for commissions and slippage
Volatility Guidance
Historical vs Implied Volatility:
IV Percentile:
User provides current IV, we calculate percentile:
Integration with Other Skills
Earnings Calendar:
Fetch earnings dates automatically
Suggest earnings specific strategies
Calculate days to earnings (DTE critical for IV)
Warn about IV crush risk
Technical Analyst:
Use support/resistance for strike selection
Trend analysis for directional strategies
Breakout potential for straddle/strangle timing
US Stock Analysis:
Fundamental analysis for longer term strategies (LEAPS)
Dividend yield for covered call/put analysis
Earnings quality for earnings plays
Bubble Detector:
High bubble risk → focus on protective puts
Low risk → bullish strategies
Critical risk → avoid long premium (theta hurts)
Portfolio Manager:
Track options positions alongside stock positions
Aggregate Greeks across portfolio
Options as hedging tool for stock positions
Important Notes
All analysis in English
Educational focus : Strategies explained clearly
Theoretical pricing : Black Scholes approximation
User IV input : Optional, defaults to HV
No real time data required : FMP Free tier sufficient
Dependencies : Python 3.9+, numpy, scipy, requests
Common Use Cases
Use Case 1: Learn Strategy
Use Case 2: Analyze Specific Trade
Use Case 3: Earnings Strategy
Use Case 4: Portfolio Greeks Check
Troubleshooting
Problem: IV not available
Solution: Use HV as proxy, note to user
Ask user to provide IV from broker platform
Problem: Negative option price
Solution: Check inputs (strike vs stock price)
Deep ITM options may have numerical issues
Problem: Greeks seem wrong
Solution: Verify inputs (T, sigma, r)
Check if using annual vs daily values
Problem: Strategy too complex
Solution: Break into legs, analyze separately
Refer to references for strategy details
Resources
References:
references/black scholes methodology.md Black Scholes formulas, Greeks, and interpretation
references/strategies guide.md All 17+ strategies explained (future)
references/greeks explained.md Greeks deep dive (future)
references/volatility guide.md HV vs IV, when to trade (future)
Scripts:
scripts/black scholes.py Pricing engine and Greeks
scripts/strategy analyzer.py Strategy simulation
scripts/earnings strategy.py Earnings specific analysis
External Resources:
Options Playbook: https://www.optionsplaybook.com/
CBOE Education: https://www.cboe.com/education/
Black Scholes Calculator: Various online tools for verification
Version : 1.0
Last Updated : 2025 11 08
Dependencies : Python 3.9+, numpy, scipy, requests
API : FMP API (Free tier sufficient)