← 返回 Skills 市场
dedene

Irail

作者 dedene · GitHub ↗ · v1.0.1
cross-platform ✓ 安全检测通过
681
总下载
0
收藏
2
当前安装
2
版本数
在 OpenClaw 中安装
/install irail
功能描述
Query Belgian railway (NMBS/SNCB) schedules via the irail CLI. Use when the user wants train departures, connections between stations, train compositions, or...
使用说明 (SKILL.md)

irail-cli

CLI for Belgian railways (NMBS/SNCB) via iRail API. No authentication required.

Quick Start

# Station departures
irail liveboard Brugge

# Find connections
irail connections Brugge Leuven

# Check disruptions
irail disturbances

Authentication

None required. iRail API is public and free to use.

Core Rules

  1. Always use --json when parsing output programmatically
  2. Station names are flexible - accepts partial matches, quotes for multi-word
  3. Time format - HH:MM (24-hour), date format YYYY-MM-DD
  4. Language options - nl, fr, en, de (default: nl)

Output Formats

Flag Format Use case
(default) Table User-facing with colors
--json JSON Agent parsing, scripting

Colors indicate: red = delays, yellow = platform changes.

Workflows

Liveboard (Departures/Arrivals)

# Departures from station
irail liveboard Brugge
irail liveboard "Brussel-Centraal"

# Arrivals instead of departures
irail liveboard Brugge --arrivals

# Specific date/time
irail liveboard Brugge --time 09:00 --date 2025-02-15

# JSON for scripting
irail liveboard Brugge --json

# Different language
irail liveboard Brugge --lang en

Connections (Route Planning)

# Find routes
irail connections Brugge Leuven

# Specific departure time
irail connections Brugge Leuven --time 09:00

# Arrive by time (instead of depart at)
irail connections Brugge Leuven --time 14:00 --arrive-by

# More results
irail connections Brugge Leuven --results 10

# JSON for parsing
irail connections Brugge Leuven --json

Stations

# List all stations
irail stations

# Search stations
irail stations --search bruss
irail stations --search gent

# JSON for scripting
irail stations --json

Vehicle (Train Info)

# Show train information
irail vehicle IC1832

# Include all stops
irail vehicle IC1832 --stops

# JSON output
irail vehicle IC1832 --json

Composition (Train Cars)

# Show train composition (seats, amenities)
irail composition S51507
irail composition IC1832

# JSON for parsing
irail composition S51507 --json

Disturbances

# All current disruptions
irail disturbances

# Only planned works
irail disturbances --type planned

# Only unplanned disruptions
irail disturbances --type disturbance

# JSON for scripting
irail disturbances --json

Scripting Examples

# Get next train to destination
irail connections Brugge Leuven --json | jq -r '.[0].departure'

# Find station ID
irail stations --search "brussel" --json | jq -r '.[0].id'

# Check if delays exist on liveboard
irail liveboard Brugge --json | jq '[.[] | select(.delay > 0)] | length'

# Get platform for next departure
irail liveboard Brugge --json | jq -r '.[0].platform'

# List all disruptions
irail disturbances --json | jq -r '.[].title'

Environment Variables

Variable Description
IRAIL_LANG Default language (nl, fr, en, de)
IRAIL_JSON Default to JSON output
NO_COLOR Disable colored output

Language Options

Code Language
nl Dutch (default)
fr French
en English
de German
irail liveboard Brugge --lang fr
irail connections Brugge Leuven --lang en

Command Reference

Command Description
liveboard Station departures/arrivals
connections Route planning between stations
stations List/search stations
vehicle Train information and stops
composition Train car composition
disturbances Service disruptions
completion Shell completions

Common Patterns

Check if train is delayed

irail vehicle IC1832 --json | jq '.delay // 0'

Get connection with transfers

irail connections Brugge Leuven --json | jq '.[0].vias | length'

Find direct trains only

irail connections Brugge Leuven --json | jq '[.[] | select(.vias == null or (.vias | length) == 0)]'

Guidelines

  • No authentication needed - API is public
  • Be mindful of API usage in loops - add delays between requests
  • Station names are case-insensitive and support partial matching
  • Delay values are in seconds (divide by 60 for minutes)

Installation

brew install dedene/tap/irail
安全使用建议
This skill is coherent with its stated purpose, but it requires installing and executing a third‑party CLI. If you plan to install: (1) review the GitHub repo (https://github.com/dedene/irail-cli) to confirm the source code and that you trust the author; (2) prefer building from source (go install) if you want to avoid adding a third‑party Homebrew tap; (3) be aware the agent will need permission to run the irail binary and network access to call the public iRail API; and (4) if you need stronger supply-chain guarantees, verify release checksums/signatures or sandbox the binary before use.
功能分析
Type: OpenClaw Skill Name: irail Version: 1.0.1 The skill bundle is designed to query Belgian railway schedules using the `irail-cli` tool. All instructions in `SKILL.md` are focused on the legitimate use of `irail` and `jq` for parsing its output. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection attempts against the agent to perform unauthorized actions. The installation methods are standard, and the commands demonstrated are benign and aligned with the stated purpose.
能力评估
Purpose & Capability
Name/description (Belgian railway queries) match the declared requirements: the skill needs the irail CLI and optionally jq. No unrelated credentials, files, or services are requested.
Instruction Scope
SKILL.md only instructs running the irail CLI and (optionally) jq, and to prefer --json for machine parsing. It does not ask the agent to read unrelated files, exfiltrate data, or access unrelated environment variables.
Install Mechanism
Install options are a third‑party Homebrew tap (dedene/tap) or a Go package from GitHub (github.com/dedene/irail-cli). Both are reasonable for a CLI but involve pulling code from external sources; the brew tap is not an official core formula so verify the tap/author if you require higher assurance.
Credentials
The skill declares no required credentials. SKILL.md documents optional environment variables (IRAIL_LANG, IRAIL_JSON, NO_COLOR) that are appropriate for a CLI tool and proportional to its functionality.
Persistence & Privilege
The skill does not request always:true and is user-invocable only. It does not modify other skills or system-wide settings in its instructions.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install irail
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /irail 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Added license, homepage, and author metadata to SKILL.md. - Introduced explicit version ("1.1.0") in the metadata block. - Declared OpenClaw requirements for binaries and installation methods (brew and go). - Appended an Installation section with brew instructions at the end of SKILL.md. - No changes made to CLI usage, workflows, or command documentation.
v1.0.0
- Initial release of irail-cli: a command-line tool for querying Belgian railway (NMBS/SNCB) schedules, connections, train info, and disruptions via the iRail API. - Supports features like live station departures/arrivals, connection planning, train compositions, and real-time/upcoming disturbances. - No authentication required; API is public and free to use. - Flexible station search, multi-language output (Dutch, French, English, German), and multiple formats (colored table or JSON). - Includes scripting examples and common jq patterns for advanced usage.
元数据
Slug irail
版本 1.0.1
许可证
累计安装 2
当前安装数 2
历史版本数 2
常见问题

Irail 是什么?

Query Belgian railway (NMBS/SNCB) schedules via the irail CLI. Use when the user wants train departures, connections between stations, train compositions, or... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 681 次。

如何安装 Irail?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install irail」即可一键安装,无需额外配置。

Irail 是免费的吗?

是的,Irail 完全免费(开源免费),可自由下载、安装和使用。

Irail 支持哪些平台?

Irail 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Irail?

由 dedene(@dedene)开发并维护,当前版本 v1.0.1。

💬 留言讨论