Skip to main content
skill CX Codex

odjazdy — Claude Code skill for transit departures

The odjazdy Claude Code skill finds stops and upcoming bus or tram departures in Gdańsk, Poznań, and Szczecin. Ask about a stop by name or ID to check its board.

MIT ★ 60 updated 2026-11-15

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install odjazdy@polskie-skille
Open on GitHub

What odjazdy does

The skill looks up stops and retrieves bus and tram departures from local transport services. It labels real-time predictions, timetable entries, and canceled services, and flags stale data. Coverage is limited to Gdańsk, Poznań, and Szczecin; it does not plan routes or handle ticket purchases.

Python 3.8+ and internet access are required for stop and departure lookups. Run the script with python3 scripts/odjazdy.py; on Windows, use py. Find a stop with stops first, then pass its ID to departures. GPS lookup is unavailable in Poznań, and PEKA stop searches may need Polish diacritics.

Gdańsk and Szczecin provide source times in UTC, while PEKA uses local time. The skill handles these formats and flags stale information. Szczecin requests are limited to 100 per minute per IP.

What it helps with

  • find a stop by name in Gdańsk, Poznań, or Szczecin
  • check upcoming departures for a stop or line
  • tell a live prediction from a timetable entry
  • spot canceled services and stale stop data

Example prompts for the agent

  • Find stops for Dworzec Główny in Gdańsk and show upcoming departures.
  • Look up Rondo Kaponiera in Poznań and list departures for line 3.
  • Show departures and messages for stop 10822 in Szczecin.

How to install odjazdy

1Plugin marketplace

/plugin marketplace add b44x/ai-polish-skills
/plugin install odjazdy@polskie-skille

This installs the whole odjazdy plugin with all its skills

2Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill odjazdy -a claude-code

3Manually: put the files in place

~/.claude/skills/odjazdy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/odjazdy/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about odjazdy

How do I install odjazdy in Claude Code?

Add the marketplace with /plugin marketplace add b44x/ai-polish-skills, then install the skill with /plugin install odjazdy@polskie-skille.

What does odjazdy do?

It finds stops and shows bus or tram departures in Gdańsk, Poznań, and Szczecin. Results distinguish live predictions, scheduled services, cancellations, and stale data.

What does odjazdy need to run?

Stop and departure lookups require Python 3.8+ and internet access to reach transport services. No external API key is required.

Source text

SKILL.md · MIT
---
name: odjazdy
display_name: Odjazdy — Gdańsk, Poznań i Szczecin
version: 1.0.0
description: >-
  Find public transport stops and upcoming bus or tram departures in Gdańsk, Poznań and Szczecin using transport operators' public services. Use for "kiedy tramwaj", "odjazdy z przystanku", "opóźnienie autobusu". Distinguishes realtime predictions, schedules, canceled services and stale data. Coverage is limited to the three supported networks; no route planning or ticket purchases.
category: utilities
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: ZTM Gdańsk, ZTM Poznań (PEKA), ZDiTM Szczecin
source_type: official_api
official: true
homepage: https://www.zditm.szczecin.pl/pl/zditm/dla-programistow
documentation: https://www.zditm.szczecin.pl/pl/zditm/dla-programistow/api-tablice-odjazdow
rate_limit: Szczecin 100 requests/minute/IP; one-shot lookups, upstream HTTP cache honored
last_verified: 2026-11-05
tags:
  - odjazdy
  - komunikacja-miejska
  - autobus
  - tramwaj
  - gdansk
  - poznan
  - szczecin
compatibility: Python 3.8+ (standard library only); internet access required except cities.
---

# Public transport departures

## Running the script

Run `python3 scripts/odjazdy.py <command>` from this skill's directory (`py` on Windows).

| Command | Purpose |
|---|---|
| `cities` | Supported networks, sources and capabilities; works offline |
| `stops Gdańsk --query "Dworzec Główny"` | Find individual stop poles/platforms by name |
| `stops Szczecin --lat 53.4285 --lon 14.5528 --limit 5` | Nearest stops by straight-line distance |
| `stops Poznań --query "Rondo Kaponiera"` | PEKA stops and directions; GPS lookup is not supported in Poznań |
| `departures gdansk 2001 --limit 5` | Departure board for an identifier returned by `stops` |
| `departures poznan RKAP71 --line 3` | One line's departures; use `id`, not `public_code` |
| `departures szczecin 10822` | ZDiTM departures and messages |

## Choosing a stop and interpreting results

