Help us improve
Share bugs, ideas, or general feedback.
From nz-skills
Queries New Zealand weather and marine data from the MetOcean API. Provides current conditions, hourly forecasts, 7-day outlooks, and wave/swell data via CLI.
npx claudepluginhub thecolab-ai/.skills --plugin nz-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/nz-skills:metservice-nzThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Query point forecasts from the MetOcean API for New Zealand locations — weather, marine, and atmospheric data through a CLI that is easy for agents to script and easy for humans to scan.
Queries New Zealand LINZ tide predictions and SwellMap surf forecasts via CLI. Use for NZ tide times, next high/low tide, surf forecasts, swell trends, or choosing the best nearby surf break.
Fetches current, hourly, and daily weather forecasts, alerts, and historical statistics from WeatherKit for iOS apps. Provides Swift API usage for weather data integration.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Share bugs, ideas, or general feedback.
Query point forecasts from the MetOcean API for New Zealand locations — weather, marine, and atmospheric data through a CLI that is easy for agents to script and easy for humans to scan.
scripts/cli.py with the narrowest subcommand that answers the task--json when another tool or agent needs machine-readable output--location lat,lon for custom coordinates not in the named listRequires a MetOcean API key (free tier available).
.env:
METOCEAN_API_KEY=your_key_here
process.env.METOCEAN_API_KEY — no fallback, key is required.Run with:
python3 skills/metservice-nz/scripts/cli.py <command> [flags]
now [location] [--json] [--location lat,lon]Current conditions snapshot: temperature, wind, rain, humidity, pressure, cloud cover, visibility.
Examples:
python3 skills/metservice-nz/scripts/cli.py now auckland
python3 skills/metservice-nz/scripts/cli.py now wellington --json
python3 skills/metservice-nz/scripts/cli.py now --location -37.0,175.5
forecast [location] [--json] [--location lat,lon]24-hour hourly forecast: time, temperature, rain, wind speed/direction, cloud cover.
Examples:
python3 skills/metservice-nz/scripts/cli.py forecast auckland
python3 skills/metservice-nz/scripts/cli.py forecast christchurch --json
daily [location] [--json] [--location lat,lon]7-day daily summary: high/low temperature, total rain, average wind, dominant wind direction.
Examples:
python3 skills/metservice-nz/scripts/cli.py daily queenstown
python3 skills/metservice-nz/scripts/cli.py daily wellington --json
marine [location] [--json] [--location lat,lon]Marine forecast: wave height, swell height, swell period, swell direction, sea temperature (where available).
Examples:
python3 skills/metservice-nz/scripts/cli.py marine auckland
python3 skills/metservice-nz/scripts/cli.py marine clevedon --json
wind [location] [--json] [--location lat,lon]Detailed wind forecast: speed, gusts, direction — hourly for 24 hours.
Examples:
python3 skills/metservice-nz/scripts/cli.py wind wellington
python3 skills/metservice-nz/scripts/cli.py wind auckland
rain [location] [--json] [--location lat,lon]Precipitation forecast: hourly rain rate for 24 hours.
Examples:
python3 skills/metservice-nz/scripts/cli.py rain christchurch
python3 skills/metservice-nz/scripts/cli.py rain queenstown --json
warnings [--json]Scrape MetService severe weather warnings page for active alerts, watches, and advisories.
Examples:
python3 skills/metservice-nz/scripts/cli.py warnings
python3 skills/metservice-nz/scripts/cli.py warnings --json
cyclone [location] [--json] [--location lat,lon] [--hours n]Cyclone-specific data: pressure trend, extreme wind, storm surge indicators. Fetches 48h by default. Shows current snapshot, pressure trend, peak conditions, and hourly table.
Examples:
python3 skills/metservice-nz/scripts/cli.py cyclone auckland
python3 skills/metservice-nz/scripts/cli.py cyclone wellington --hours 72
python3 skills/metservice-nz/scripts/cli.py cyclone clevedon --json
pressure [location] [--json] [--location lat,lon]Barometric pressure trend — the #1 cyclone indicator. Shows 12h history + 12h forecast with rate of change and severity classification.
Examples:
python3 skills/metservice-nz/scripts/cli.py pressure auckland
python3 skills/metservice-nz/scripts/cli.py pressure wellington --json
watch [location] [--location lat,lon] [--interval minutes] [--json]Continuous cyclone monitoring. Polls every 5 minutes (configurable) and alerts on significant changes. Shows pressure change between polls.
Examples:
python3 skills/metservice-nz/scripts/cli.py watch auckland
python3 skills/metservice-nz/scripts/cli.py watch wellington --interval 2
python3 skills/metservice-nz/scripts/cli.py watch clevedon --json
locations [--json]List all named locations with coordinates.
Examples:
python3 skills/metservice-nz/scripts/cli.py locations
python3 skills/metservice-nz/scripts/cli.py locations --json
| Name | Lat | Lon |
|---|---|---|
| clevedon | -36.9697 | 175.0752 |
| auckland | -36.8485 | 174.7633 |
| wellington | -41.2865 | 174.7762 |
| christchurch | -43.5321 | 172.6362 |
| queenstown | -45.0312 | 168.6626 |
air.temperature.at-2m (K)air.humidity.at-2m (%)air.pressure.at-sea-level (Pa)air.visibility (m)cloud.cover (fraction 0-1)precipitation.rate (mm/hr)radiation.flux.downward.shortwave (W/m²)wind.speed.at-10m (m/s)wind.direction.at-10m (degrees)wind.speed.gust.at-10m (m/s)wave.height (m)wave.height.primary-swell (m)wave.height.wind-sea (m)wave.period.peak (s)wave.period.primary-swell.peak (s)wave.direction.peak (degrees)wave.direction.primary-swell.mean (degrees)sea.temperature.at-surface (K)scripts/cli.pyscripts/smoke_test.pyMETOCEAN_API_KEY in your .env--json output is for chaining into other toolsData indicators, CLI commands, MetOcean variables, and official NZ and Pacific sources: references/cyclone-tracking.md