subwayskill

name	subwayskill
description	Fetch NYC subway departure times. Use when the user asks about subway trains, commute times, when the next train is, or NYC transit schedules. Covers all subway lines (1-7, A-G, J, Z, L, N, Q, R, W, S, SIR).
version	1.0.0
author	nyluke
tags	["transit","nyc","subway","mta","commute"]
homepage	https://github.com/nyluke/subwayskill
license	MIT
allowed-tools	Bash(subwayskill:*)
metadata	{"openclaw":{"emoji":"🚇","category":"transit","requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}

NYC Subway Departure Times

Run the subwayskill CLI to answer questions about NYC subway times.

Commands

# All default stations (Clinton-Washington C, Bergen 2/3, 7 Av Q, Atlantic Av 4/5)
subwayskill

# Specific line and station (fuzzy match — lowercase, partial names work)
subwayskill C clinton-washington
subwayskill 2 bergen

# Filter direction: N (northbound/Manhattan) or S (southbound/Brooklyn)
subwayskill 2 bergen -d N

# Future time — automatically falls back to static schedule
subwayskill 2 bergen -t 19:00

# JSON output for structured data
subwayskill --json
subwayskill C clinton-washington --json

# Control time window (minutes)
subwayskill 2 bergen -w 60

Interpreting output

• realtime: live data from MTA GTFS-RT feeds, shows relative times ("3 min") and absolute times
• scheduled: static GTFS schedule fallback, shows absolute times only — used when the requested time is beyond realtime coverage
• Directions show destination labels when available (e.g., "Manhattan-bound", "Coney Island-bound")

Tips

• Station names are fuzzy-matched: "clinton" finds "Clinton-Washington Avs", "atlantic" finds "Atlantic Av-Barclays Ctr"
• If the user doesn't specify a station, run with no args to show all defaults
• If the user asks about a future time (e.g., "when's the 2 train at Bergen at 7pm?"), use -t HH:MM
• Use --json when you need to do further processing or comparisons
• An unknown station returns suggestions — relay those to the user