← Back to Skills Marketplace
207
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install rail-cli
Description
UK National Rail CLI — live departures, arrivals, station search, destination filtering, batch station search from stdin, and lightweight field selection for...
Usage Guidance
This skill appears to do what it says: run the 'rail' CLI and use your Darwin access token for live rail data. Before installing, verify the npm package and author (e.g., check the package page, readme, recent versions, and package contents) because npm packages run code on your machine. Keep the DARWIN_ACCESS_TOKEN private and only provide it to trusted packages; if you prefer, inspect the package source or run it in a sandbox/container before global install. The SKILL.md mentions an optional RAIL_API_URL (not flagged as required) — you can ignore that unless you need to point to a custom Huxley2 instance.
Capability Analysis
Type: OpenClaw Skill
Name: rail-cli
Version: 0.2.2
The rail-cli skill is a legitimate utility for accessing UK National Rail data via the Darwin/Huxley2 API. It requires a standard API token (DARWIN_ACCESS_TOKEN) and installs via a public npm package (@shan8851/rail-cli). The instructions in SKILL.md are well-documented and aligned with the tool's stated purpose, with no evidence of malicious behavior, data exfiltration, or prompt injection attacks.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, required binary ('rail'), and required env (DARWIN_ACCESS_TOKEN) match: the CLI queries National Rail Darwin for departures/arrivals and station search, so the token and binary are expected and proportionate.
Instruction Scope
SKILL.md instructs the agent to run the 'rail' CLI and use the Darwin token; it does not ask the agent to read unrelated files, secrets, or system state beyond recommending how to set the token. Behavior (JSON/text output, stdin modes) is narrowly scoped to the stated functionality.
Install Mechanism
Install is an npm package (@shan8851/rail-cli) that exposes the 'rail' binary. Using npm is an expected delivery mechanism for a CLI written in Node, but installing code from a public registry carries moderate risk—verify the package author, version, and contents before installing system-wide.
Credentials
Only DARWIN_ACCESS_TOKEN is required and is justified for departures/arrivals. The SKILL.md mentions an optional RAIL_API_URL override that is not listed as required in registry metadata (minor documentation inconsistency but not a security mismatch). No other unrelated credentials are requested.
Persistence & Privilege
The skill is not forced-always and does not request system-wide config changes or other skills' credentials. Default autonomous invocation is allowed (platform default) and is not combined with other concerning privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install rail-cli - After installation, invoke the skill by name or use
/rail-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.2
Add OpenClaw metadata and credential requirements
v0.2.1
Publish from ~/.openclaw/skills as source of truth; keep OpenClaw metadata and updated agent-first search docs.
v0.2.0
- Adds support for batch station search via stdin with `rail search --stdin`.
- Introduces the `--select` flag for lightweight field selection (e.g. CRS only, name only, or both).
- Enhances agent-friendliness with explicit envelope structure for both success and error outputs.
- Expands usage documentation and notes for agent integration and new search modes.
- No core command syntax changes; existing departure and arrival queries remain unchanged.
v0.1.0
Initial release of rail-cli — UK National Rail CLI.
- Provides live departures, arrivals, and station search for all GB National Rail stations.
- Supports filtering by destination or origin, and returning calling points or limited results.
- Offers both text and JSON output, with easy toggling and color management.
- Requires a free Darwin access token for departures and arrivals; station search works without authentication.
- Accepts both station names and CRS codes, and handles ambiguous station names with suggestions.
Metadata
Frequently Asked Questions
What is Rail CLI?
UK National Rail CLI — live departures, arrivals, station search, destination filtering, batch station search from stdin, and lightweight field selection for... It is an AI Agent Skill for Claude Code / OpenClaw, with 207 downloads so far.
How do I install Rail CLI?
Run "/install rail-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Rail CLI free?
Yes, Rail CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Rail CLI support?
Rail CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Rail CLI?
It is built and maintained by shan8851 (@shan8851); the current version is v0.2.2.
More Skills