Generated banner for Hormuz Strait
Generated logo for Hormuz Strait

Hormuz Strait

Alex YangCommunityCreated by Alex Yang

  • Skill
  • Tool integration
  • Business and productivity
  • MIT
  • Low risk

From the author

Check the live status of the Strait of Hormuz from the Hormuz Strait Monitor dashboard: open, restricted, or closed status, tanker transits vs normal, stranded vessels, Brent price impact, war-risk insurance levels, cargo throughput, tanker freight rates, diplomatic developments, and global trade impact. Use this skill whenever the user asks about the Strait of Hormuz or the Persian Gulf in the context of oil, shipping, or geopolitical risk — whether Hormuz is open, chokepoint or transit disruption, Gulf tanker traffic, war-risk premiums, Middle East shipping routes, or energy supply-chain risk.
— the description by Alex Yang

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The Hormuz Strait Monitor skill provides a comprehensive, real-time dashboard for tracking the operational status of the Strait of Hormuz. It aggregates critical data points including tanker transit volumes, Brent crude oil price fluctuations, war-risk insurance premiums, stranded vessel counts, and diplomatic developments. Designed for financial researchers and supply-chain analysts, the skill translates complex maritime and geopolitical data into actionable risk assessments, highlighting potential impacts on global energy supply chains and trade costs.

What it does

  • Fetches live operational status of the Strait of Hormuz.
  • Reports on tanker transit counts and cargo throughput in DWT.
  • Tracks Brent crude oil price movements and 24-hour trends.
  • Monitors war-risk insurance levels and premium multipliers.
  • Summarizes diplomatic developments and global trade impacts.
  • Provides a crisis timeline and news updates regarding the region.

When to use it

  • When assessing geopolitical risk in the Persian Gulf.
  • When analyzing the impact of maritime disruptions on global oil prices.
  • When evaluating supply-chain risks for energy and shipping logistics.
  • When monitoring war-risk insurance premiums for tanker fleets.
  • When investigating the status of stranded vessels in the Strait.

Advantages

  • Centralizes fragmented maritime, financial, and diplomatic data.
  • Provides standardized risk levels for quick decision-making.
  • Offers clear metrics on global trade impact and alternative routes.
  • Enables rapid assessment of supply-chain disruptions.

Usage examples

“Is the Strait of Hormuz currently open?”
The agent returns the current operational status (e.g., OPEN, RESTRICTED, CLOSED), the duration of the current status, and a brief description.
“What is the current impact of the situation in the Persian Gulf on oil prices and shipping?”
The agent provides a comprehensive briefing including Brent price changes, tanker transit percentages, insurance risk levels, and the estimated daily cost to global trade.
“Are there any stranded vessels in the Strait of Hormuz today?”
The agent displays the total count of stranded vessels, broken down by type (tankers, bulk, other), and notes any change from the previous day.
“What is the current war-risk insurance level for the Strait?”
The agent reports the current risk level (e.g., NORMAL, HIGH), the specific war risk percentage, and the multiplier compared to baseline rates.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/himself65/hormuz-strait/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip hormuz-strait.zip -d .agents/skills

Documentation by Alex Yang

Hormuz Strait Monitor Skill

Fetches real-time status of the Strait of Hormuz from the Hormuz Strait Monitor dashboard API. Covers shipping transits, oil prices, stranded vessels, insurance risk, diplomatic status, global trade impact, and crisis timeline.

This skill is read-only. It fetches public dashboard data — no authentication required.


Step 1: Fetch Dashboard Data

Use curl to fetch the dashboard API:

curl -s https://hormuzstraitmonitor.com/api/dashboard

Parse the JSON response. The API returns { "success": true, "data": { ... }, "timestamp": "..." }.

If success is false or the request fails, inform the user the monitor is temporarily unavailable and suggest checking https://hormuzstraitmonitor.com directly.


Step 2: Identify What the User Needs

Match the user's request to the relevant data sections. If the user asks for a general status update, present all sections. If they ask about something specific, focus on the relevant section(s).

