nz-ferries

Query New Zealand ferry schedules, fares, and alerts via CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

nz-ferries turns scattered, human-focused ferry timetable and disruption pages into a consistent set of machine-readable schedule snapshots and service alerts for common routes around New Zealand.

Core Features & Use Cases

  • Cook Strait planning: Query Wellington↔Picton sailings by combining Interislander and Bluebridge for a travel date, including service disruption context.
  • Auckland harbour ferry timetables: Fetch scheduled departures for Fullers360/AT Metro routes (e.g., Devonport, Waiheke, Half Moon Bay, Hobsonville, Birkenhead, Rangitoto) and surface current cancellations/disruptions.
  • Operator alerts: Retrieve current public operator service alerts/reminders to help time-sensitive travel planning.
  • Read-only, CLI-first: No booking, payment, login, or browser automation—just deterministic queries with optional JSON output for agent workflows.

Quick Start

Ask your agent for the next sailings from Auckland to Waiheke on a specific date and request JSON for chaining.

Frequently Asked Questions about nz-ferries

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

FAQPage Schema
How do I get real-time New Zealand ferry timetables and service alerts in JSON format?

You can retrieve real-time NZ ferry schedules and service alerts as structured JSON output by querying specific routes like Cook Strait or Auckland harbour, using the command line interface with an optional AT API key for GTFS-RT disruptions.

Can I query next sailings from Auckland to Waiheke for a specific travel date?

Yes, you can fetch next sailings and date-filtered timetables for Auckland ferry routes including Waiheke, Devonport, and Half Moon Bay, normalizing departures from operators like Fullers360 into structured schedule objects.

What is the best way to compare Cook Strait ferry schedules across different operators?

Comparing Cook Strait ferry schedules is done by querying Wellington to Picton sailings, which combines timetable data from both Interislander and Bluebridge operators alongside current service disruption alerts.

Do I need an API key to access public ferry timetable data through the command line?

An API key is not required for basic timetable queries, but an optional AT API key is needed to retrieve GTFS-RT real-time service alerts for Auckland transport ferry routes.

Does this tool support booking ferry tickets or processing payments?

No, it does not support booking, payment, or login functionality; it is a read-only deterministic CLI designed strictly for querying public timetable data and generating structured schedule snapshots.

How do current operator disruptions and cancellation alerts get retrieved for Hauraki Gulf ferry services?

Operator disruptions and cancellation alerts for Hauraki Gulf services are retrieved by fetching current public service alerts via GTFS-RT feeds, helping time-sensitive travel planning with up-to-date reminders.