SKILL.md
Flight Tracker Skill
"Where's that flight right now?" has a genuinely open answer: hobbyist ADS-B receiver networks share live aircraft transponder data keylessly — adsb.lol serves it clean, OpenSky backs it up. This skill queries by callsign, hex, or area, and translates transponder math into human answers ("over Poland at 38,000 ft, ~40 minutes from Warsaw-ish airspace"). It's equally honest about the boundary: this is positions, not airline operations — gate changes, delays, and cancellations live in keyed commercial services, and pretending otherwise produces confident fiction.
What This Skill Produces
- The position — where the aircraft is now: location in words, altitude, ground speed, heading, climb/descent
- The overhead list — aircraft above/near a point, sorted by distance
- The interpretation — cruise vs. descent, direction of travel, rough progress — labeled as inference from position data
- The command — exact curl, rerunnable — and the boundary line when the question was schedule-shaped
Required Inputs
Ask for these if not provided:
- The identifier — callsign (what ATC uses:
BAW123, often ≈ flight number with the airline's ICAO prefix — BA→BAW, LH→DLH, UA→UAL; do the mapping and say so), registration/tail number, or ICAO hex - Or the place — lat/lon for "what's overhead" questions, with a radius
- What they actually want — position/curiosity vs. "is it delayed / when does it land" — the second gets the honest redirect plus what positions can infer
Framework: The Network and the Boundary
- adsb.lol — primary: by callsign:
curl -s "https://api.adsb.lol/v2/callsign/BAW123"· by registration:.../v2/reg/G-XLEB· by hex:.../v2/hex/4075a2· overhead:.../v2/lat/51.5/lon/-0.12/dist/25(nm). Fields per aircraft:flight(callsign),alt_baro(ft),gs(knots),track(° heading),baro_rate(ft/min climb/descent), , (type).
