Skip to content
cccskills
FreePublished on GitHub

options-payoff

Visualize an options position with an interactive chart showing profit and loss at expiry alongside model-based values. Adjust strike prices, premiums, volatility, and time remaining to explore profit zones, potential losses, and breakeven prices.

OriginalShow the original description

Render an interactive options payoff chart — expiry P&L plus Black-Scholes theoretical value — with sliders for strikes, premium, IV, DTE, and spot. Use this skill whenever the user describes or shares an options position or strategy and wants to see how it makes or loses money: vertical, calendar, diagonal, or ratio spreads, butterflies, condors and iron condors, straddles, strangles, covered calls, protective or naked puts, or any multi-leg structure. This includes pasted strikes, premiums, and expiries, requests like "show me the payoff" or "draw the P&L curve", and broker screenshots (IBKR, TastyTrade, Robinhood). Use it even when details are partial — defaults fill the gaps.

See how to install

Good for

  • Visualizing profit and loss from a broker screenshot
  • Comparing outcomes across option strike prices
  • Exploring changes in volatility and time to expiry
  • Checking breakeven prices for multi-leg strategies

Files included (4)

  • SKILL.md7.7 KB
  • README.md2.0 KB
  • references/bs_code.md2.1 KB
  • references/strategies.md4.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Options Payoff Curve Skill

If your host has not already executed the shell probes below (for example, in Codex), run the commands inside the ! wrappers with its shell tool before choosing a setup path. Use the actual output; if shell access is unavailable, report that limitation.

Generates an interactive HTML chart using the host's available visualization tool, or a standalone HTML file in Codex, showing:

  • Expiry payoff curve (dashed gray line) — intrinsic value at expiration
  • Theoretical value curve (solid colored line) — Black-Scholes price at current DTE/IV
  • Dynamic sliders for all key parameters
  • Real-time stats: max profit, max loss, breakevens, current P&L at spot

Step 1: Extract Strategy From User Input

When the user provides a screenshot or text, extract:

FieldWhere to find itDefault if missing
Strategy typeTitle bar / leg description"custom"
UnderlyingTicker symbolSPX
Strike(s)K1, K2, K3... in title or leg tablenearest round number
Premium paid/receivedFilled price or avg price5.00
QuantityPosition size1
Multiplier100 for equity options, 100 for SPX100
ExpiryDate in title30 DTE
Spot priceCurrent underlying price shown in the screenshot or textlive quote (see below); middle strike only if no quote is available
IVShown in greeks panel, or estimate from vega20%
Risk-free rate—4.3%

Spot for screenshots: spot is the underlying's current price, and broker screenshots often omit it or show it far from the strikes — don't read it off the strike labels. Use the price shown, else a live quote (the SPX probe below, or yfinance for other underlyings). Fall back to the middle strike only when no quote is available, and tell the user you did.

Current SPX reference price:

!`python3 -c "exec('try:\n import yfinance as yf\n p=yf.Ticker(\'^GSPC\').fast_info[\'lastPrice\']\n print(f\'SPX ≈ {p:.0f}\')\nexcept Exception:\n print(\'SPX price unavailable — check market data\')')"`

Step 2: Identify Strategy Type

Match to one of the supported strategies below, then read the corresponding section in references/strategies.md.

StrategyLegsKey Identifiers
butterflyBuy K1, Sell 2×K2, Buy K33 strikes, "Butterfly" in title
vertical_spreadBuy K1, Sell K2 (same expiry)2 strikes, debit or credit
calendar_spreadBuy far-expiry K, Sell near-expiry KSame strike, 2 expiries
iron_condorSell K2/K3, Buy K1/K4 wings4 strikes, 2 spreads
straddleBuy Call K + Buy Put KSame strike, both types
strangleBuy OTM Call + Buy OTM Put2 strikes, both OTM
covered_callLong 100 shares + Sell Call KStock + short call
naked_putSell Put KSingle leg
ratio_spreadBuy 1×K1, Sell N×K2Unequal quantities

For strategies not listed, use custom mode: decompose into individual legs and sum their P&Ls.


Step 3: Compute Payoffs

Black-Scholes Put Price

d1 = (ln(S/K) + (r + σ²/2)·T) / (σ·√T)
d2 = d1 - σ·√T
put = K·e^(-rT)·N(-d2) - S·N(-d1)

Black-Scholes Call Price (via put-call parity)

call = put + S - K·e^(-rT)

Butterfly Put Payoff (expiry)

if S >= K3: 0
if S >= K2: K3 - S
if S >= K1: S - K1
else: 0

Net P&L per share = payoff − premium_paid

Vertical Spread (call debit) Payoff (expiry)

long_call = max(S - K1, 0)
short_call = max(S - K2, 0)
payoff = long_call - short_call - net_debit

Calendar Spread Theoretical Value

Calendar cannot be expressed as a simple expiry function — always use BS pricing for both legs:

value = BS(S, K, T_far, r, IV_far) - BS(S, K, T_near, r, IV_near)

For expiry curve of calendar: near leg expires worthless, far leg = BS with remaining T.

Iron Condor Payoff (expiry)

put_spread = max(K2-S, 0) - max(K1-S, 0)   // short put spread
call_spread = max(S-K3, 0) - max(S-K4, 0)  // short call spread
payoff = credit_received - put_spread - call_spread

Step 4: Render the Widget

