$npx skillfedfor your agent

historical-risk

Quantify how risky an investment has been using historical price data. This skill computes annualized volatility, maximum drawdown, recovery time, historical VaR, downside deviation, and tracking error—supporting multiple volatility estimators including Parkinson and Yang-Zhang methods. Use it to analyze peak-to-trough losses and asymmetric downside risk.

historical-risk quantifies realized volatility and drawdown from past price data using multiple estimators and downside metrics.

AI-generated summary based on this skill's SKILL.md

159 32 MITupdated by JoelLewis

Decision gist · record as of 2026-07-18

historical-risk quantifies realized volatility and drawdown from past price data using multiple estimators and downside metrics. Quantify how risky an investment has been using historical price data. This skill computes annualized volatility, maximum drawdown, recovery time, historical VaR, downside deviation, and tracking error—supporting multiple volatility estimators including Parkinson and Yang-Zhang methods. Use it to analyze peak-to-trough losses and asymmetric downside risk.

manual: git clone https://github.com/JoelLewis/finance_skills → cp -r finance_skills/plugins/wealth-management/skills/historical-risk ~/.claude/skills/historical-risk
plugins/wealth-management/skills/historical-risk/SKILL.md · version bece6a5b

Use it when

  • historical-risk analyzes maximum drawdown as the peak-to-trough decline from the highest portfolio value to its lowest subsequent point.
  • historical-risk computes historical Value at Risk (VaR) by analyzing past returns to estimate losses at a given confidence level (e.g.

Verify before relying

Read SKILL.md below before installing (2 files). Open directory: indexed for reading, not audited.

Same gist for agents: .md · .json

Install

JoelLewis/finance_skills/historical-risk · repository language: Python

Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How to calculate historical volatility with historical-risk?

historical-risk computes annualized volatility from past price data using log returns and standard deviation. It supports multiple estimators: standard deviation from daily returns, Parkinson's high-low method for intraday volatility, and Yang-Zhang's range-based approach. Choose the method that best fits your data frequency and asset class.

What is maximum drawdown and how does historical-risk measure it?

historical-risk analyzes maximum drawdown as the peak-to-trough decline from the highest portfolio value to its lowest subsequent point. The skill also calculates recovery time—how long it took to return to the previous peak—and drawdown duration, giving you a complete picture of worst historical declines and the time needed to recover.

How does historical-risk calculate historical VaR and downside risk?

historical-risk computes historical Value at Risk (VaR) by analyzing past returns to estimate losses at a given confidence level (e.g., 95%). It also measures downside deviation and semi-variance, which focus only on returns below a threshold, capturing asymmetric downside risk that standard volatility misses.

Can historical-risk compare my portfolio performance to a benchmark?

Yes. historical-risk calculates tracking error—the standard deviation of differences between your portfolio returns and benchmark returns. This metric shows how much your portfolio deviates from its benchmark, helping you assess active management risk and consistency relative to your chosen index.

What advanced volatility estimators does historical-risk support?

historical-risk supports Parkinson's estimator, which uses high-low price ranges for efficient intraday volatility estimation, and Yang-Zhang's volatility estimator, which combines overnight gaps and intraday ranges. These advanced methods are particularly useful for assets with significant intraday trading ranges or overnight gaps.

How risky has an investment been using historical-risk analysis?

historical-risk quantifies realized investment risk by combining multiple metrics: annualized volatility shows price variability, maximum drawdown reveals worst-case losses, recovery time indicates resilience, and historical VaR estimates tail risk. Together, these metrics provide a comprehensive view of how risky the investment has been historically.

SKILL.md

Rendered from the published skill. Quoted content, verbatim.

Historical Risk Analysis

Core Concepts

Close-to-Close Volatility

The simplest and most common volatility estimator. Compute the standard deviation of log returns and annualize.

sigma_annual = sigma_daily * sqrt(N)

where N = number of trading periods per year (typically 252 for daily, 52 for weekly, 12 for monthly).

Log returns are preferred: r_t = ln(P_t / P_{t-1}).

Parkinson (High-Low) Estimator

Uses intraday high and low prices to capture intraday volatility that close-to-close misses. More efficient than close-to-close when the true process is continuous.

``` sigma^2_Park = (1 / (4 * n * ln(2))) * sum( ln(H_i /

(truncated - see the full file via the links below)

File tree — 2 files
plugins/wealth-management/skills/historical-risk/SKILL.md
plugins/wealth-management/skills/historical-risk/scripts/historical_risk.py

Let your AI agent find skills like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.

wish › “Quantify historical volatility and realized risk from past price data”

Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →

Related skills

volatility
by HKUDS · HKUDS/Vibe-Trading

This strategy captures volatility mean reversion by computing annualized historical volatility and ranking it percentile-wise over a lookback period. Long signals trigger when volatility sits in the low percentile range, positioning for expansion; short or exit signals fire when volatility ranks high, betting on contraction. Works with any OHLCV data across equities and crypto.

MITupdated Jul 2026
★ 28,096repo stars
performance-metrics
by JoelLewis · JoelLewis/finance_skills

Compute and interpret industry-standard risk-adjusted performance metrics for investment analysis. This skill covers Sharpe ratio, Sortino ratio, Information ratio, Treynor ratio, Calmar ratio, Omega ratio, and capture ratios—each designed to measure returns relative to different types of risk. Use it to compare funds, assess manager skill, and understand whether volatility is justified by returns.

MITupdated Jul 2026
★ 159repo stars
risk-analysis
by HKUDS · HKUDS/Vibe-Trading

Risk-analysis provides quantitative methods for measuring portfolio risk through Value at Risk, Conditional Value at Risk, maximum drawdown analysis, and Monte Carlo simulation. It includes historical and parametric VaR calculation, tail-risk analysis via extreme value theory, and stress-testing frameworks using both historical scenarios and hypothetical shock models.

MITupdated Jul 2026
★ 28,096repo stars
volatility-modeling
by JoelLewis · JoelLewis/finance_skills

This skill teaches time-series volatility modeling and options-market approaches to quantify and predict market uncertainty. Learn EWMA and GARCH frameworks for volatility forecasting, understand implied volatility extraction from option prices, and interpret volatility smile, skew, and term structure patterns. Use it to calculate volatility risk premiums, analyze the VIX, and support derivatives pricing and portfolio hedging decisions.

MITupdated Jul 2026
★ 159repo stars
statistics-fundamentals
by JoelLewis · JoelLewis/finance_skills

Analyze financial return series with descriptive statistics, normality tests, and covariance estimation. Run CAPM regressions with significance testing, apply Ledoit-Wolf shrinkage for stable portfolio optimization, and bootstrap confidence intervals for statistics without clean analytical solutions.

MITupdated Jul 2026
★ 159repo stars
performance-reporting
by JoelLewis · JoelLewis/finance_skills

Performance Reporting builds comprehensive investment reports showing returns across standard periods, benchmark comparisons, and risk metrics. It handles time-weighted and money-weighted calculations, GIPS-compliant composites, and goal progress tracking with visualizations like growth charts and drawdown analysis.

MITupdated Jul 2026
★ 159repo stars

More skills forward-risk (MIT) · portfolio-analytics (MIT) · options-strategy (MIT) · retirement-decumulation (MIT) · drawdown-circuit-breaker (MIT) · volatility-modeling (MIT) · performance-attribution (MIT)

Tags
realized-riskdownside-metricspeak-to-troughvolatility-estimatorshistorical-analysisrisk-quantificationdrawdown-recoverytail-risk