fuelclock-nz

Query FuelClock endpoints for live NZ fuel prices and supply status.

24|6|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/thecolab-ai/.skills --skill fuelclock-nz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fuelclock-nz
Source: https://github.com/thecolab-ai/.skills/tree/main/skills/fuelclock-nz
Command: npx skills add https://github.com/thecolab-ai/.skills --skill fuelclock-nz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

FuelClock NZ turns live NZ fuel price and supply information into a structured, agent-friendly workflow so you can answer “what’s happening right now” without manually browsing multiple sources.

Core Features & Use Cases

  • Live pump price snapshots: Retrieve national-average NZ pump prices for 91, 95, 98, and diesel with change over 7d/28d and station counts.
  • Supply risk and MSO visibility: Surface days remaining, depletion timing, and which fuels are below MSO thresholds.
  • Inbound vessel tracking + geopolitical market watch: Identify inbound vessels with ETA/progress and provide a watch view of tracked fuel-shipping risk markets alongside recent NZ fuel headlines.
  • Use case: When a user asks “How tight is NZ fuel supply today, and what’s the next shipment ETA?”, you can respond with a compact briefing across prices, MSO status, and inbound vessels.

Quick Start

Ask the agent: “Give me a live NZ fuel summary including pump prices, supply risk/MSO status, and the next inbound vessel ETA, in JSON.”

Frequently Asked Questions about fuelclock-nz

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get live NZ fuel prices and current supply status?

To get live NZ fuel prices and supply status, you can use a CLI tool that queries FuelClock's public endpoints and returns structured summaries covering national-average pump prices, days remaining, and MSO threshold breaches.

What NZ fuel grades and price changes does theFuelClock API return?

The FuelClock API returns national-average NZ pump prices for 91, 95, 98, and diesel, including the 7-day and 28-day price changes alongside the number of reporting stations per fuel type.

How do I check if NZ fuel supply is below MSO thresholds?

You can check if NZ fuel supply is below MSO thresholds by running a deterministic CLI command that filters FuelClock's supply data, surfacing days remaining, depletion timing, and specific fuels currently below MSO levels.

Can I track inbound vessels with fuel shipment ETAs for New Zealand?

Yes, you can track inbound vessels with fuel shipment ETAs for New Zealand by querying an endpoint that returns inbound vessel lists including estimated arrival times and voyage progress percentages.

Does the FuelClock NZ skill support JSON output for agent workflows?

Yes, the FuelClock NZ skill supports JSON output for agent workflows by passing an optional --json flag to its deterministic CLI commands, enabling structured data parsing for automated briefings.

What are the limitations of using a public API for NZ fuel supply risk monitoring?

Limitations of using a public API for NZ fuel supply risk monitoring include relying on read-only HTTP GET requests with basic error handling, meaning data availability and update frequency are constrained by the upstream FuelClock endpoints.