@v587d/capital-generation 2.7.0 → 2.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/CHANGELOG.md +77 -1
  2. package/LICENSE +1 -1
  3. package/README.md +10 -9
  4. package/THIRD_PARTY_NOTICES.md +14 -4
  5. package/capital-config/client.js +50 -10
  6. package/capital-config/client.src.cjs +376 -62
  7. package/capital-config/index.js +168 -5
  8. package/capital-config/package.json +1 -1
  9. package/capital-watchlist/package.json +1 -1
  10. package/chart-ui/package.json +1 -1
  11. package/lib/agents/selected-skills-provider.js +5 -5
  12. package/lib/index.d.ts +4 -28
  13. package/lib/index.js +8 -18
  14. package/lib/web-retriever/local-fetch.d.ts +1 -1
  15. package/lib/web-retriever/local-fetch.js +1 -1
  16. package/lib/web-retriever/wind-client.d.ts +1 -1
  17. package/lib/web-retriever/wind-client.js +1 -1
  18. package/package.json +3 -1
  19. package/selected-skills/InvestSkill/ADDING-NEW-SKILLS.md +546 -0
  20. package/selected-skills/InvestSkill/CHANGELOG.md +373 -0
  21. package/selected-skills/InvestSkill/CI-CD-GUIDE.md +432 -0
  22. package/selected-skills/InvestSkill/CLAUDE.md +148 -0
  23. package/selected-skills/InvestSkill/CONTRIBUTING.md +291 -0
  24. package/selected-skills/InvestSkill/DEPLOYMENTS.md +321 -0
  25. package/selected-skills/InvestSkill/FAQ.md +509 -0
  26. package/selected-skills/InvestSkill/GEMINI.md +419 -0
  27. package/selected-skills/InvestSkill/LICENSE +21 -0
  28. package/selected-skills/InvestSkill/PLATFORM-COMPATIBILITY.md +529 -0
  29. package/selected-skills/InvestSkill/README-claude-code.md +435 -0
  30. package/selected-skills/InvestSkill/README-cursor.md +475 -0
  31. package/selected-skills/InvestSkill/README-gemini.md +532 -0
  32. package/selected-skills/InvestSkill/README-ollama.md +106 -0
  33. package/selected-skills/InvestSkill/README-zh-TW.md +461 -0
  34. package/selected-skills/InvestSkill/README.md +311 -0
  35. package/selected-skills/InvestSkill/RELEASE-QUICK-REFERENCE.md +230 -0
  36. package/selected-skills/InvestSkill/RELEASE_NOTES.md +121 -0
  37. package/selected-skills/InvestSkill/SECURITY.md +232 -0
  38. package/selected-skills/InvestSkill/TODO.md +28 -0
  39. package/selected-skills/InvestSkill/UPSTREAM.md +62 -0
  40. package/selected-skills/InvestSkill/install.sh +212 -0
  41. package/selected-skills/InvestSkill/package.json +64 -0
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/README.md +119 -0
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +338 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +233 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +327 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/chart-master/SKILL.md +648 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +478 -0
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dcf-valuation/SKILL.md +109 -0
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +684 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +456 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +277 -0
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +349 -0
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +279 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +288 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +544 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/full-report/SKILL.md +301 -0
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fundamental-analysis/SKILL.md +67 -0
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +336 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +502 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +548 -0
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +311 -0
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +495 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +465 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +429 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/report-generator/SKILL.md +857 -0
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/research-bundle/SKILL.md +94 -0
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/result-validator/SKILL.md +174 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +293 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +426 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +397 -0
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +645 -0
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +244 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +640 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +351 -0
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +654 -0
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +317 -0
  77. package/selected-skills/README.md +15 -5
  78. package/selected-skills/catalog.js +589 -14
  79. package/selected-skills/investment-skills/UPSTREAM.md +1 -1
  80. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
  81. package/selected-skills/peter-lynch-skill/LICENSE +21 -0
  82. package/selected-skills/peter-lynch-skill/README.md +305 -0
  83. package/selected-skills/peter-lynch-skill/UPSTREAM.md +71 -0
  84. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +142 -0
  85. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology.md +587 -0
  86. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/system-prompt.md +102 -0
  87. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research.md +471 -0
  88. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/disclaimer.md +2 -0
  89. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/filing-rules.md +64 -0
  90. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology.md +195 -0
  91. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/system-prompt.md +72 -0
  92. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research.md +379 -0
