Railil

Search for Israel Rail train schedules using the railil CLI. Find routes between stations with fuzzy search, filter by date/time, and output in various formats (JSON, Markdown, Table).

Security Scan

The skill is internally consistent: it documents and requires the railil CLI (installed via npm) to search Israel Rail schedules and does not request unrelated credentials or system access.

Purpose & Capability

Name/description, required binary (railil), and the install instruction (npm package 'railil' producing a 'railil' binary) are coherent and proportional to the described functionality (searching Israel Rail schedules). No unrelated binaries, env vars, or config paths are requested.

Instruction Scope

SKILL.md instructs the agent to install and run the railil CLI with flags (from/to/date/time/output). It does not instruct reading arbitrary files, environment variables, or sending data to external endpoints beyond what the CLI itself does. The instructions are scoped to invoking the CLI and formatting its output.

Install Mechanism

The install uses npm (package 'railil'), which is a common and expected distribution method for a CLI. npm installs are moderate-risk compared with no-install skills because packages can contain arbitrary code; however, the manifest does not download code from arbitrary URLs or use extract-from-unknown-hosts. The SKILL.md cites a GitHub homepage (lirantal/railil) which provides traceability—verify the npm package and repository before installing.

Credentials

The skill declares no required environment variables or credentials. That is appropriate for a CLI that queries public transit schedules. There are no requests for unrelated secrets or config paths.

Persistence & Privilege

always is false and the skill does not request persistent/system-wide changes. Agent autonomous invocation is allowed (platform default) but not elevated by the skill's metadata. The skill does not attempt to modify other skills or system settings.

Assessment

This skill appears coherent: it simply wraps the 'railil' CLI distributed via npm. Before installing, confirm the npm package and GitHub repo (https://github.com/lirantal/railil) match and review the package contents and recent activity. Install in a controlled environment (or sandbox) if you have concerns. Remember npm packages can run arbitrary code on install—don't provide sensitive credentials to this skill, and if you allow autonomous agent invocation, be aware the agent could call the installed binary without additional prompts.

Railil CLI

A CLI tool for checking Israel Rail train schedules.

Installation

npm install -g railil

Usage

The CLI supports fuzzy matching for station names.

Basic Search

Search for the next trains between two stations:

railil --from "Tel Aviv" --to "Haifa"

Date and Time

Search for a specific date and time:

railil --from "Beer Sheva" --to "Tel Aviv" --time 08:00 --date 2023-11-01

Output Formats

For machine-readable output or specific formatting, use the --output flag. Supported formats: text (default), json, table, markdown.

JSON Output (Recommended for agents):

railil --from "Tel Aviv" --to "Haifa" --output json

Markdown Output:

railil --from "Tel Aviv" --to "Haifa" --output markdown

Options

• -f, --from <station>: Origin station name (fuzzy match supported).
• -t, --to <station>: Destination station name (fuzzy match supported).
• -d, --date <date>: Date of travel.
• -h, --time <time>: Time of travel (HH:MM).
• -l, --limit <number>: Limit the number of results.
• -o, --output <format>: Output format (json, text, table, markdown).
• --help: Show help message.

Examples

Find next 3 trains from Ben Gurion Airport to Jerusalem:

railil --from "Ben Gurion" --to "Jerusalem" --limit 3

Get schedule for tomorrow morning in JSON:

railil --from "Haifa" --to "Tel Aviv" --time 07:30 --output json