When visualize:read_me is available, read modules ["chart", "interactive"] before building and use visualize:show_widget to render. Otherwise use an available host visualization tool according to its documented interface. In Codex without an inline renderer, save a complete HTML document in the workspace, include the chart dependencies and CSS, verify it in a browser when available, and return a clickable file link. Preserve all controls and calculations below. Do not call tools that the host does not expose.

Required Controls (sliders)

Structure section:

  • All strike prices (K1, K2, K3... as needed by strategy)
  • Premium paid/received
  • Quantity
  • Multiplier (100 default, show for clarity)

Pricing variables section:

  • IV % (5–80%, step 0.5)
  • DTE — days to expiry (0–90)
  • Risk-free rate % (0–8%)

Spot price:

  • Full-width slider, range = [min_strike - 20%, max_strike + 20%], defaulting to ACTUAL current spot

Required Stats Cards (live-updating)

  • Max profit (expiry)
  • Max loss (expiry)
  • Breakeven(s) — show both for two-sided strategies
  • Current theoretical P&L at spot

Chart Specs

  • X-axis: SPX/underlying price
  • Y-axis: Total USD P&L (not per-share)
  • Blue solid line = theoretical value at current DTE/IV
  • Gray dashed line = expiry payoff
  • Green dashed vertical = strike prices (K2 center strike brighter)
  • Amber dashed vertical = current spot price
  • Fill above zero = green 10% opacity; below zero = red 10% opacity
  • Tooltip: show both curves on hover

Code template

Use this JS structure inside the widget, adapting pnlExpiry() and bfTheory() per strategy:

// Black-Scholes helpers (always include)
function normCDF(x) { /* Horner approximation */ }
function bsCall(S,K,T,r,sig) { /* standard BS call */ }
function bsPut(S,K,T,r,sig) { /* standard BS put */ }

// Strategy-specific expiry payoff (returns per-share value BEFORE premium)
function expiryValue(S, ...strikes) { ... }

// Strategy-specific theoretical value using BS
function theoreticalValue(S, ...strikes, T, r, iv) { ... }

// Main update() reads all sliders, computes arrays, destroys+recreates Chart.js instance
function update() { ... }

// Attach listeners
['k1','k2',...,'iv','dte','rate','spot'].forEach(id => {
  document.getElementById(id).addEventListener('input', update);
});
update();

Step 5: Respond to User

After rendering the widget, briefly explain:

  1. What strategy was detected and how legs were mapped
  2. Max profit / max loss at current settings
  3. One key insight (e.g., "spot is currently 950 pts below the profit zone, expiring tomorrow")

Keep it concise — the chart speaks for itself.


Reference Files

  • references/strategies.md — Detailed payoff formulas and edge cases for each strategy type
  • references/bs_code.md — Copy-paste ready Black-Scholes JS implementation with normCDF

Read the relevant reference file if you're unsure about payoff formula edge cases for a given strategy.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Estimate a public company's value using projected cash flows, peer comparisons, and separate business segments where applicable. Produce an implied share price, compare it with the market price, and show how different assumptions change the result.

  • Estimating a company's fair share price
  • Comparing valuation multiples with industry peers
  • Testing how growth and discount rates affect value
himself65/finance-skills3.4KUpdated Oct 19, 2026

discord-reader

FreeSummary

Read and search Discord discussions for financial research through opencli. Review servers, channels, members, and recent messages, then organize comments about stocks or crypto by topic, attribution, and bullish or bearish views.

  • Reviewing recent posts in a market discussion channel
  • Searching Discord conversations about a stock or coin
  • Checking available servers, channels, and online members
himself65/finance-skills3.4KUpdated Oct 19, 2026

earnings-preview

FreeSummary

Prepare a briefing before a company's earnings report using Yahoo Finance data. Review the reporting schedule, expected earnings and revenue, past results versus forecasts, analyst views, and company-specific points to watch.

  • Preparing for an upcoming earnings report
  • Checking earnings and revenue forecast ranges
  • Comparing past earnings with analyst estimates
himself65/finance-skills3.4KUpdated Oct 19, 2026

earnings-recap

FreeSummary

Review a company's latest or specified past earnings report using Yahoo Finance data. Compare earnings per share with estimates, examine revenue and profit margins, and measure the stock's price reaction against previous earnings moves.

  • Check whether reported earnings beat estimates
  • Review quarterly revenue and profit margin trends
  • Compare the stock reaction with earlier earnings reports
himself65/finance-skills3.4KUpdated Oct 19, 2026

Analyze company earnings and revenue forecasts using Yahoo Finance data. Compare analyst consensus, meaning their combined expectations, across periods, track upward and downward revisions, assess forecast ranges, and review how past estimates compared with actual results.

  • Tracking changes in earnings forecasts
  • Comparing optimistic and pessimistic estimates
  • Comparing growth forecasts with industry benchmarks
himself65/finance-skills3.4KUpdated Oct 19, 2026

etf-premium

FreeSummary

Calculate how far an ETF’s market price sits above or below its net asset value, the value of its holdings. Compare funds, screen for large gaps, and investigate sudden moves using holdings data and options-based estimates.

  • Check an ETF’s price gap relative to its net asset value
  • Compare premiums and discounts across similar ETFs
  • Screen ETFs for unusually large price gaps
himself65/finance-skills3.4KUpdated Oct 19, 2026

See all skills by himself65

Report a problem with this skill