options-spread-conviction-engine
Multi-regime options spread analysis engine with quantitative rigor. Features regime detection (VIX-based), GARCH volatility forecasting, drawdown-constrained Kelly position sizing, and walk-forward backtesting. Scores vertical spreads (bull put, bear call, bull call, bear put) and multi-leg strategies (iron condors, butterflies, calendar spreads) using Ichimoku, RSI, MACD, Bollinger Bands, and IV term structure analysis.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/adamnaghs/options-spread-conviction-engineOptions Spread Conviction Engine
Multi-regime options spread scoring using technical indicators and IV term structure analysis.
Install
brew install jq
npm install yahoo-finance2
sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf
Overview
This engine analyzes any ticker and scores seven options strategies across two categories:
Vertical Spreads (Directional)
| Strategy | Type | Philosophy | Ideal Setup |
|---|---|---|---|
| bull_put | Credit | Mean Reversion | Bullish trend + oversold dip |
| bear_call | Credit | Mean Reversion | Bearish trend + overbought rip |
| bull_call | Debit | Breakout | Strong bullish momentum |
| bear_put | Debit | Breakout | Strong bearish momentum |
Multi-Leg Strategies (Non-Directional / Theta)
| Strategy | Type | Philosophy | Ideal Setup |
|---|---|---|---|
| iron_condor | Credit | Premium Selling | IV Rank >70, RSI neutral, range-bound |
| butterfly | Debit | Pinning Play | BB squeeze, RSI center, low ADX |
| calendar | Debit | Theta Harvest | Inverted IV term structure (front > back) |
Scoring Methodology
Vertical Spreads
Weights vary by strategy type (Credit = Mean Reversion, Debit = Breakout):
Credit Spreads (bull_put, bear_call)
| Indicator | Weight | Purpose |
|---|---|---|
| Ichimoku Cloud | 25 pts | Trend structure & equilibrium |
| RSI | 20 pts | Entry timing (mean-reversion) |
| MACD | 15 pts | Momentum confirmation |
| Bollinger Bands | 25 pts | Volatility regime |
| ADX | 15 pts | Trend strength validation |
Debit Spreads (bull_call, bear_put)
| Indicator | Weight | Purpose |
|---|---|---|
| Ichimoku Cloud | 20 pts | Trend confirmation |
| RSI | 10 pts | Directional momentum |
| MACD | 30 pts | Breakout acceleration |
| Bollinger Bands | 25 pts | Bandwidth expansion |
| ADX | 15 pts | Trend strength validation |
Multi-Leg Strategies
Iron Condor (Credit / Range-Bound)
| Component | Weight | Rationale |
|---|---|---|
| IV Rank (BBW %) | 25 pts | Rich premiums to sell |
| RSI Neutrality | 20 pts | No directional momentum |
| ADX Range-Bound | 20 pts | Weak trend = range structure |
| Price Position | 20 pts | Centered in range = safe margins |
| MACD Neutrality | 15 pts | No acceleration in any direction |
Triggers:
- IV Rank > 70: Premium-rich environment
- RSI 40-60: Neutral momentum
- ADX < 25: Weak/no trend
- Price near %B center: Max profit zone maximized
Strike Selection:
- SELL put at 1-sigma below price (short put)
- BUY put at 2-sigma below (long put — wing)
- SELL call at 1-sigma above price (short call)
- BUY call at 2-sigma above (long call — wing)
Output:
- All 4 strikes (put_long, put_short, call_short, call_long)
- Max profit zone (width between short strikes)
- Wing width
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-adamnaghs-options-spread-conviction-engine": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
Safe Web
Skill by adamnaghs
lsp
Multi-language code navigation via persistent LSP daemons. Supports Python (pyright), TypeScript/JS, Rust, Go, C/C++, Bash, Java, CSS, HTML, JSON. Auto-detects language from file extension and lazy-starts the appropriate server. Use instead of grep for definitions, references, hover, symbols, and diagnostics.