@@ -0,0 +1,495 @@
1
+ ---
2
+ name: options-analysis
3
+ description: Analyze options Greeks, implied volatility, and strategy selection for US stocks
4
+ ---
5
+
6
+ # Options Analysis
7
+
8
+ ## ⚠️ Data Verification — Do This Before Any Analysis
9
+
10
+ Before running any analysis, always retrieve the latest market data for the ticker:
11
+
12
+ 1. **Fetch current price** — get the live price, 52-week range, and market cap through the host's own data path. In a host that splits roles, delegate the request with an exact brief (ticker, fields, as-of date) rather than searching from this step. Never assume a price from training data.
13
+ 2. **Confirm key figures** — recent earnings, revenue, key ratios (P/E, P/S, etc.) as applicable to this skill.
14
+ 3. **State your data source** — fill in the `Data & Sources` header (next section) so the origin, as-of date, retrieval path, and confidence of every figure are explicit at the top of the output.
15
+ 4. **Stop on missing data** — if a figure cannot be retrieved through the host's data path, name what is missing and stop; the analysis does not run on remembered values:
16
+
17
+ > ⚠️ **Data unavailable.** <list the figures this analysis could not retrieve>. Those fields are reported as missing and are not estimated — retrieval is a precondition, not a nicety.
18
+
19
+ Never substitute a remembered value for a retrieved one. Getting the number is the host data path's job — delegate it; asking the user to paste is the last resort only where the host has no retrieval path at all.
20
+
21
+ ---
22
+
23
+ ## 📋 Data & Sources Header — Open Every Output With It
24
+
25
+ The first thing in the output is this provenance block, filled in — never left as placeholders. It is the standard documented on the [Data & Accuracy](https://yennanliu.github.io/InvestSkill/data-and-accuracy.html) page and the first thing `result-validator` looks for:
26
+
27
+ ```
28
+ Data & Sources
29
+ As of: <date the figures represent, e.g. 2026-06-30>
30
+ Source: <primary docs — SEC EDGAR 10-K/10-Q, company IR, FRED, exchange data …>
31
+ Retrieval: <delegated retrieval | web/tool retrieval | pasted by user>
32
+ Confidence: <HIGH | MEDIUM | LOW>
33
+ ```
34
+
35
+ - Memory is not a retrieval path. A figure that was neither retrieved nor supplied by the user is reported as missing, never estimated — and never written into this block as if it had been retrieved.
36
+ - Mixed sources: list each with its own as-of date rather than blending them.
37
+ - Data the user pasted is reported as `pasted by user`; do not upgrade its confidence beyond what the user's own source supports.
38
+
39
+ ---
40
+
41
+ Comprehensive analysis of options Greeks, implied volatility dynamics, strategy selection, and risk/reward frameworks for US-listed equity options. Designed to help identify optimal strategies based on market outlook, volatility environment, and underlying stock context.
42
+
43
+ **Risk Disclaimer**: Options involve significant leverage and can result in the loss of the entire premium paid or, for short options, losses substantially exceeding the initial credit received. This analysis is for educational and informational purposes only and does not constitute financial advice.
44
+
45
+ ## Analysis Framework
46
+
47
+ ### 1. Options Basics and Context
48
+
49
+ **Core Terminology**
50
+ - **Strike price**: The price at which the option holder can buy (call) or sell (put) the underlying stock
51
+ - **Expiration date**: The date the option contract expires; American-style options can be exercised at any time before expiration
52
+ - **Premium**: The market price of the option contract (cost to buyer, credit received by seller)
53
+ - **Contract**: Represents 100 shares of the underlying stock
54
+ - **ITM (In-the-Money)**: Call with strike < stock price; Put with strike > stock price — has intrinsic value
55
+ - **ATM (At-the-Money)**: Strike approximately equal to current stock price
56
+ - **OTM (Out-of-the-Money)**: Call with strike > stock price; Put with strike < stock price — only time value, no intrinsic value
57
+
58
+ **Intrinsic Value vs. Time Value**
59
+ - Premium = Intrinsic Value + Time Value (Extrinsic Value)
60
+ - Intrinsic value: how far ITM the option is (cannot be negative)
61
+ - Time value: premium above intrinsic value — represents probability of further price movement and time remaining
62
+
63
+ **When to Use Options vs. Stock**
64
+ - **Leverage**: Control 100 shares with a fraction of the capital (calls vs. outright long)
65
+ - **Hedging**: Protect existing portfolio positions (protective puts, collars)
66
+ - **Income generation**: Sell covered calls or cash-secured puts to generate premium income
67
+ - **Volatility plays**: Profit from large moves (straddles) or stability (iron condors) regardless of direction
68
+ - **Defined risk**: Spreads cap maximum loss to the debit paid
69
+
70
+ ### 2. The Greeks Analysis
71
+
72
+ **Delta (Δ) — Directional Sensitivity**
73
+
74
+ Definition: Change in option price for a $1 move in the underlying stock price.
75
+
76
+ ```
77
+ Option Type Delta Range Moneyness Context
78
+ Call (long) 0 to +1.0 Deep OTM ≈ 0.05, ATM ≈ 0.50, Deep ITM ≈ 0.99
79
+ Put (long) -1.0 to 0 Deep OTM ≈ -0.05, ATM ≈ -0.50, Deep ITM ≈ -0.99
80
+ ```
81
+
82
+ - **Delta as probability proxy**: A 70-delta option approximates a 70% probability of expiring ITM (rough heuristic, not precise)
83
+ - **Position delta**: Sum of all delta exposure across a portfolio = total directional equivalent shares
84
+ - Directional traders: select delta matching conviction (high delta = high directional exposure, lower leverage; low delta = cheaper, more speculative)
85
+ - Delta hedging: offset option delta with opposite stock position to create delta-neutral portfolio
86
+
87
+ **Gamma (Γ) — Rate of Delta Change**
88
+
89
+ Definition: Rate of change of delta for a $1 move in the underlying.
90
+
91
+ - Gamma is highest for ATM options and increases dramatically as expiration approaches
92
+ - **Long gamma**: Long options positions (long calls or puts) — benefits from large moves in either direction; gamma accelerates gains as stock moves through strike
93
+ - **Short gamma**: Short options positions — benefits from stability and small moves; faces accelerating losses on large moves
94
+ - **Gamma risk at expiration**: ATM options near expiry have very high gamma — pin risk and rapid delta shifts
95
+ - **Gamma scalping**: Dynamically delta-hedging a long gamma position to profit from realized volatility exceeding implied volatility
96
+ - Weekly options have the highest gamma, making them both powerful and dangerous near expiry
97
+
98
+ **Theta (Θ) — Time Decay**
99
+
100
+ Definition: Daily erosion of an option's value due to the passage of time (always negative for long options, positive for short options).
101
+
102
+ - Theta represents the "rent" paid to maintain a long options position
103
+ - Time decay is not linear — it accelerates as expiration approaches
104
+
105
+ ```
106
+ DTE Range Theta Decay Speed
107
+ >90 days Slow — manageable for long holders
108
+ 60-90 days Moderate — beginning to accelerate
109
+ 30-60 days Elevated — meaningful daily decay
110
+ 15-30 days Fast — significant daily cost
111
+ 7-15 days Rapid — theta dominates P&L
112
+ <7 days Extreme — ATM options decay very rapidly
113
+ ```
114
+
115
+ - **Theta / premium**: The daily decay as a percentage of the option's premium
116
+ - Short options strategies (iron condors, covered calls) benefit from theta; structure positions so that time is your ally
117
+ - Rule of thumb: avoid holding long OTM options into the final 21 days unless near a catalyst
118
+
119
+ **Vega (ν) — Volatility Sensitivity**
120
+
121
+ Definition: Change in option price for a 1 percentage point change in implied volatility (IV).
122
+
123
+ - **Long options = long vega**: Long calls and long puts both benefit from IV expansion
124
+ - **Short options = short vega**: Short premium strategies benefit from IV contraction (volatility crush)
125
+ - Vega is largest for ATM options with 30-60 days to expiration
126
+ - Earnings and binary events dramatically increase vega exposure — IV expands before event, then collapses after (volatility crush)
127
+
128
+ ```
129
+ IV Change Impact on Long Option:
130
+ +5% IV increase on $5.00 option with vega 0.20 = +$1.00 gain
131
+ -5% IV decrease (post-earnings crush) = -$1.00 loss
132
+ ```
133
+
134
+ - **Vega term structure**: Long-dated options have higher absolute vega — more sensitive to IV changes
135
+ - Managing vega: use spreads to reduce net vega exposure (long spread = smaller net vega than long naked option)
136
+
137
+ **Rho (ρ) — Interest Rate Sensitivity**
138
+
139
+ Definition: Change in option price for a 1 percentage point change in the risk-free interest rate.
140
+
141
+ - Calls have positive rho: benefit from interest rate increases (higher rates increase call values)
142
+ - Puts have negative rho: decrease in value as interest rates rise
143
+ - Rho is typically the least impactful Greek for short-dated options
144
+ - More relevant for LEAPS (long-dated options with 1-2 year expirations) in a higher interest rate environment
145
+ - In a high-rate environment (rates >4%): rho becomes a meaningful consideration for 6-12 month options strategies
146
+
147
+ ### 3. Implied Volatility (IV) Analysis
148
+
149
+ **IV vs. Historical Volatility (HV)**
150
+ - **IV (Implied Volatility)**: Forward-looking volatility derived from current option prices — reflects market's expectation of future price swings
151
+ - **HV (Historical Volatility)**: Realized past volatility measured over 20, 30, or 60 days
152
+ - **IV > HV**: Options are expensive relative to recent realized movement — favor selling premium (credit strategies)
153
+ - **IV < HV**: Options are cheap relative to recent realized movement — favor buying premium (debit strategies)
154
+ - **IV/HV ratio**: >1.2 = meaningfully overpriced, <0.8 = meaningfully underpriced
155
+
156
+ **IV Rank (IVR)**
157
+ ```
158
+ Formula: IVR = (Current IV - 52-Week Low IV) / (52-Week High IV - 52-Week Low IV) × 100
159
+
160
+ Example: Current IV 35%, 52-wk Low 20%, 52-wk High 60%
161
+ IVR = (35 - 20) / (60 - 20) × 100 = 37.5%
162
+
163
+ IVR Interpretation:
164
+ >70% Very High — IV near 52-week highs, strongly favor selling premium
165
+ 50-70% High — elevated IV, lean toward selling premium
166
+ 30-50% Moderate — mixed, direction-dependent strategies
167
+ <30% Low — IV near 52-week lows, favor buying premium or debit spreads
168
+ <15% Very Low — cheapest options of the year, consider long volatility
169
+ ```
170
+
171
+ **IV Percentile (IVP)**
172
+ - Definition: Percentage of trading days in the past 252 days where IV was lower than the current reading
173
+ - IVP 80% = IV is higher today than on 80% of trading days in the past year
174
+ - More statistically robust than IVR because IVR can be skewed by a single outlier high or low
175
+ - IVP > 50%: favor selling premium | IVP < 30%: favor buying premium
176
+
177
+ **IV Term Structure**
178
+ - **Contango (normal)**: Near-term IV < far-term IV — calm near-term environment, uncertainty longer-dated
179
+ - **Backwardation (inverted)**: Near-term IV > far-term IV — acute fear or event in immediate future
180
+ - Steep backwardation: market pricing major near-term risk (earnings miss, regulatory event, macro shock)
181
+ - Calendar spread opportunity: sell high near-term IV, buy lower far-term IV (take advantage of backwardation)
182
+
183
+ **IV Skew Analysis**
184
+ - **Put skew**: OTM put IV > OTM call IV — standard condition in equity markets (portfolio protection demand)
185
+ - **Steep negative skew**: Market pricing significant downside protection — fear elevated, consider selling OTM puts
186
+ - **Skew reversal (call skew)**: OTM call IV > OTM put IV — squeeze expectation, binary upside event anticipated
187
+ - **Risk reversal metric**: 25-delta put IV minus 25-delta call IV. Higher value = steeper put skew.
188
+ - Skew changes directionally: steepening skew = increasing fear, flattening skew = reducing downside concern
189
+
190
+ **Volatility Crush (Post-Event IV Collapse)**
191
+ - IV systematically rises into known binary events: earnings, FDA decisions, investor days, FOMC
192
+ - IV collapses immediately after the event as uncertainty resolves — regardless of the price move direction
193
+ - Average IV crush on earnings: 30-50% drop in IV on the day following announcement
194
+ - Implication: long premium strategies must have a move that exceeds the expected move to profit; short premium strategies profit even if stock moves, as long as within expected range
195
+
196
+ ### 4. Strategy Selector
197
+
198
+ Select the optimal strategy based on market outlook and IV environment:
199
+
200
+ **Bullish Strategies**
201
+
202
+ | Strategy | When to Use | IV Preference | Max Profit | Max Loss |
203
+ |----------|------------|---------------|------------|----------|
204
+ | Buy Call | Strongly bullish, conviction directional bet | Low IV (IVR <30%) | Unlimited | Premium paid |
205
+ | Bull Call Spread | Moderately bullish, reduce cost, cap profit | Any IV | Strike spread minus debit | Debit paid |
206
+ | Cash-Secured Put | Bullish/neutral, willing to own stock at lower price | High IV (IVR >50%) | Premium collected | Strike minus premium |
207
+ | Covered Call | Bullish/neutral, income on existing position | High IV (IVR >50%) | Premium + upside to strike | Stock cost minus premium |
208
+
209
+ **Bearish Strategies**
210
+
211
+ | Strategy | When to Use | IV Preference | Max Profit | Max Loss |
212
+ |----------|------------|---------------|------------|----------|
213
+ | Buy Put | Strongly bearish, protection or directional bet | Low IV (IVR <30%) | Strike minus premium | Premium paid |
214
+ | Bear Put Spread | Moderately bearish, reduce cost, define risk | Any IV | Strike spread minus debit | Debit paid |
215
+ | Bear Call Spread | Bearish/neutral, sell premium with defined max loss | High IV (IVR >50%) | Credit received | Strike spread minus credit |
216
+
217
+ **Neutral and Volatility Strategies**
218
+
219
+ | Strategy | When to Use | IV Preference | Max Profit | Max Loss |
220
+ |----------|------------|---------------|------------|----------|
221
+ | Iron Condor | Neutral price, range-bound | High IV (IVR >50%) | Full credit | Wing spread minus credit |
222
+ | Iron Butterfly | Neutral, max decay at single price point | High IV (IVR >50%) | Full credit | Wing spread minus credit |
223
+ | Short Straddle | Neutral, sell both call and put ATM | Very High IV | Full credit | Unlimited (uncapped) |
224
+ | Long Straddle | Expecting large move, unknown direction | Low IV (IVR <20%) | Unlimited | Both premiums paid |
225
+ | Long Strangle | Large move expected, OTM for lower cost | Low IV (IVR <20%) | Unlimited | Both premiums paid |
226
+
227
+ **Strategy Selection Matrix**
228
+
229
+ ```
230
+ IV High (IVR >50%) IV Low (IVR <20%)
231
+ ─────────────────────────────────────────────────────────────────────
232
+ Strongly Bullish: Bull Call Spread Buy Call
233
+ Mildly Bullish: Cash-Secured Put Bull Call Spread
234
+ Neutral: Iron Condor Long Straddle / Strangle
235
+ Mildly Bearish: Bear Call Spread Bear Put Spread
236
+ Strongly Bearish: Bear Put Spread Buy Put
237
+ High Volatility: Short Straddle Long Straddle
238
+ Low Conviction: Iron Condor Calendar Spread
239
+ ─────────────────────────────────────────────────────────────────────
240
+ ```
241
+
242
+ ### 5. Earnings Play Analysis
243
+
244
+ **IV Crush Dynamics**
245
+ - IV rises steadily in the 2-4 weeks before earnings as uncertainty increases
246
+ - On the day after earnings announcement, IV collapses 30-50% (volatility crush)
247
+ - This crush destroys long premium value even if the stock moves significantly
248
+ - Short premium strategies capture this crush but face the binary event risk
249
+
250
+ **Expected Move Calculation**
251
+ ```
252
+ Expected Move (EM) = ATM Straddle Price / Stock Price × 100
253
+
254
+ Example: Stock at $100, ATM straddle costs $7.00
255
+ Expected Move = 7.0 / 100 × 100 = 7.0%
256
+ Market implying 68% probability stock stays within +/-$7 of current price
257
+ ```
258
+
259
+ **Historical Earnings Move Analysis**
260
+ - Compare actual historical earnings moves vs. expected move at time of earnings
261
+ - If stock regularly moves ≥ 1.5x the expected move: favor buying straddle/strangle (breakeven likely exceeded)
262
+ - If stock regularly moves < 0.7x the expected move: favor selling premium (iron condor, short strangle)
263
+ - Look at last 8 quarterly earnings reactions for statistically meaningful sample
264
+
265
+ **Earnings Straddle Setup**
266
+ - Buy ATM call + ATM put with same strike and expiration just before earnings
267
+ - Profit if stock moves more than combined cost of both options (breakeven points = strike ± total premium)
268
+ - Risk: theta decay into earnings + IV crush if move is below expected move
269
+ - Optimal entry: 7-14 days before earnings (balances theta risk vs. IV run-up capture)
270
+
271
+ **Defined Risk Earnings Structures**
272
+ - **Long strangle**: OTM call + OTM put, cheaper than straddle, requires larger move to profit
273
+ - **Broken wing butterfly**: Define maximum risk, profit if stock pins near current level, smaller debit
274
+ - **Earnings iron condor**: Sell wings around expected move, profit if stock stays within range
275
+
276
+ ### 6. Risk Management
277
+
278
+ **Maximum Loss Scenarios by Strategy**
279
+ - Long call / Long put: Max loss = premium paid (100% of investment)
280
+ - Bull/Bear spread: Max loss = net debit paid
281
+ - Iron condor: Max loss = wing width minus total credit received
282
+ - Short straddle / strangle: Max loss = theoretically unlimited (capped by stock going to zero for puts)
283
+ - Covered call: Max loss = stock cost basis minus premium received (stock declining to zero)
284
+
285
+ **Position Sizing**
286
+ - Long options premium risk: limit to 2-5% of portfolio per trade (entire premium can be lost)
287
+ - Short premium, **defined-risk** (credit spreads, iron condors, iron butterflies): max loss = spread width − credit; size so that max loss is 1-3% of portfolio
288
+ - Short premium, **undefined-risk** (short straddles, short strangles, naked puts/calls): loss is not capped by a spread width — size on a stress loss instead: assume a 2-standard-deviation move (or the stock's worst historical earnings gap, whichever is larger) and keep that loss to 1-3% of portfolio; keep buying-power reduction under 20% of the account; and never carry an undefined-risk position through earnings without a pre-set exit level
289
+ - Never let a single options position represent more than 10% of total portfolio market value
290
+ - For speculative OTM long options: size even smaller (0.5-1%) given low probability of profit
291
+
292
+ **Delta Hedging for Complex Positions**
293
+ - Monitor portfolio delta daily for active options books
294
+ - Adjust underlying stock position to maintain target delta exposure (delta-neutral if desired)
295
+ - Frequency of hedging: daily for near-expiry positions, weekly for longer-dated positions
296
+ - Hedging costs: transaction costs erode gamma scalping profits; only hedge on meaningful delta drift
297
+
298
+ **Rolling Positions**
299
+ - When to roll: option approaching expiration with significant unrealized gain or at risk of assignment
300
+ - Rolling out: buy to close current expiration, sell to open further expiration (extends duration)
301
+ - Rolling out and up/down: change both expiration and strike
302
+ - Roll mechanics: attempt to collect additional credit (for short options) or minimal debit
303
+
304
+ **Stop-Loss Guidelines**
305
+ - Long options (debit): consider closing when position loses 50% of premium paid
306
+ - Short options (credit): consider closing when position reaches 2x the credit received (200% of max profit in losses)
307
+ - Hard rule: never let a defined-risk spread reach maximum loss without reassessment
308
+
309
+ **Common Mistakes to Avoid**
310
+ - Holding long OTM options to expiration hoping for recovery (usually expires worthless)
311
+ - Selling naked short puts or calls without understanding assignment risk
312
+ - Ignoring bid/ask spread in illiquid options (wide spread = immediate cost)
313
+ - Over-leveraging via too many contracts on speculative OTM options
314
+ - Forgetting earnings/ex-dividend dates that create event risk on existing positions
315
+
316
+ ### 7. Options Chain Reading Guide
317
+
318
+ **Key Chain Columns**
319
+ - **Bid / Ask**: Market-maker buy price and sell price — execute near midpoint for better fills
320
+ - **Last trade price**: Often stale; use bid/ask midpoint for current value
321
+ - **Volume**: Contracts traded today — high volume = active interest, easier to fill
322
+ - **Open Interest (OI)**: Total outstanding contracts — high OI = liquidity and tight spreads
323
+ - **IV per strike**: Varies by strike (shows skew visually across the chain)
324
+ - **Delta, Gamma, Theta, Vega**: Displayed per-contract for each strike
325
+
326
+ **Bid/Ask Spread Importance**
327
+ - Wide bid/ask spread = illiquid options = avoid or expect significant slippage
328
+ - Good liquidity threshold: bid/ask spread < 10% of option midprice
329
+ - Actively traded tickers (AAPL, SPY, QQQ): penny-wide spreads on ATM options
330
+ - Small-cap or low-volume stocks: may have $0.50+ spreads that erode profitability
331
+
332
+ **Open Interest Accumulation as Price Levels**
333
+ - Strikes with very high OI often act as price magnets (max pain theory) near expiration
334
+ - Institutional hedging clusters at round number strikes (every $5 or $10 increments)
335
+ - Dealer gamma exposure at high-OI strikes: dealers hedge dynamically, creating mechanical buying/selling pressure
336
+ - Max pain price: strike at which maximum total options value expires worthless
337
+
338
+ **Volume vs. OI Interpretation**
339
+ - Volume > OI: New positions being opened (not just rolls of existing positions)
340
+ - Volume << OI: Trading is closing or rolling existing positions
341
+ - Large single print on low-OI strike: new speculative or informed position (unusual activity alert)
342
+ - Volume spike with no news: potential informed positioning ahead of catalyst
343
+
344
+ ### 8. Data Sources
345
+
346
+ **Primary Trading Platforms with Full Greeks**
347
+ - **Thinkorswim (TD Ameritrade / Schwab)**: Comprehensive options chain, Greeks, IV analysis, probability cones
348
+ - **Interactive Brokers (IBKR)**: Options analytics, volatility trader tools, probability of expiring
349
+ - **Tastytrade**: Options-specific platform, IV rank/percentile, theta decay tracking
350
+
351
+ **Free Analytics Tools**
352
+ - **Market Chameleon**: IV rank, IV percentile, term structure, earnings IV history — all free
353
+ - **Barchart Options**: Options flow, unusual activity, Greeks by strike (free tier available)
354
+ - **Options Profit Calculator (optionsprofitcalculator.com)**: Visual P&L diagrams for strategies (free)
355
+ - **Power E*TRADE**: Options analytics and strategy builder
356
+
357
+ **Options Flow and Unusual Activity**
358
+ - **Unusual Whales**: Options flow tracking, dark pool data, unusual activity scanner
359
+ - **Flowalgo**: Real-time unusual options activity alerts (premium)
360
+ - **Cheddar Flow**: Institutional options flow visualization
361
+
362
+ **Reference Data**
363
+ - **Options Clearing Corporation (OCC)**: Volume and OI data, contract specifications
364
+ - **CBOE**: VIX data, volatility indices, SPX/SPY options data
365
+
366
+ ## Input Formats
367
+
368
+ ### Format 1: Greeks Analysis
369
+ ```
370
+ User: /options-analysis AAPL --greeks
371
+
372
+ Claude analyzes ATM and key strikes across near-term expirations, summarizes Greeks profile
373
+ ```
374
+
375
+ ### Format 2: Strategy Recommendation
376
+ ```
377
+ User: /options-analysis TSLA --strategy bullish
378
+
379
+ Claude evaluates current IV environment, selects optimal bullish strategies, provides specific setups
380
+ ```
381
+
382
+ ### Format 3: Earnings Play Analysis
383
+ ```
384
+ User: /options-analysis NVDA --earnings
385
+
386
+ Claude computes expected move, reviews historical earnings reactions, recommends earnings strategy
387
+ ```
388
+
389
+ ### Format 4: IV Analysis
390
+ ```
391
+ User: /options-analysis SPY --iv
392
+
393
+ Claude provides full IV analysis: IVR, IVP, term structure, skew, HV comparison
394
+ ```
395
+
396
+ ## Output
397
+
398
+ Provide a comprehensive options analysis report with the following sections:
399
+
400
+ ### 1. Options Overview
401
+ ```
402
+ Underlying: [TICKER]
403
+ Current Price: $XXX.XX
404
+ ATM Implied Volatility: XX.X%
405
+ IV Rank (IVR): XX% (52-wk Range: XX% - XX%)
406
+ IV Percentile (IVP): XX%
407
+ Historical Volatility: XX.X% (30-day realized)
408
+ IV vs. HV: X.Xx (Overpriced / Underpriced)
409
+ Next Earnings: [Date] (XX days)
410
+ ```
411
+
412
+ ### 2. Greeks Summary (ATM Nearest Expiry)
413
+ ```
414
+ Strike: $XXX Expiry: [Date] DTE: XX
415
+ ─────────────────────────────────────────
416
+ Call Greeks: Delta +X.XX | Gamma X.XX | Theta -$X.XX/day | Vega $X.XX/1%IV
417
+ Put Greeks: Delta -X.XX | Gamma X.XX | Theta -$X.XX/day | Vega $X.XX/1%IV
418
+ ─────────────────────────────────────────
419
+ Expected Move (±1σ to expiry): $X.XX (X.X%)
420
+ ```
421
+
422
+ ### 3. IV Analysis Summary
423
+ - IV vs. HV assessment (are options cheap or expensive?)
424
+ - IVR/IVP interpretation with action bias
425
+ - Term structure shape (contango vs. backwardation)
426
+ - Skew assessment and directional implication
427
+ - If near earnings: IV run-up remaining and expected crush magnitude
428
+
429
+ ### 4. Recommended Strategies (Top 2-3)
430
+
431
+ For each recommended strategy:
432
+ - Strategy name and structure (which strikes, which expiry)
433
+ - Rationale (why this strategy fits current IV and outlook)
434
+ - Max profit / Max loss
435
+ - Breakeven price(s)
436
+ - Probability of profit (from delta approximation)
437
+ - Ideal outcome scenario
438
+
439
+ ### 5. Key Levels for Options
440
+ - Strike clustering (high OI strikes = market-recognized levels)
441
+ - Support / resistance relevant to spread placement
442
+ - Max pain price for nearest monthly expiry
443
+
444
+ ### 6. Entry and Exit Guidelines
445
+ - Suggested entry timing (DTE target, IV condition to trigger entry)
446
+ - Profit target: close at X% of max profit (e.g., 50% for iron condors, 75% for short spreads)
447
+ - Stop-loss trigger
448
+ - Adjustment plan if position moves against you
449
+
450
+ ### 7. Upcoming Catalyst Calendar
451
+ - Earnings date and expected move (if applicable)
452
+ - Ex-dividend date (assignment risk for short calls)
453
+ - Any scheduled corporate events (investor day, product launch, FDA decision)
454
+
455
+ ## Standard Signal Output
456
+
457
+ All analysis concludes with this standardized block:
458
+
459
+ ```
460
+ ## Thesis Invalidation
461
+
462
+ After delivering the analysis signal, specify what would reverse it:
463
+
464
+ **If signal is BULLISH — thesis breaks if:**
465
+ - IV Rank drops below 10 suggesting complacency AND put/call ratio inverts bearishly
466
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
467
+
468
+ **If signal is BEARISH — thesis breaks if:**
469
+ - unusual call buying >3x average AND IV skew flips to call premium
470
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
471
+
472
+ **Re-run this analysis when:**
473
+ - [ ] Next earnings release
474
+ - [ ] Price moves ±15% from current level
475
+ - [ ] 60 days have elapsed
476
+ - [ ] Material news event (acquisition, leadership change, regulatory decision)
477
+
478
+ ╔══════════════════════════════════════════════╗
479
+ ║ INVESTMENT SIGNAL ║
480
+ ╠══════════════════════════════════════════════╣
481
+ ║ Signal: BULLISH / NEUTRAL / BEARISH ║
482
+ ║ Confidence: HIGH / MEDIUM / LOW ║
483
+ ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
484
+ ║ Score: X.X / 10 ║
485
+ ╠══════════════════════════════════════════════╣
486
+ ║ Action: BUY / HOLD / SELL ║
487
+ ║ Conviction: STRONG / MODERATE / WEAK ║
488
+ ╚══════════════════════════════════════════════╝
489
+ ```
490
+
491
+ Score Guide: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish
492
+ Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
493
+ Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
494
+
495
+ **Disclaimer:** Educational analysis only. Not financial advice.