Skip to main content
ClaudeWave
Skill12k repo starsupdated today

geopolitical-risk

This Claude Code skill quantifies geopolitical risk across three layers (structural, situational, event) and assesses crisis impact through five dimensions: intensity, persistence, transmission, predictability, and reversibility. It monitors six major hotspots including the Strait of Hormuz and provides event-driven asset allocation strategies by converting geopolitical narratives into tradeable signals using indicators like the GPR Index, CDS spreads, and commodity futures curves. Use this tool to identify war, sanctions, and supply disruption scenarios and their multi-asset portfolio consequences.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/HKUDS/Vibe-Trading /tmp/geopolitical-risk && cp -r /tmp/geopolitical-risk/agent/src/skills/geopolitical-risk ~/.claude/skills/geopolitical-risk
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Geopolitical Risk Analysis

## Overview

Quantify geopolitical risk signals, identify crisis precursors, and build event-driven strategies that convert narratives such as "war / conflict / sanctions / supply disruption" into actionable multi-asset allocation decisions.

---

## Core Analytical Framework

### 1. Risk Layering Model

```
Layer 1: Structural risk (long-lasting, slow-moving)
  └── Great-power rivalry, alliance structures, nuclear deterrence balance

Layer 2: Situational risk (cyclical escalation, monthly / quarterly scale)
  └── Military exercises, election cycles, sanctions escalation, diplomatic friction

Layer 3: Event risk (sudden shocks, daily / hourly scale)
  └── Military action, assassination, sanctions announcements, nuclear tests
```

### 2. Five Dimensions of Risk Assessment

| Dimension | Description | Quantitative Proxy |
|------|------|-------------|
| **Intensity** | Severity of conflict / sanctions | GPR Index percentile |
| **Persistence** | Expected duration of the crisis | Futures curve contango / backwardation |
| **Transmission** | Spillover into supply chains / finance | CDS spread widening, VIX jump magnitude |
| **Predictability** | Whether the event is already priced in | Option implied volatility skew |
| **Reversibility** | Whether the situation can be resolved through negotiation | Speed of reversal in news sentiment |

---

## Monitoring the Six Major Global Geopolitical Hotspots

### 1. Strait of Hormuz — Oil Transport Chokepoint

**Strategic significance**
- Roughly 20% of global oil supply (about 17 million barrels/day) and 20% of LNG passes through it
- Iran has the ability to disrupt the strait through mines, naval assets, and shore-based missiles
- It is the only export route for Gulf states such as Saudi Arabia, the UAE, Kuwait, and Iraq

**Risk triggers**
- Escalation in U.S.-Iran tensions, such as failed nuclear talks or tighter sanctions
- Tankers being seized or attacked
- Iranian blockade drills during military exercises

**Key monitoring indicators**
```python
# Proxy indicators
- Brent-WTI spread widening (signal of regional supply stress)
- Persian Gulf tanker insurance rates (Lloyd's H&M quotes)
- UAE dirham NDF (depreciates under stress)
- Israeli shekel volatility
- Relative strength of VanEck Oil Services ETF (OIH) vs XLE
```

**Asset impact direction**
- Bullish: crude oil, LNG, shipping stocks (BDRY/FRO), defense stocks (LMT/RTX)
- Bearish: airlines (DAL/UAL), petrochemical refiners, emerging-market importers such as INR and KRW

---

### 2. Taiwan Strait — Core of the Semiconductor Supply Chain

**Strategic significance**
- TSMC accounts for roughly 90% of global advanced-node capacity below 5nm
- Taiwan produces about 65% of the world's semiconductors
- It sits on the main southbound route linking Northeast Asia and Southeast Asia

**Risk triggers**
- Larger-scale Chinese military exercises, especially blockade drills
- U.S. arms sales to Taiwan or high-level official visits
- Major policy changes in cross-strait relations

**Key monitoring indicators**
```python
# Proxy indicators
- Abnormal weakness in the Philadelphia Semiconductor Index (SOX)
- TSM ADR (TSM) premium / discount in the U.S. market
- Taiwan CDS spreads
- TWD NDF depreciation under stress
- KOSPI, given Korea's semiconductor linkage
- U.S.-listed Chinese ADRs / Hong Kong Hang Seng Tech Index
```