User RequestData SectionKey Fields
General status / "is Hormuz open?"straitStatusstatus, since, description
Ship traffic / transit countshipCountcurrentTransits, last24h, normalDaily, percentOfNormal
Oil price impactoilPricebrentPrice, change24h, changePercent24h, sparkline
Stranded / stuck vesselsstrandedVesselstotal, tankers, bulk, other, changeToday
Insurance / war riskinsurancelevel, warRiskPercent, normalPercent, multiplier
Cargo throughputthroughputtodayDWT, averageDWT, percentOfNormal, last7Days
Diplomatic situationdiplomacystatus, headline, parties, summary
Global trade impactglobalTradeImpactpercentOfWorldOilAtRisk, estimatedDailyCostBillions, affectedRegions, lngImpact, alternativeRoutes, supplyChainImpact
Crisis timeline / eventscrisisTimelineevents[] with date, type, title, description
Tanker freight rates / VLCC ratestankerRatescurrentRate, preCrisisRate, changePercent, route, vesselType, trend, unit
Latest newsnewstitle, source, url, publishedAt, description

Step 3: Present the Data

Format the results clearly for financial research. Adapt the presentation based on what the user asked for.

General status briefing (default)

When the user asks for a general update, cover these sections — a line each while shipping is operating normally, more depth wherever there is active disruption:

  1. Strait Status — lead with the current status (e.g., "OPEN", "RESTRICTED", "CLOSED"), how long it's been in that state, and the description

  2. Ship Traffic — current transits, last 24h count, and percent of normal

  3. Oil Price — Brent price with 24h change

  4. Stranded Vessels — total count broken down by type, with today's change

  5. Insurance Risk — risk level, war risk premium percentage, and multiplier vs. normal

  6. Cargo Throughput — today's DWT vs. average, percent of normal

  7. Diplomatic Status — current status, headline, and brief summary

  8. Global Trade Impact — percent of world oil at risk, estimated daily cost, and top affected regions

  9. Tanker Freight Rates — current VLCC rate on the benchmark route vs. pre-crisis baseline, with trend direction

Formatting guidelines
  • Use tables for structured data (vessel counts, affected regions, alternative routes)

  • Highlight abnormal values — if percentOfNormal is below 80% or above 120%, call it out

  • For oilPrice.sparkline, describe the trend (rising, falling, stable) rather than listing raw numbers

  • For throughput.last7Days, describe the trend direction

  • Show lastUpdated timestamp so the user knows data freshness

  • For news items, include the source and link

  • For crisis timeline events, present chronologically with event type labels

Risk assessment

Based on the data, provide a brief risk assessment. insurance.level values come back uppercase:

Insurance LevelInterpretation
NORMALNo elevated risk — shipping operating normally
ELEVATEDSome disruption concerns — monitor closely
HIGHSignificant risk — active disruption or credible threat
CRITICALSevere disruption — major impact on global oil supply
EXTREMEEffective closure — war risk premiums at multi-decade highs, most commercial traffic halted

If the strait status is anything other than fully open, highlight:

  • The estimated daily cost to global trade

  • Which regions are most affected and their oil dependency

  • Available alternative routes with additional transit days and cost

  • LNG impact if applicable

  • SPR (Strategic Petroleum Reserve) status in days


Step 4: Respond to the User

  • Lead with the most important information: strait status and any active disruption

  • Include data freshness (lastUpdated timestamp)

  • If the situation is elevated or worse, proactively include the global trade impact summary

  • Keep the response concise for routine "all clear" statuses; expand for active incidents

  • Add a disclaimer: data is sourced from Hormuz Strait Monitor and may have delays


Reference Files

  • references/api_schema.md — Complete API response schema with field descriptions and data types

Read the reference file when you need exact field names or data type details.

Files

references/api_schema.md

Hormuz Strait Monitor — Dashboard API Schema

Endpoint: GET https://hormuzstraitmonitor.com/api/dashboard

Authentication: None (public API)

Response format: JSON


Top-level response

FieldTypeDescription
successbooleanWhether the API call succeeded
dataobjectDashboard data (see sections below)
timestampstring (ISO datetime)Server response timestamp

data.straitStatus

Current operational status of the strait.

FieldTypeDescription
statusstringCurrent status enum (observed: "OPEN", "RESTRICTED", "CLOSED")
sincestring (ISO date)Date the current status began
descriptionstringHuman-readable status description

data.shipCount

Ship transit statistics.

FieldTypeDescription
currentTransitsnumberShips currently transiting the strait
last24hnumberTotal transits in the last 24 hours
normalDailynumberNormal daily transit count (baseline)
percentOfNormalnumberCurrent traffic as percentage of normal

data.oilPrice

Brent crude oil price and recent movement.

FieldTypeDescription
brentPricenumberCurrent Brent crude price (USD/barrel)
change24hnumberAbsolute price change in last 24 hours
changePercent24hnumberPercentage price change in last 24 hours
sparklinenumber[]24-hour price history (array of prices)

data.strandedVessels