1. Resolve city, stop name and direction. Call `stops` first, then `departures` with `id`. Several matches usually mean different poles/platforms or directions; do not arbitrarily choose the other side of the street. City names accept Polish diacritics or ASCII spelling. PEKA uses provider suggestions and may require diacritics in stop names.
2. Show the line, direction, time and status of each service. `realtime` means a provider prediction, `scheduled` means a timetable entry and `canceled` means a canceled service. Do not guarantee arrival times. Include `messages` and `warnings`.
3. ISO timestamps from Gdańsk/Szczecin are UTC with `Z`; display them in Europe/Warsaw, accounting for date and daylight-saving changes. `fetched_at` is retrieval time; `source_updated_at` is source time. Explicitly flag `freshness: stale` or `measurement_stale: true`. An absent source timestamp means `freshness: unknown`.
4. **PEKA uses a distinct time format:** `scheduled_local` contains Europe/Warsaw local time. The provider appends `Z` to a local clock reading, so do not interpret `provider_departure_raw` as valid UTC. For realtime services, prefer `minutes`; `estimated_at` is an approximation derived from those minutes and the server clock. PEKA does not publish the last measurement time: freshness remains unknown even with `realtime`.
5. `usable_realtime` is true only for a board with confirmed fresh time, a non-canceled service and no detected stale position. False alone does not turn a scheduled service into a cancellation.
6. An empty board (`no_departures`) reflects the provider's time window and filters. It does not mean no service exists for the whole day. The nearest stop is not necessarily the best route; the skill does not plan transfers or buy tickets.

## Sources and limits

Coverage is limited to **three networks: Gdańsk, Poznań and Szczecin**, including suburban stops present in their data. Do not claim nationwide coverage. The Gdańsk catalogue may contain other operators' stops with empty ZTM boards. Kraków and other cities have no adapters in this version.

Cite the source and data time, and identify the transformation (field normalization, filtering and any distance/minute calculations). Gdańsk: CC BY; Szczecin: CC0 1.0; Poznań: reuse terms require source, update and transformation information. Read [references/providers.md](references/providers.md) for provider details and links.

The script honors HTTP `Cache-Control` and `ETag`. Without HTTP guidance, the Gdańsk catalogue is cached for an hour and departure boards are not cached. `ODJAZDY_CACHE_DIR` overrides the cache directory. A network failure does not return an old board as current. Do not start frequent background polling for an ordinary departure request.

## Output and exit codes

Success: JSON on stdout, exit `0`. Errors: JSON on stderr, exit `2` for a missing stop/resource, `64` for invalid arguments or an unsupported city, or `69` for API/network/format errors. `--help` and `-h` return `0`.

© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills

Similar skills

All skills for Notes, tasks and projects →
microsoft-outlook membrane A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that connects agents to Microsoft Outlook through Membrane. Covers email, calendar, contacts, tasks, and groups — auth handled server-side. CX Codex +1 2,500installs jira-communication Netresearch DTT GmbH The jira-communication skill uses CLI scripts to search Jira issues and update their fields, status, comments, or worklogs. It also responds to Jira requests that don't include an issue key. CX Codex +1 588installs pp-resend Giuliano Giacaglia pp-resend queries Resend data from the agent: pulls recipient history, inspects email delivery timelines, and checks domain health. CX Codex +1 256installs zero-hallucination-coder Alireza Rezvani zero-hallucination-coder runs an engineering loop across five strict phases to prevent invented APIs, broken imports, and bloated code. Ideal for schema changes, auth rewrites, and multi-file tasks. CX Codex +1 69installs alliance-prioritization Maya-Beth Finotti alliance-prioritization is a Claude Code skill that ranks strategic partners by value, effort, and risk. It activates when a team must choose among several named candidates. CX Codex +1 17,600installs affiliate-recruitment-outreach Maya-Beth Finotti affiliate-recruitment-outreach — a skill for Claude Code, Codex, Cursor, and other platforms that drafts outreach copy and a full sequence plan for actively recruiting affiliates into a commission-based program. CX Codex +1 17,500installs

From the same set52

The whole set →
inpost This Claude Code skill tracks InPost parcels and finds parcel lockers and pickup points in Poland. It runs on requests about delivery status, a locker address, or nearby locations. CX Codex +1 ★ 60repo stars nbp The nbp skill for Claude Code retrieves Narodowy Bank Polski exchange rates and gold prices. It handles currency conversions and invoice tax calculations in PLN. CX Codex +1 ★ 60repo stars filmweb This Claude Code skill retrieves film and TV details from Filmweb. It activates for title or link searches and questions about cast, ratings, release dates, or VOD. CX Codex +1 ★ 60repo stars dzialki The dzialki Claude Code skill finds Polish cadastral parcels through ULDK. Search by a full EGiB identifier, cadastral district and parcel number, or a point’s coordinates. CX Codex +1 ★ 60repo stars biala-lista biala-lista is a Claude Code skill that checks Polish companies and VAT status by NIP or REGON. It runs on requests to verify a contractor, bank account, or Polish invoice. CX Codex +1 ★ 60repo stars terminy The terminy skill for Claude Code calculates Polish working days, public holidays and deadlines. It handles questions about payment dates, tax schedules and monthly working-time norms. CX Codex +1 ★ 60repo stars nieruchomosci The nieruchomosci Claude Code skill searches Poland’s RCN register for property transactions. Set a coordinate area and filter records by deed date, market, or size. CX Codex +1 ★ 60repo stars sejm This Claude Code skill queries the Polish Sejm’s official API. The agent uses it to look up MPs, voting records, bills and parliamentary interpellations. CX Codex +1 ★ 60repo stars

Project sponsors

Companies that keep this analytics open