analyzing-volatility-surfaces

Constructs and interprets implied volatility surfaces with skew analysis and term structure assessment. Use when analyzing vol surfaces, interpreting skew, or modeling volatility dynamics.

11 stars

Best use case

analyzing-volatility-surfaces is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Constructs and interprets implied volatility surfaces with skew analysis and term structure assessment. Use when analyzing vol surfaces, interpreting skew, or modeling volatility dynamics.

Teams using analyzing-volatility-surfaces should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/analyzing-volatility-surfaces/SKILL.md --create-dirs "https://raw.githubusercontent.com/CaseMark/skills/main/skills/finance/analyzing-volatility-surfaces/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/analyzing-volatility-surfaces/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How analyzing-volatility-surfaces Compares

Feature / Agentanalyzing-volatility-surfacesStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Constructs and interprets implied volatility surfaces with skew analysis and term structure assessment. Use when analyzing vol surfaces, interpreting skew, or modeling volatility dynamics.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Analyzing Volatility Surfaces

## When To Use

- Constructing an implied volatility surface from option chain data across strikes and expirations
- Analyzing skew dynamics (put skew, call skew, smile shape) for a single underlier or cross-asset comparison
- Evaluating term structure of volatility for calendar spread positioning or structured product pricing
- Identifying vol surface anomalies that signal mispricing, liquidity dislocations, or event risk
- Supporting pricing or risk review of exotic/structured products that depend on vol surface interpolation

## Inputs To Gather

- **Option chain data**: Bid/ask implied vols (or prices to back-solve) across strikes and expirations; specify underlier (equity index, single stock, FX pair, commodity)
- **Underlier spot/forward**: Current spot price, dividend yield or carry assumptions, and forward curve if available
- **Expiration set**: Which tenors to include (e.g., weekly, monthly, quarterly, LEAPS); confirm whether to use listed expirations or interpolated constant-maturity tenors
- **Strike convention**: Absolute strike, moneyness (K/S), delta-space, or log-moneyness — confirm which convention to use for surface construction
- **Model context**: Whether surface is for mark-to-market, exotic pricing (local vol, stochastic vol), or relative value analysis
- **Reference date and market hours**: As-of date/time for the snapshot; whether to use settlement vols or intraday marks

## Workflow

1. **Validate and clean input data**
   - Filter out stale quotes, zero-volume strikes, and obvious bad ticks (e.g., implied vol < 1% or > 300%)
   - Flag wide bid/ask spreads — use mid-market only when spread is within acceptable threshold [VERIFY: firm-specific threshold]
   - Confirm put-call parity consistency; reconcile any violations by adjusting forward/dividend assumptions

2. **Construct the raw surface**
   - Map implied vols onto a strike × expiration grid using the chosen strike convention
   - For each expiration slice, fit a parametric curve (SVI, SABR, or cubic spline) or use raw market points
   - Interpolate across tenors to fill gaps — use variance-linear interpolation (total variance = σ²·T should increase monotonically in T)
   - Check for calendar spread arbitrage: total variance must be non-decreasing in maturity at every strike
   - Check for butterfly arbitrage: the local variance surface must produce non-negative probability densities

3. **Analyze skew**
   - Compute 25-delta risk reversal (25d call vol − 25d put vol) and 25-delta butterfly (average of 25d wings − ATM vol) for each tenor
   - Measure skew slope: dσ/dK or dσ/d(log-moneyness) around ATM
   - Compare current skew level to historical distribution (percentile rank over 1Y, 3Y windows)
   - Identify skew regime: steep/flat relative to realized skewness of returns, demand-driven vs. fundamental

4. **Analyze term structure**
   - Plot ATM vol across tenors; identify contango (upward-sloping) vs. backwardation (inverted)
   - Calculate vol carry: ATM implied vol minus short-dated realized vol at each tenor point
   - Flag event-driven kinks (earnings, FOMC, expiration clustering) that create localized term structure humps
   - Compare term structure shape to historical norms and cross-asset benchmarks

5. **Assess surface dynamics and Greeks exposure**
   - Estimate vega, vanna (dVega/dSpot), and volga (dVega/dVol) profiles across the surface
   - Identify regions of high convexity or sensitivity relevant to the portfolio or trade under review
   - If for exotic pricing: note where local vol or stochastic vol model choice materially affects valuation (e.g., barriers near skew-sensitive strikes)

