Translink CLI for Openclaw

A powerful interface for querying, troubleshooting, and explaining Translink SEQ GTFS static and realtime transit data.

alanburchill
v1.0.1
Feb 23, 2026
2
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install translink-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install translink-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Translink CLI?

The Translink CLI skill provides a robust framework for developers working with South East Queensland transit data. By leveraging Openclaw Skills, users can seamlessly interface with GTFS datasets, perform complex joins across routes and stops, and access realtime vehicle updates through a standardized command-line or slash-command interface.

This skill is designed to bridge the gap between raw transit data and actionable insights, offering a suite of commands that handle the heavy lifting of data extraction, caching, and schema validation. It ensures that developers always have access to the most authoritative and fresh transit information available.

Translink CLI Use Cases

  • Look up specific bus or train schedules using GTFS static data.
  • Troubleshoot schema drift and validate field-level errors in transit datasets.
  • Join complex relationships between stops, trips, and shapes using PK/FK reasoning.
  • Monitor realtime vehicle positions and service alerts for specific routes.
  • Generate paginated reports or JSON exports of transit metadata for external applications.

How Translink CLI Works

  1. Initialize the environment by ensuring the Translink CLI scripts are installed in the system PATH.
  2. Execute translink_schedule_refresh to pull the latest GTFS static data and validate the local cache.
  3. Formulate queries using shared parameters like --where, --contains, or --in to filter specific transit entities.
  4. Leverage the skill's fuzzy matching engine to correct field name errors based on the JSON error payload suggestions.
  5. Access realtime data streams with the --expand or --raw flags for deep inspection of current transit status.

Translink CLI Setup

To use this Openclaw Skills extension, first install the prerequisite CLI scripts from the official repository:

git clone https://github.com/alanburchill/traslink-cli-scripts
# Add the cloned directory to your system PATH

Verify the installation by running the refresh command to populate your local cache:

translink_schedule_refresh

Translink CLI Data Schema & Taxonomy

The skill maintains a local cache and auto-generates schema documentation to ensure data integrity. Data is organized as follows:

Resource Location Purpose
Static Cache ~/.openclaw/cache/translink/ Local storage for GTFS zip and extracted data
Live Schema references/schema-generated.md Authoritative field definitions and column types
Relationships references/relationships.md Mapping of Primary and Foreign keys for joins
Command Contract references/commands.md Documentation for parameters and error codes

Translink CLI Advanced Features

  • Automated daily refresh via cron at 5:00 AM local time to ensure data freshness.
  • Concurrent execution protection using a dedicated refresh lock to prevent data corruption.
  • Header-driven schema adaptation that automatically detects and incorporates new columns into the query engine.
  • Comprehensive join support across stops, stop_times, calendar, and shapes for complex data modeling.
  • Advanced realtime data parsing including epoch/ISO time formatting and nested JSON expansion for deep telemetry analysis.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*