# Energy Supply Shock Model

Models how an oil or gas supply shock would affect a country's fuel supply and deficits.

- Repository: https://github.com/koala73/worldmonitor (89946 stars)
- Category: Business
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add koala73/worldmonitor --skill assess-energy-shock -g -a claude-code -y`
Codex: `npx skills add koala73/worldmonitor --skill assess-energy-shock -g -a codex -y`
Cursor: `npx skills add koala73/worldmonitor --skill assess-energy-shock -g -a cursor -y`
Gemini CLI: `npx skills add koala73/worldmonitor --skill assess-energy-shock -g -a gemini-cli -y`

## Description

Model oil or gas supply shock exposure for a country and chokepoint. Use when the user asks how an energy disruption could affect fuel supply, strategic cover, or product deficits.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# assess-energy-shock

Use this skill when the user asks "what happens if Hormuz closes?", "how exposed is Japan to a LNG disruption?", or "what fuel products are most affected by a chokepoint shock?". It computes an on-demand oil and gas shock scenario from seeded JODI, Comtrade, IEA, PortWatch, and gas-storage inputs.

## Authentication

Server-to-server callers (agents, scripts, SDKs) MUST present an API key in the `X-WorldMonitor-Key` header. `Authorization: Bearer ...` is for MCP/OAuth or Clerk JWTs - **not** raw API keys.

```
X-WorldMonitor-Key: wm_0123456789abcdef0123456789abcdef01234567
```

Issue a key at https://www.worldmonitor.app/pro.

## Endpoint

```
GET https://api.worldmonitor.app/api/intelligence/v1/compute-energy-shock
```

## Parameters

| Name | In | Required | Shape | Notes |
|---|---|---|---|---|
| `country_code` | query | yes | ISO 3166-1 alpha-2 | Affected energy market, e.g. `JP`, `DE`, `US`. |
| `chokepoint_id` | query | yes | `hormuz_strait`, `malacca_strait`, `suez`, `bab_el_mandeb` | Chokepoint to model as disrupted. |
| `disruption_pct` | query | no | integer 10-100 | Percent of flow disrupted. Values below `10` are clamped to `10`; values above `100` are clamped to `100`. |
| `fuel_mode` | query | no | `oil`, `gas`, `both` | Defaults to `oil`. |
| `jmespath` | query | no | JMESPath, <= 1024 chars | Server-side projection, e.g. `{assessment: assessment, cover: effectiveCoverDays, coverage: coverageLevel}` |

## Response shape

The rest: https://github.com/koala73/worldmonitor/blob/HEAD/public/.well-known/agent-skills/assess-energy-shock/SKILL.md