6. **Synthesize findings**
   - Summarize surface shape, skew regime, and term structure posture
   - Highlight actionable observations: relative value opportunities, mispriced strikes, or risk concentrations
   - Flag any data quality issues or model-dependent conclusions

## Output

- **Surface summary table**: ATM vols, 25d RR, 25d BF for each tenor
- **Skew analysis section**: Current skew metrics with historical percentile context; skew slope chart data
- **Term structure section**: ATM vol curve, vol carry estimates, event-adjusted term structure
- **Arbitrage check results**: Calendar and butterfly arbitrage flags with specific strike/tenor locations
- **Key findings and trade implications**: 3–5 bullet points with actionable takeaways
- **Data quality notes**: Stale quotes excluded, wide-spread strikes flagged, parity violations observed

## Quality Checks

- Total variance is monotonically non-decreasing in maturity at every strike (no calendar arbitrage)
- Butterfly spreads produce non-negative payoffs at all points (no butterfly arbitrage)
- Interpolated surface reproduces input market quotes within bid/ask tolerance
- Strike convention and delta convention are applied consistently — do not mix sticky-strike and sticky-delta frameworks without explicit notation
- Skew and term structure metrics are compared to correct historical benchmarks (same underlier, same convention) [VERIFY: data source for historical vol percentiles]
- All implied vols are derived using the correct exercise style (American vs. European) and dividend treatment for the underlier [VERIFY: exercise convention for specific product]
- Mark any model-dependent conclusions (e.g., local vol extrapolation beyond liquid strikes) with explicit caveats

Related Skills

analyzing-vital-statistics

11
from CaseMark/skills

Structures vital records analysis with birth, death, and demographic trend reporting. Use when analyzing vital statistics, interpreting mortality data, or reporting demographic trends.

analyzing-social-determinants-of-health

11
from CaseMark/skills

Maps social determinants affecting health outcomes with intervention strategy development. Use when analyzing SDOH, mapping community resources, or designing social health interventions.

analyzing-pharmacovigilance-data

11
from CaseMark/skills

Structures post-marketing safety surveillance with signal detection and PSUR reporting. Use when analyzing safety signals, preparing PSURs, or managing pharmacovigilance data.

analyzing-flow-cytometry

11
from CaseMark/skills

Interprets flow cytometry panels for hematologic malignancy classification and minimal residual disease. Use when analyzing flow cytometry, classifying lymphomas/leukemias, or documenting immunophenotyping.

analyzing-epidemiological-data

11
from CaseMark/skills

Structures epidemiologic analysis with incidence, prevalence, rate calculations, and statistical inference. Use when calculating disease rates, analyzing epi data, or interpreting population statistics.

analyzing-clinical-trial-data

11
from CaseMark/skills

Structures clinical trial data analysis with primary endpoint evaluation and safety reporting. Use when analyzing trial results, evaluating endpoints, or preparing statistical reports.

analyzing-clinical-data-warehouses

11
from CaseMark/skills

Structures clinical data warehouse queries for quality measurement, research, and operational analytics. Use when querying clinical data, building analytics reports, or extracting research datasets.

analyzing-yield-curves

11
from CaseMark/skills

Interprets yield curve shapes with term structure analysis and relative value identification. Use when analyzing yield curves, identifying curve trades, or interpreting interest rate expectations.

analyzing-wealthtech-platforms

11
from CaseMark/skills

Evaluates wealth management technology with robo-advisory models, digital planning, and fee analysis. Use when analyzing wealthtech, evaluating robo-advisors, or assessing digital wealth platforms.

analyzing-water-risk

11
from CaseMark/skills

Structures water risk assessment with water stress mapping, usage analysis, and regulatory exposure evaluation. Use when analyzing water risk, mapping water stress, or evaluating water-related financial exposure.

analyzing-venture-deal-terms

11
from CaseMark/skills

Evaluates VC term sheet provisions with economic and control analysis and cap table impact. Use when analyzing term sheets, negotiating deal terms, or modeling cap table outcomes.

analyzing-variance-swaps

11
from CaseMark/skills

Structures variance and volatility swap pricing with realized/implied vol analysis and hedging. Use when pricing variance swaps, analyzing vol risk premium, or hedging volatility exposure.