Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
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 plays, or options risk management. Includes volatility analysis, position sizing, and earnings-based strategy recommendations. Educational focus with practical trade simulation.
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 plays, or options risk management. Includes volatility analysis, position sizing, and earnings-based strategy recommendations. Educational focus with practical trade simulation.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
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
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"
Covered Call - Own stock, sell call (generate income, cap upside) Cash-Secured Put - Sell put with cash backing (collect premium, willing to buy stock) Poor Man's Covered Call - LEAPS call + short near-term call (capital efficient)
Protective Put - Own stock, buy put (insurance, limited downside) Collar - Own stock, sell call + buy put (limited upside/downside)
Bull Call Spread - Buy lower strike call, sell higher strike call (limited risk/reward bullish) Bull Put Spread - Sell higher strike put, buy lower strike put (credit spread, bullish) Bear Call Spread - Sell lower strike call, buy higher strike call (credit spread, bearish) Bear Put Spread - Buy higher strike put, sell lower strike put (limited risk/reward bearish)
Long Straddle - Buy ATM call + ATM put (profit from big move either direction) Long Strangle - Buy OTM call + OTM put (cheaper than straddle, bigger move needed) Short Straddle - Sell ATM call + ATM put (profit from no movement, unlimited risk) Short Strangle - Sell OTM call + OTM put (profit from no movement, wider range)
Iron Condor - Bull put spread + bear call spread (profit from range-bound movement) Iron Butterfly - Sell ATM straddle, buy OTM strangle (profit from tight range)
Calendar Spread - Sell near-term option, buy longer-term option (profit from time decay) Diagonal Spread - Calendar spread with different strikes (directional + time decay) Ratio Spread - Unbalanced spread (more contracts on one leg)
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: Ticker: AAPL Strategy: Bull Call Spread Long Strike: $180 Short Strike: $185 Expiration: 30 days Contracts: 10 IV: 25% (or use HV if not provided)
Objective: Estimate volatility from historical price movements. Method: # Fetch 90 days of price data prices = get_historical_prices("AAPL", days=90) # Calculate daily returns returns = np.log(prices / prices.shift(1)) # Annualized volatility HV = returns.std() * np.sqrt(252) # 252 trading days 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
Black-Scholes Model: For European-style options: Call Price = S * N(d1) - K * e^(-r*T) * N(d2) Put Price = K * e^(-r*T) * N(-d2) - S * N(-d1) Where: d1 = [ln(S/K) + (r + ΟΒ²/2) * T] / (Ο * βT) d2 = d1 - Ο * βT S = Current stock price K = Strike price r = Risk-free rate T = Time to expiration (years) Ο = Volatility (IV or HV) N() = Cumulative standard normal distribution Adjustments: Subtract present value of dividends from S for calls American options: Use approximation or note "European pricing, may undervalue American options" Python Implementation: from scipy.stats import norm import numpy as np def black_scholes_call(S, K, T, r, sigma, q=0): """ S: Stock price K: Strike price T: Time to expiration (years) r: Risk-free rate sigma: Volatility q: Dividend yield """ d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) d2 = d1 - sigma*np.sqrt(T) call_price = S*np.exp(-q*T)*norm.cdf(d1) - K*np.exp(-r*T)*norm.cdf(d2) return call_price def black_scholes_put(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) d2 = d1 - sigma*np.sqrt(T) put_price = K*np.exp(-r*T)*norm.cdf(-d2) - S*np.exp(-q*T)*norm.cdf(-d1) return put_price Output for Each Option Leg: Theoretical price Note: "Market price may differ due to bid-ask spread and American vs European pricing"
The Greeks measure option price sensitivity to various factors: Delta (Ξ): Change in option price per $1 change in stock price def delta_call(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) return np.exp(-q*T) * norm.cdf(d1) def delta_put(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) return np.exp(-q*T) * (norm.cdf(d1) - 1) Gamma (Ξ): Change in delta per $1 change in stock price def gamma(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) return np.exp(-q*T) * norm.pdf(d1) / (S * sigma * np.sqrt(T)) Theta (Ξ): Change in option price per day (time decay) def theta_call(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) d2 = d1 - sigma*np.sqrt(T) theta = (-S*norm.pdf(d1)*sigma*np.exp(-q*T)/(2*np.sqrt(T)) - r*K*np.exp(-r*T)*norm.cdf(d2) + q*S*norm.cdf(d1)*np.exp(-q*T)) return theta / 365 # Per day Vega (Ξ½): Change in option price per 1% change in volatility def vega(S, K, T, r, sigma, q=0): d1 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) return S * np.exp(-q*T) * norm.pdf(d1) * np.sqrt(T) / 100 # Per 1% Rho (Ο): Change in option price per 1% change in interest rate def rho_call(S, K, T, r, sigma, q=0): d2 = (np.log(S/K) + (r - q + 0.5*sigma**2)*T) / (sigma*np.sqrt(T)) - sigma*np.sqrt(T) return K * T * np.exp(-r*T) * norm.cdf(d2) / 100 # Per 1% Position Greeks: For a strategy with multiple legs, sum Greeks across all legs: # Example: Bull Call Spread # Long 1x $180 call # Short 1x $185 call delta_position = (1 * delta_long) + (-1 * delta_short) gamma_position = (1 * gamma_long) + (-1 * gamma_short) theta_position = (1 * theta_long) + (-1 * theta_short) vega_position = (1 * vega_long) + (-1 * vega_short) Greeks Interpretation: GreekMeaningExampleDeltaDirectional exposureΞ = 0.50 β $50 profit if stock +$1GammaDelta accelerationΞ = 0.05 β Delta increases by 0.05 if stock +$1ThetaDaily time decayΞ = -$5 β Lose $5/day from time passingVegaVolatility sensitivityΞ½ = $10 β Gain $10 if IV increases 1%RhoInterest rate sensitivityΟ = $2 β Gain $2 if rates increase 1%
Objective: Calculate profit/loss at various stock prices at expiration. Method: Generate stock price range (e.g., Β±30% from current price): current_price = 180 price_range = np.linspace(current_price * 0.7, current_price * 1.3, 100) For each price point, calculate P/L: def calculate_pnl(strategy, stock_price_at_expiration): pnl = 0 for leg in strategy.legs: if leg.type == 'call': intrinsic_value = max(0, stock_price_at_expiration - leg.strike) else: # put intrinsic_value = max(0, leg.strike - stock_price_at_expiration) if leg.position == 'long': pnl += (intrinsic_value - leg.premium_paid) * 100 # Per contract else: # short pnl += (leg.premium_received - intrinsic_value) * 100 return pnl * num_contracts 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: Bull Call Spread: $180/$185 on AAPL (30 DTE, 10 contracts) Current Price: $180.00 Net Debit: $2.50 per spread ($2,500 total) Max Profit: $2,500 (at $185+) Max Loss: -$2,500 (at $180-) Breakeven: $182.50 Risk/Reward: 1:1 Probability Profit: ~55% (if stock stays above $182.50)
Visual representation of P/L across stock prices: def generate_pnl_diagram(price_range, pnl_values, current_price, width=60, height=15): """Generate ASCII P/L diagram""" # Normalize to chart dimensions max_pnl = max(pnl_values) min_pnl = min(pnl_values) lines = [] lines.append(f"\nP/L Diagram: {strategy_name}") lines.append("-" * width) # Y-axis levels levels = np.linspace(max_pnl, min_pnl, height) for level in levels: if abs(level) < (max_pnl - min_pnl) * 0.05: label = f" 0 |" # Zero line else: label = f"{level:6.0f} |" row = label for i in range(width - len(label)): idx = int(i / (width - len(label)) * len(price_range)) pnl = pnl_values[idx] price = price_range[idx] # Determine character if abs(pnl - level) < (max_pnl - min_pnl) / height: if pnl > 0: char = 'β' # Profit elif pnl < 0: char = 'β' # Loss else: char = 'β' # Breakeven elif abs(level) < (max_pnl - min_pnl) * 0.05: char = 'β' # Zero line elif abs(price - current_price) < (price_range[-1] - price_range[0]) * 0.02: char = 'β' # Current price line else: char = ' ' row += char lines.append(row) lines.append(" " * 6 + "|" + "-" * (width - 6)) lines.append(" " * 6 + f"${price_range[0]:.0f}" + " " * (width - 20) + f"${price_range[-1]:.0f}") lines.append(" " * (width // 2 - 5) + "Stock Price") return "\n".join(lines) Example Output: P/L Diagram: Bull Call Spread $180/$185 ------------------------------------------------------------ +2500 | ββββββββββββββββββββ | ββββββ | ββββββ | ββββββ 0 | ββββββ | ββββββ |ββββββ -2500 |βββββ |____________________________________________________________ $126 $180 $234 Stock Price Legend: β Profit β Loss ββ Breakeven β Current Price
What Users Should Know: Black-Scholes Assumptions: European-style options (can't exercise early) Constant volatility (IV changes in reality) No transaction costs Continuous trading 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 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
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
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.8+, numpy, scipy, pandas
Use Case 1: Learn Strategy User: "Explain a covered call" Workflow: 1. Load strategy reference (references/strategies_guide.md) 2. Explain concept, risk/reward, when to use 3. Simulate example on AAPL 4. Show P/L diagram 5. Compare to alternatives Use Case 2: Analyze Specific Trade User: "Analyze $180/$185 bull call spread on AAPL, 30 days" Workflow: 1. Fetch AAPL price from FMP 2. Calculate HV or ask user for IV 3. Price both options (Black-Scholes) 4. Calculate Greeks 5. Simulate P/L 6. Generate analysis report Use Case 3: Earnings Strategy User: "Should I trade options before NVDA earnings?" Workflow: 1. Fetch NVDA earnings date (Earnings Calendar) 2. Calculate days to earnings 3. Estimate IV percentile (if user provides IV) 4. Suggest straddle/strangle vs iron condor 5. Warn about IV crush 6. Simulate both strategies Use Case 4: Portfolio Greeks Check User: "What are my total portfolio Greeks?" Workflow: 1. User provides current positions 2. Calculate Greeks for each position 3. Sum Greeks across portfolio 4. Assess overall exposure 5. Suggest adjustments if needed
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
References: references/strategies_guide.md - All 17+ strategies explained references/greeks_explained.md - Greeks deep dive references/volatility_guide.md - HV vs IV, when to trade 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.8+, numpy, scipy, pandas, requests API: FMP API (Free tier sufficient)
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.