How do I install the Ns Trains skill?

Run npx skillmds@latest add modbender/ns-trains in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ns Trains safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ns Trains?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ns Trains free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ns Trains?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ns Trains by modbender — Agent Skill

Name: Ns Trains
Rating: 4.2 (5 reviews)
Author: modbender

File contents

NS Trains Skill

Check Dutch train schedules, departures, disruptions, and plan journeys using the official NS (Nederlandse Spoorwegen) API.

Setup

1. Get an NS subscription key

Go to NS API Portal
Create an account and subscribe to the Ns-App product (free tier available)
Copy your Primary Key

2. Set Environment Variables

export NS_SUBSCRIPTION_KEY="your-subscription-key-here"   # preferred
# Back-compat:
export NS_API_KEY="$NS_SUBSCRIPTION_KEY"                   # legacy name still supported

# Optional: Configure commute stations for quick shortcuts
export NS_HOME_STATION="Utrecht Centraal"
export NS_WORK_STATION="Amsterdam Zuid"

For security, prefer injecting these env vars via your runtime secret mechanism rather than committing them anywhere. Avoid printing or sharing your subscription key.

Quick Usage

🚆 Commute shortcuts

node {baseDir}/scripts/commute.mjs --to-work   # Morning: Home → Work
node {baseDir}/scripts/commute.mjs --to-home   # Evening: Work → Home

Plan any journey

node {baseDir}/scripts/journey.mjs --from "Utrecht Centraal" --to "Amsterdam Zuid"

Check departures from a station

node {baseDir}/scripts/departures.mjs --station "Amsterdam Centraal"

Check arrivals at a station

node {baseDir}/scripts/arrivals.mjs --station "Rotterdam Centraal"

Search for stations

node {baseDir}/scripts/stations.mjs amsterdam
node {baseDir}/scripts/stations.mjs --search "den haag"

Check current disruptions

node {baseDir}/scripts/disruptions.mjs
node {baseDir}/scripts/disruptions.mjs --from "Utrecht" --to "Amsterdam"

Natural Language

Just ask:

"When is the next train to Amsterdam?"
"Check trains from Utrecht to Rotterdam"
"Any train disruptions today?"
"Plan my commute to work"
"What time does the train arrive?"

Output

Returns journey options with:

Departure/arrival times
Real-time delays
Duration
Transfers
Platform numbers
Disruption warnings
Crowdedness forecast (🟢 low / 🟡 medium / 🔴 high)

Commands Reference

Command	Description
`commute.mjs [work\|home]`	Quick commute check (requires NS_HOME_STATION & NS_WORK_STATION)
`journey.mjs --from X --to Y`	Plan a journey between any stations
`departures.mjs --station X`	List departures from a station
`arrivals.mjs --station X`	List arrivals at a station
`stations.mjs [query]`	Search for station names
`disruptions.mjs`	Check current disruptions

API Endpoints Used

/reisinformatie-api/api/v3/trips - Journey planning
/reisinformatie-api/api/v2/arrivals - Arrivals
/reisinformatie-api/api/v2/departures - Departures
/reisinformatie-api/api/v3/disruptions - Disruptions
/reisinformatie-api/api/v2/stations - Station search

Reference

NS API Portal: https://apiportal.ns.nl/
Documentation: https://apiportal.ns.nl/startersguide
Free tier: 5000 requests/day

---name: ns-trainsdescription: Check Dutch train schedules, departures, disruptions, and plan journeys using the NS API. Perfect for daily commute checks.--- # NS Trains Skill Check Dutch train schedules, departures, disruptions, and plan journeys using the official NS (Nederlandse Spoorwegen) API. ## Setup ### 1. Get an NS subscription key 1. Go to [NS API Portal](https://apiportal.ns.nl/) 2. Create an account and subscribe to the **Ns-App** product (free tier available) 3. Copy your **Primary Key** ### 2. Set Environment Variables ```bash export NS_SUBSCRIPTION_KEY="your-subscription-key-here" # preferred # Back-compat: export NS_API_KEY="$NS_SUBSCRIPTION_KEY" # legacy name still supported # Optional: Configure commute stations for quick shortcuts export NS_HOME_STATION="Utrecht Centraal" export NS_WORK_STATION="Amsterdam Zuid" ``` For security, prefer injecting these env vars via your runtime secret mechanism rather than committing them anywhere. Avoid printing or sharing your subscription key. ## Quick Usage ### 🚆 Commute shortcuts ```bash node {baseDir}/scripts/commute.mjs --to-work # Morning: Home → Work node {baseDir}/scripts/commute.mjs --to-home # Evening: Work → Home ``` ### Plan any journey ```bash node {baseDir}/scripts/journey.mjs --from "Utrecht Centraal" --to "Amsterdam Zuid" ``` ### Check departures from a station ```bash node {baseDir}/scripts/departures.mjs --station "Amsterdam Centraal" ``` ### Check arrivals at a station ```bash node {baseDir}/scripts/arrivals.mjs --station "Rotterdam Centraal" ``` ### Search for stations ```bash node {baseDir}/scripts/stations.mjs amsterdam node {baseDir}/scripts/stations.mjs --search "den haag" ``` ### Check current disruptions ```bash node {baseDir}/scripts/disruptions.mjs node {baseDir}/scripts/disruptions.mjs --from "Utrecht" --to "Amsterdam" ``` ## Natural Language Just ask: - "When is the next train to Amsterdam?" - "Check trains from Utrecht to Rotterdam" - "Any train disruptions today?" - "Plan my commute to work" - "What time does the train arrive?" ## Output Returns journey options with: - Departure/arrival times - Real-time delays - Duration - Transfers - Platform numbers - Disruption warnings - Crowdedness forecast (🟢 low / 🟡 medium / 🔴 high) ## Commands Reference | Command | Description | |---------|-------------| | `commute.mjs [work\|home]` | Quick commute check (requires NS_HOME_STATION & NS_WORK_STATION) | | `journey.mjs --from X --to Y` | Plan a journey between any stations | | `departures.mjs --station X` | List departures from a station | | `arrivals.mjs --station X` | List arrivals at a station | | `stations.mjs [query]` | Search for station names | | `disruptions.mjs` | Check current disruptions | ## API Endpoints Used - `/reisinformatie-api/api/v3/trips` - Journey planning - `/reisinformatie-api/api/v2/arrivals` - Arrivals - `/reisinformatie-api/api/v2/departures` - Departures - `/reisinformatie-api/api/v3/disruptions` - Disruptions - `/reisinformatie-api/api/v2/stations` - Station search ## Reference - NS API Portal: https://apiportal.ns.nl/ - Documentation: https://apiportal.ns.nl/startersguide - Free tier: 5000 requests/day

Frequently asked questions

Ns Trains