Vessels unable to transit the strait.

FieldTypeDescription
totalnumberTotal stranded vessels
tankersnumberStranded tanker vessels
bulknumberStranded bulk carriers
othernumberOther stranded vessels
changeTodaynumberChange in stranded vessel count today

data.insurance

Marine insurance and war risk premium levels.

FieldTypeDescription
levelstringRisk level enum (observed: "NORMAL", "ELEVATED", "HIGH", "CRITICAL", "EXTREME")
warRiskPercentnumberCurrent war risk premium as percentage
normalPercentnumberNormal (baseline) insurance rate percentage
multipliernumberCurrent rate as multiplier of normal rate

data.throughput

Cargo throughput in deadweight tonnage (DWT).

FieldTypeDescription
todayDWTnumberToday's cargo throughput in DWT
averageDWTnumberAverage daily throughput in DWT
percentOfNormalnumberToday's throughput as percentage of average
last7Daysnumber[]Daily DWT values for the last 7 days

data.diplomacy

Current diplomatic situation affecting the strait.

FieldTypeDescription
statusstringDiplomatic status enum (uppercase snake case; e.g., "TALKS_IN_PROGRESS")
headlinestringCurrent diplomatic headline
datestring (ISO date)Date of the latest diplomatic development
partiesstring[]Parties involved
summarystringSummary of the diplomatic situation

data.globalTradeImpact

Estimated impact on global trade if the strait is disrupted.

FieldTypeDescription
percentOfWorldOilAtRisknumberPercentage of global oil supply at risk
estimatedDailyCostBillionsnumberEstimated daily cost of disruption in billions USD
affectedRegionsobject[]List of affected regions (see below)
lngImpactobjectLNG-specific impact (see below)
alternativeRoutesobject[]Available alternative shipping routes (see below)
supplyChainImpactobjectBroader supply chain impact (see below)
affectedRegions[]
FieldTypeDescription
namestringRegion name
severitystringImpact severity enum (observed: "MODERATE", "HIGH", "CRITICAL")
oilDependencyPercentnumberRegion's dependency on strait-transiting oil
descriptionstringDescription of impact on this region
lngImpact
FieldTypeDescription
percentOfWorldLngAtRisknumberPercentage of global LNG at risk
estimatedLngDailyCostBillionsnumberEstimated daily LNG disruption cost (billions USD)
topAffectedImportersstring[]Countries most affected by LNG disruption
descriptionstringDescription of LNG impact
alternativeRoutes[]
FieldTypeDescription
namestringRoute name
additionalDaysnumberExtra transit days vs. Hormuz route
additionalCostPerVesselnumberExtra cost per vessel (USD)
currentUsageStatusstringWhether this route is currently in use
supplyChainImpact
FieldTypeDescription
shippingRateIncreasePercentnumberPercentage increase in shipping rates
consumerPriceImpactPercentnumberEstimated consumer price impact
sprStatusDaysnumberStrategic Petroleum Reserve coverage in days
keyDisruptionsstring[]Key supply chain disruptions

data.crisisTimeline

Timeline of events related to the current situation.

events[]
FieldTypeDescription
datestring (ISO date)Event date
typestringEvent type enum (observed: "MILITARY", "DIPLOMATIC", "ESCALATION", "ECONOMIC")
titlestringEvent title
descriptionstringEvent description

data.tankerRates

VLCC tanker freight rate tracker for the Hormuz-adjacent benchmark route.

FieldTypeDescription
currentRatenumberCurrent freight rate on the benchmark route
preCrisisRatenumberPre-crisis baseline rate on the same route
changePercentnumberPercentage change vs. the pre-crisis baseline
routestringBenchmark route code (e.g., "AG-East (TD3C)")
vesselTypestringVessel class (e.g., "VLCC")
trendnumber[]Recent rate history points (aligned with unit)
unitstringRate unit (e.g., "WS" for Worldscale, "USD/day" for time-charter equivalent)

data.news

Latest news articles related to the strait.

FieldTypeDescription
titlestringArticle title
sourcestringNews source name
urlstringLink to the article
publishedAtstring (ISO datetime)Publication timestamp
descriptionstringArticle summary

data.lastUpdated

String (ISO datetime) — when the dashboard data was last updated. Appears directly on data, not as a nested object.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs network access

Security

What our scanner noticed· Low risk

  • Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Alex Yang
Publisher
Alex Yang (Community)
Source
himself65/finance-skills · plugins/data-providers/skills/hormuz-strait · commit a085078
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Alex Yang.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download hormuz-strait.zip