copula-modeling

Simulates correlated prediction market outcomes using Gaussian, Student-t, Clayton, and Gumbel copulas.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill copula-modeling-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: copula-modeling
Source: https://github.com/travis-burmaster/agentbox/tree/main/examples/llm-proxy-gitagent/workspace/skills/copula-modeling
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill copula-modeling-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, scipy.

What problem does it solve? Correlation matrices alone cannot capture tail dependence, so portfolios of correlated prediction market contracts underestimate the probability of extreme joint outcomes like sweeping or losing every swing state. ## Core Features & Use Cases - Copula Simulation: Implements Gaussian, Student-t, and Clayton copulas in Python with NumPy and SciPy to generate correlated binary outcomes from marginal probabilities. - Tail Dependence Quantification: Compares joint sweep and loss probabilities across copula families, showing how Student-t copulas produce 2-5x higher extreme outcome probabilities than Gaussian. - Vine Copula Guidance: Covers C-vine, D-vine, and R-vine decompositions for portfolios with more than five contracts, plus a copula selection guide by scenario. - Use Case: Model a five-state election portfolio (PA, MI, WI, GA, AZ) with a Student-t copula to correctly price the probability of a full sweep that a Gaussian copula would treat as nearly impossible. ## Quick Start Ask the agent to simulate the joint probability of all five swing states resolving the same way using a Student-t copula with the given marginal probabilities and correlation matrix.

Frequently Asked Questions about copula-modeling

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

FAQPage Schema
How do I simulate correlated binary outcomes with a copula in Python?

Draw correlated normals via Cholesky decomposition of the correlation matrix, transform to uniforms with the copula's CDF, then threshold against each market's marginal probability. The skill provides working NumPy and SciPy implementations for Gaussian, Student-t, and Clayton copulas.

Gaussian copula vs Student-t copula for correlated markets?

Gaussian copulas have zero tail dependence, assigning zero probability to extreme co-movements. A Student-t copula with nu=4 and rho=0.6 gives roughly 0.18 tail dependence, typically producing 2-5x higher probabilities of joint extreme outcomes.

Which copula should I use for crash contagion scenarios?

Use a Clayton copula with theta between 1 and 5, which has lower tail dependence only (lambda_L = 2^{-1/theta}). For joint positive resolutions use Gumbel, and for symmetric fat tails use Student-t with nu between 3 and 6.

How do I model dependence across more than five contracts?

Use vine copulas, which decompose a d-dimensional dependency into d(d-1)/2 bivariate conditional copulas arranged in trees. Build maximum spanning trees ordered by Kendall's tau, select pair-copula families via AIC, and use pyvinecopulib or the R VineCopula package.

Why did Gaussian copulas fail in the 2008 financial crisis?

Gaussian copulas model tail dependence as zero, so joint extreme events were priced as essentially impossible. When correlated defaults clustered in 2008, portfolios built on Gaussian assumptions collapsed precisely in the tail scenarios the model excluded.