Hormuz Strait
Pull live Strait of Hormuz shipping, oil, insurance, and diplomacy dashboard data when geopolitical risk affects your trading or supply-chain decisions.
Overview
Hormuz Strait is an agent skill most often used in Idea (also Grow analytics, Operate infra) that fetches public Hormuz Strait Monitor dashboard data on shipping, oil, insurance, and diplomacy via a read-only API.
Install
npx skills add https://github.com/himself65/finance-skills --skill hormuz-straitWhat is this skill?
- Read-only `curl` fetch of hormuzstraitmonitor.com `/api/dashboard` — no auth
- Covers shipping transits, stranded vessels, oil price impact, insurance risk, diplomacy, and trade impact
- Trigger phrases include Hormuz status, Persian Gulf tankers, oil chokepoint, and energy supply-chain risk
- Parses structured JSON `{ success, data }` for agent summarization
- Explicitly scoped to Hormuz / Persian Gulf oil-shipping and geopolitical risk questions
- Single-step curl to `/api/dashboard`
- Read-only — no authentication required
Adoption & trust: 899 installs on skills.sh; 2.7k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need an up-to-date picture of Hormuz transit and energy-market risk but only have scattered headlines and no single structured feed.
Who is it for?
Solo builders wiring research agents, commodity watchlists, or ops briefings that must cite live Hormuz monitor fields.
Skip if: Teams that need authenticated vessel AIS, proprietary trading signals, or execution of trades—this skill only reads public dashboard JSON.
When should I use this skill?
User asks about Strait of Hormuz, Persian Gulf shipping, oil transit disruption, war risk premium, Hormuz crisis, or energy supply chain risk in the Gulf.
What do I get? / Deliverables
After the skill runs, your agent returns a dashboard-grounded summary of chokepoint status, vessels, prices, and crisis timeline fields from the latest API response.
- Structured summary of latest dashboard API fields
- Crisis timeline and risk indicators from parsed JSON
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Idea → research because the skill answers “what is happening at the chokepoint now?” before you commit capital or roadmap bets. Fits audience and competitor-style market intel: transit counts, war-risk premium context, and crisis timeline from a single public API.
Where it fits
Validate whether Gulf escalation is material before pitching an energy-logistics SaaS.
Refresh Hormuz transit stats when weekly retention dashboards tie to freight or fuel assumptions.
Check stranded-vessel and insurance fields before updating customer-facing SLA copy on Middle East routes.
How it compares
Use instead of ad-hoc web search for Hormuz headlines when you want one consistent JSON source per check.
Common Questions / FAQ
Who is hormuz-strait for?
Indie builders and small teams running AI agents for macro, energy, or logistics research who want a repeatable Hormuz status pull without custom scrapers.
When should I use hormuz-strait?
During Idea research on Gulf risk, Grow analytics when energy prices move your metrics, or Operate iterate when production supply chains depend on Persian Gulf routes—whenever the user mentions Hormuz, tankers, or oil chokepoint risk.
Is hormuz-strait safe to install?
It is read-only network access to a public API; review the Security Audits panel on this Prism page and treat outbound curl as you would any agent network permission.
SKILL.md
READMESKILL.md - Hormuz Strait
# Hormuz Strait Monitor Skill Fetches real-time status of the Strait of Hormuz from the [Hormuz Strait Monitor](https://hormuzstraitmonitor.com) 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: ```bash 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 Request | Data Section | Key Fields | |---|---|---| | General status / "is Hormuz open?" | `straitStatus` | `status`, `since`, `description` | | Ship traffic / transit count | `shipCount` | `currentTransits`, `last24h`, `normalDaily`, `percentOfNormal` | | Oil price impact | `oilPrice` | `brentPrice`, `change24h`, `changePercent24h`, `sparkline` | | Stranded / stuck vessels | `strandedVessels` | `total`, `tankers`, `bulk`, `other`, `changeToday` | | Insurance / war risk | `insurance` | `level`, `warRiskPercent`, `normalPercent`, `multiplier` | | Cargo throughput | `throughput` | `todayDWT`, `averageDWT`, `percentOfNormal`, `last7Days` | | Diplomatic situation | `diplomacy` | `status`, `headline`, `parties`, `summary` | | Global trade impact | `globalTradeImpact` | `percentOfWorldOilAtRisk`, `estimatedDailyCostBillions`, `affectedRegions`, `lngImpact`, `alternativeRoutes`, `supplyChainImpact` | | Crisis timeline / events | `crisisTimeline` | `events[]` with `date`, `type`, `title`, `description` | | Tanker freight rates / VLCC rates | `tankerRates` | `currentRate`, `preCrisisRate`, `changePercent`, `route`, `vesselType`, `trend`, `unit` | | Latest news | `news` | `title`, `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, present a concise briefing covering all key sections: 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** —