volatility-surface-analyzer

Compare realized and implied volatility to produce IV rank, vol cones, term structure, and VRP signals.

10|2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/mahmoud20138/Tradecraft --skill volatility-surface-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: volatility-surface-analyzer
Source: https://github.com/mahmoud20138/Tradecraft/tree/main/plugins/tradecraft/skills/volatility-surface-analyzer
Command: npx skills add https://github.com/mahmoud20138/Tradecraft --skill volatility-surface-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps traders analyze volatility dynamics by comparing realized and implied volatility to uncover mispricing and risk in options markets.

Core Features & Use Cases

  • Realized volatility engine: compute multi-window realized vol to benchmark options pricing.
  • Volatility cone & IV metrics: assess current IV against historical distributions, including IV rank/percentile.
  • IV term structure analysis: evaluate contango/backwardation to inform risk management and strategy selection.
  • VRP and regime signals: derive variance risk premium and volatility regime insights for tactical decisions.

Quick Start

Provide historical return data and option IVs to generate a volatility surface and IV signals for your assets.

Frequently Asked Questions about volatility-surface-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare realized and implied volatility to find options mispricing?

To find options mispricing, compare realized and implied volatility to calculate the variance risk premium, exposing where options are overpriced or underpriced. This requires historical return data and option IVs to derive multi-window realized vol and VRP signals.

What is an IV rank and how does it assess current implied volatility?

An IV rank assesses current implied volatility against historical distributions, calculating where current IV stands relative to its past range. It uses volatility cones to evaluate whether options are cheap or expensive across asset classes and expiries.

How do I calculate variance risk premium for tactical trading decisions?

Calculate variance risk premium by subtracting realized volatility from implied volatility to expose mispricing and risk in options. This derives VRP and volatility regime insights for tactical decisions, requiring historical return data and option IVs.

How do I analyze IV term structure for contango and backwardation?

Analyze IV term structure by evaluating contango or backwardation across expiries to inform risk management and strategy selection. Apply this across asset classes to expose mispricing and risk in options markets using historical option IVs.

What data do I need to generate a volatility surface and IV signals?

To generate a volatility surface and IV signals, provide historical return data and option IVs, optionally including price series. These inputs produce structured results including IV rank, vol cones, term structure, and VRP insights.

When should I use a volatility cone for risk management?

Use a volatility cone for risk management to assess current implied volatility against historical distributions across multiple windows. It exposes mispricing and risk in options by benchmarking current IV against realized volatility dynamics.