# railil

Adopt this skill: https://proskills.md/skills/other/lirantal-skill-railil

Page: https://proskills.md/skills/other/lirantal-skill-railil
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 1917
upstream: https://github.com/lirantal/skill-railil/blob/HEAD/SKILL.md

````text
---
name: railil
description: Search for Israel Rail train schedules using the railil CLI. Use when the user asks about Israeli trains, Israel Rail schedules, train routes in Israel, or mentions the railil tool. Find routes between stations with fuzzy search, filter by date/time, and output in various formats (JSON, Markdown, Table).
metadata:
  version: "0.1.0"
  homepage: "https://github.com/lirantal/railil"
  emoji: "🚆"
---

# Railil CLI

A CLI tool for checking Israel Rail train schedules.

## Installation

```bash
npm install -g railil
```

## Usage

The CLI supports fuzzy matching for station names.

### Basic Search

Search for the next trains between two stations:

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

### Date and Time

Search for a specific date and time:

```bash
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):**
```bash
railil --from "Tel Aviv" --to "Haifa" --output json
```

**Markdown Output:**
```bash
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:**
```bash
railil --from "Ben Gurion" --to "Jerusalem" --limit 3
```

**Get schedule for tomorrow morning in JSON:**
```bash
railil --from "Haifa" --to "Tel Aviv" --time 07:30 --output json
```
````

## File: README.md
upstream: https://github.com/lirantal/skill-railil/blob/HEAD/README.md

````text
# Railil Skill 🚆

> The ultimate Israel Rail schedule assistant for your AI agents.

Welcome to the **Railil Skill**! This skill empowers your AI agents (like Clawdbot) to instantly access real-time train schedules, plan routes, and find upcoming trains for Israel Rail directly from the command line. Powered by the robust [railil](https://github.com/lirantal/railil) CLI, it's designed to be fast, flexible, and agent-friendly.

## 🌟 Features

*   **Smart Station Search:** Fuzzy matching for station names means you don't need to know the exact spelling.
*   **Flexible Scheduling:** Find trains for right now, or plan ahead for specific dates and times.
*   **Agent-Optimized Output:** Supports JSON output for easy parsing by AI agents, alongside human-readable text and tables.
*   **Zero Config:** Works out of the box with `npx` or global npm installation.

## 🚀 Quick Start

This skill is designed to work seamlessly with [Clawdbot](https://clawd.bot).

### Installation via ClawdHub

You can install this skill directly using the [ClawdHub](https://clawdhub.com) CLI:

```bash
clawdhub install railil
```

### Manual Installation

Clone this repository into your skills directory:

```bash
git clone https://github.com/lirantal/skill-railil.git ./skills/railil
```

## 🎮 Usage

Once installed, your agent can invoke the `railil` command to query train data.

### 📍 Find Next Trains
Need to get somewhere fast? Find the next available trains between two cities.

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

### 📅 Plan a Trip
Checking schedules for a future date? No problem.

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

### 🤖 For Agents (JSON)
Get raw data for processing.

```bash
railil --from "Ben Gurion" --to "Jerusalem" --output json
```

## 🛠️ About Railil

This skill wraps the **railil** npm package. It's a community-driven project to make Israel Rail data accessible via the command line.

*   **NPM Package:** [railil](https://www.npmjs.com/package/railil)
*   **Source Code:** [GitHub](https://github.com/lirantal/railil)

## Contributing

Please consult [CONTRIBUTING](./CONTRIBUTING.md) for guidelines on contributing to this project.

## 👤 Author

**Liran Tal**

*   Website: [lirantal.com](https://lirantal.com)
*   GitHub: [@lirantal](https://github.com/lirantal)
*   Twitter: [@liran_tal](https://twitter.com/liran_tal)

## 🔗 Links

*   **ClawdHub:** Discover more skills at [clawdhub.com](https://clawdhub.com)
*   **Clawdbot:** The AI agent that runs this skill [clawd.bot](https://clawd.bot)

## 📄 License

This project is licensed under the **Apache-2.0 License**. See the [LICENSE](LICENSE) file for details.
````