**Asset impact direction**
- Bullish: Intel / GlobalFoundries as substitute capacity providers, defense stocks, JPY as a haven
- Bearish: Apple / NVIDIA / AMD / Qualcomm as TSMC clients, TSM ADR, Samsung Electronics
- Extreme scenario: global semiconductor shortage leading to collapse across auto and consumer-electronics supply chains

**Supply chain substitution timeline**
```
3-6 months: inventory drawdown, sharp price spikes
6-18 months: partial substitution by Samsung / Intel IDM advanced capacity
2-4 years: ramp-up from TSMC Arizona and Kumamoto Japan
5+ years: Mainland China's independent advanced process catch-up, with major uncertainty
```

---

### 3. Red Sea / Suez Canal — Europe-Asia Trade Artery

**Strategic significance**
- The Suez Canal carries about 12% of global trade volume and 30% of container shipping
- The alternative route around the Cape of Good Hope adds 10-14 days and raises cost by 15-25%
- Houthi forces in Yemen threaten the Bab el-Mandeb chokepoint

**Risk triggers** (already validated by the 2024 Houthi attacks)
- Intensified attacks on merchant vessels by Houthi forces
- Israel-Gaza escalation spilling across the region
- Political instability in Eritrea or Somalia

**Key monitoring indicators**
```python
# Proxy indicators
- Daily changes in the Baltic Dry Index (BDI)
- SCFI Shanghai Containerized Freight Index
- Share prices of Maersk and other container shipping companies
- Share of AIS-tracked vessels rerouting via the Cape of Good Hope (>30% is high alert)
- European TTF natural gas prices, given Red Sea LNG exposure
```

**Asset impact direction**
- Bullish: shipping stocks (ZIM/MAERSK/COSCO), tankers rerouting around the Cape (FRO/STNG)
- Bearish: European manufacturers facing supply-chain delays, inflation-sensitive sectors
- Lag effect: higher freight rates → higher global CPI → tighter rate expectations

---

### 4. Russia-Ukraine Conflict — Energy and Food Security

**Strategic significance**
- Russia is the world's largest natural gas exporter and second-largest crude exporter
- Ukraine is a major global grain exporter (wheat / corn / sunflower oil)
- The war has already driven a permanent restructuring of Europe's energy mix

**Ongoing risk points**
- Escalation in nuclear rhetoric, a major tail-risk driver
- Sanctions expanding to third parties, forcing countries like China and India to choose sides
- Continued attacks on Ukrainian infrastructure such as the power grid and ports

**Key monitoring indicators**
```python
# Proxy indicators
- European TTF natural gas futures
- Ukrainian sovereign CDS spreads
- RUB/USD exc
vibe-tradingSkill

Professional finance research toolkit — backtesting (7 engines + benchmark comparison panel), factor analysis, Alpha Zoo (452 pre-built alphas across qlib158/alpha101/gtja191/academic), options pricing, 77 finance skills, 29 multi-agent swarm teams, Trade Journal analyzer, and Shadow Account (extract → backtest → render) across 7 data sources (tushare, yfinance, okx, akshare, mootdx, ccxt, futu).

adr-hshareSkill

ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and A-shares for arbitrage signals, dual-listing valuation, and delisting risk assessment.

akshareSkill

AKShare financial data aggregator (18k+ stars). Free, no API key. Covers A-shares, US, HK, futures, macro, forex. Primary fallback for tushare and yfinance.

alpha-zooSkill

Browse and bench the bundled alpha zoos — prebuilt cross-sectional factor libraries (Kakushadze 101, GTJA 191, Qlib 158, Fama-French / Carhart). Use when the user asks "which alphas exist", wants metadata on a named alpha, or wants to run IC/IR on a whole zoo over a universe.

ashare-pre-st-filterSkill

A 股 ST/*ST 风险预测框架 — 基于最新中报/三季报或业绩预告/快报,预测下一财年是否会因营收、利润、净资产、分红不达标而被风险警示,并将新浪监管处罚记录作为独立证据面纳入风险等级。仅适用于 A 股,不预测财务造假。

asset-allocationSkill

Asset allocation theory and optimizer usage — MPT / Black-Litterman / risk budgeting / all-weather strategy, including guides for 4 optimizers and rebalancing rules.

backtest-diagnoseSkill

Diagnose failed or underperforming backtests, locate the root cause, and fix the issue

behavioral-financeSkill

Behavioral finance applications: theories of overreaction and underreaction, behavioral explanations for momentum and reversal, investor sentiment cycles, cognitive-bias checklists, and debiasing quantitative strategies.