MCPInstall

hormuz-strait

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.

Installs
3.2K
Last 24h
+54
Trending rank
#3180
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/himself65/finance-skills --skill hormuz-strait
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads hormuz-strait automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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.

FAQ

What does the hormuz-strait skill do?

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.

How do I install hormuz-strait?

Run npx skills add https://github.com/himself65/finance-skills --skill hormuz-strait in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hormuz-strait/ (personal) or .claude/skills/hormuz-strait/ (project).

Which AI agents can use hormuz-strait?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is hormuz-strait safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains hormuz-strait?

It is published by himself65 in himself65/finance-skills. It has 3,201 recorded installs.

More from himself65/finance-skills

View all →

yfinance-data

himself65/finance-skills

Fetch financial and market data with the yfinance Python library (Yahoo Finance). Use this skill whenever the user wants stock data: current quotes and price history, financial statements (income statement, balance sheet, cash flow), options chains, dividends and splits, earnings and analyst estimates, price targets and ratings, institutional and insider holdings, news, multi-ticker comparisons, stock screens, or sector and industry data. Use it even when the user gives only a ticker symbol (AAPL, MSFT, TSLA) and the intent has to be inferred. For earnings previews or recaps, estimate revisions, valuation, correlation, liquidity, or ETF premium analysis, prefer the dedicated skill.

Business & Finance3.9K installs

stock-correlation

himself65/finance-skills

Analyze how stocks move together using Yahoo Finance price history (yfinance): find correlated peers for a ticker, measure correlation, beta, and spread between specific tickers, cluster a group into a correlation matrix, and track rolling or regime-dependent correlation. Use this skill whenever the user asks what moves with a stock, what else drops when it drops, related tickers or sympathy plays, sector or supply-chain peers, pair trading or hedging pairs, beta or relative performance, correlation matrices, co-movement, or rolling/realized correlation — including well-known pairs like AMD/NVDA, GOOGL/AVGO, or LITE/COHR. With a single ticker, assume the user wants its correlated peers.

Business & Finance3.5K installs

options-payoff

himself65/finance-skills

Render an interactive options payoff chart — expiry P&L plus Black-Scholes theoretical value — with sliders for strikes, premium, IV, DTE, and spot. Use this skill whenever the user describes or shares an options position or strategy and wants to see how it makes or loses money: vertical, calendar, diagonal, or ratio spreads, butterflies, condors and iron condors, straddles, strangles, covered calls, protective or naked puts, or any multi-leg structure. This includes pasted strikes, premiums, and expiries, requests like "show me the payoff" or "draw the P&L curve", and broker screenshots (IBKR, TastyTrade, Robinhood). Use it even when details are partial — defaults fill the gaps.

earnings-preview

himself65/finance-skills

Build a pre-earnings briefing for a stock from Yahoo Finance data (yfinance): the upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record, analyst ratings and price targets, and what to watch in the print. Use this skill whenever the user is preparing for an upcoming earnings report or asks what the street expects — consensus or whisper numbers, EPS expectations, whether a company will beat, an earnings setup, or an earnings-season preview — and whenever a ticker comes up in the context of upcoming earnings, even without the word "preview". For results that are already out, use earnings-recap.

Docs & Writing3.3K installs

earnings-recap

himself65/finance-skills

Analyze a company's most recent (or a specified past) earnings report from Yahoo Finance data (yfinance): actual vs estimated EPS, surprise size, revenue and margin trends, and the stock's price reaction. Use this skill whenever the user asks how earnings went — beat or miss, earnings surprise, quarterly results, the post-earnings move, or an earnings call recap — including casual references to a past report such as "AMZN reported last night" or "how did they do". For an upcoming report, use earnings-preview.

Docs & Writing3.3K installs

generative-ui

himself65/finance-skills

Design system and templates for interactive HTML/SVG visuals in Claude and Codex, using an available inline renderer or a standalone HTML file. Use this skill whenever the user wants visual or interactive output rather than plain text or markdown: charts and dashboards, diagrams, flowcharts and architecture drawings, mockups, comparison grids, illustrations, interactive explainers ("explain how X works" with a visual), or tools with sliders, toggles, and live-updating displays — including financial data shown visually and requests phrased as "show me", "visualize", "draw", or "chart this".

Frontend & Design3.2K installs

Popular data & databases skills

View category →

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pgcron, pgmq), vector/semantic search (pgvector), and restoring dumps (pgrestore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.

OfficialData & Databases462.2K installs

prisma-client-api

prisma/skills

Prisma Client API reference covering model queries, filters, operators, and client methods. Use when writing database queries, using CRUD operations, filtering data, or configuring Prisma Client. Triggers on "prisma query", "findMany", "create", "update", "delete", "$transaction".

OfficialData & Databases393.5K installs

Deprecated compatibility name for prisma-orm-setup. Use only when a user or existing integration explicitly invokes prisma-database-setup; otherwise select prisma-orm-setup.

OfficialData & Databases392.3K installs

prisma-cli

prisma/skills

Prisma ORM 7 CLI reference for existing Prisma 7 applications or explicitly selected Prisma 7 workflows. Covers prisma init, generate, migrate, db, dev, studio, and mcp. For setup, connection repair, or Prisma 8, use prisma-orm-setup; not the Prisma Platform CLI.

OfficialData & Databases390.8K installs

prisma-postgres

prisma/skills

Deprecated compatibility name for prisma-postgres-setup. Use only when a user or existing integration explicitly invokes prisma-postgres; otherwise select prisma-postgres-setup.

OfficialData & Databases384.4K installs

Required reference for Prisma ORM 7 SQL driver adapter work. Use when implementing or modifying adapters, adding database drivers, or touching SqlDriverAdapter, Transaction, savepoint, result mapping, or DriverAdapterError behavior. Covers current transaction lifecycle, optional savepoint hooks, original database-error preservation, and verification.

OfficialData & Databases378.9K installs