CtrlK
BlogDocsLog inGet started
Tessl Logo

oebb-scotty

Austrian rail travel planner (ÖBB Scotty). Use when planning train journeys in Austria, checking departures/arrivals at stations, or looking for service disruptions. Covers ÖBB trains, S-Bahn, regional trains, and connections to neighboring countries.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable — complete executable curl requests, real response shapes, and a jq recipe for the worst verbosity — but it is an inlined, self-repeating single-file reference. An explicit end-to-end workflow and moving the secondary lookup tables and full response samples into reference files would tighten both token cost and navigation.

Suggestions

Add an explicit numbered workflow near the top (e.g., 1. LocMatch to resolve station `lid`s, 2. TripSearch or StationBoard with those `lid`s, 3. check the `err` field before interpreting results, 4. HimSearch for disruptions) so the multi-step sequence is written rather than implied.

Deduplicate the auth boilerplate: state it once and show curl examples with a shortened body or a shell variable, and merge the overlapping 'Product Filter Values' bit table and 'Product Classes (cls values)' table into one.

Split secondary material into one-level-deep reference files (e.g., references/stations.md for the station-ID table, references/responses.md for full response samples) so SKILL.md stays a lean overview.

DimensionReasoningScore

Conciseness

The body is dense reference material with no concept-explaining filler, but it repeats itself: the auth boilerplate block appears verbatim in the Authentication section and then again in all four curl examples, and the product-class information is duplicated across 'Product Filter Values' (bit table) and the trailing 'Product Classes (cls values)' table. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the 4 anchor, whose duplication would be only minor.

3 / 5

Actionability

Every method has a fully executable copy-paste curl command, a realistic annotated response example, parameter tables, a ready-to-use jq filter for the verbose TripSearch response, a station-ID lookup table, and time-format conventions. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The typical LocMatch → TripSearch sequence is only implied by one param-table row ('use `lid` from LocMatch') and a note on resolving `prodX`; there is no explicit step sequence tying the methods together, and the Error Handling section ('Check `err` field') is not integrated into a validate/retry loop. This fits 'sequence present but checkpoints missing or implicit' — above 2 because the Quick Reference table and per-method structure do convey the pieces, but below 4 because no explicit ordered workflow is written.

3 / 5

Progressive Disclosure

The document is well-sectioned with headers, but it is a 430-line monolithic API reference with no bundle files at all; the full response-structure samples, the station-ID table, and the duplicated product-class tables are exactly the material that would normally live in one-level-deep reference files. This matches 'Some structure but could be better organized... content that should be separate is inline' rather than 4, where most content would be appropriately placed across files.

3 / 5

Total

14

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description in third-person voice that clearly states both what the skill does and when to use it, with concrete actions and a well-defined niche. The only minor gap is a few missing natural synonyms (e.g., 'train times', 'timetable') in the trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'planning train journeys in Austria, checking departures/arrivals at stations, or looking for service disruptions' — with comprehensive coverage of the skill's capabilities (trip planning, boards, alerts). It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it is not a 4 because coverage extends beyond 1-2 actions with no meaningful gaps.

5 / 5

Completeness

Both halves are explicit: 'what' is answered by 'Austrian rail travel planner... Covers ÖBB trains, S-Bahn, regional trains, and connections to neighboring countries' and 'when' by the concrete trigger clause 'Use when planning train journeys in Austria, checking departures/arrivals..., or looking for service disruptions'. This matches the 5 anchor exactly; a 4 would require the 'when' clause to be less specific.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'planning train journeys', 'checking departures/arrivals', 'service disruptions', 'ÖBB trains, S-Bahn, regional trains' are present, matching 'Good keyword coverage; a few natural terms missing'. It falls short of 5 because common user synonyms such as 'train times', 'timetables', 'train schedules', or 'Austrian railways' are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — Austrian rail travel via ÖBB/Scotty with named products (S-Bahn, regional trains) and geography ('Austria', 'neighboring countries') — giving it a 'clear niche with distinct triggers; minimal conflict risk', exactly the 5 anchor. Lower anchors describe broader overlap risk that does not apply here.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
mitsuhiko/agent-stuff
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.