← Back to Skills Marketplace
copey02

Flight Tracker

by copey02 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2239
Downloads
0
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install aviationstack-flight-tracker
Description
Track flights in real-time with detailed status, gate info, delays, and live position. Use when user asks to track a flight, check flight status, look up flight information by flight number (e.g., "track AA100", "what's the status of United 2402", "check my flight BA123"), or wants to display flight data in a formatted view similar to Flighty app.
README (SKILL.md)

Flight Tracker

Track any flight worldwide using AviationStack API and display in a clean, Flighty-style format.

Quick Start

Track a flight by its IATA code:

scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123

First-Time Setup

Before using this skill, you need an API key (one-time setup):

  1. Get a free API key at https://aviationstack.com/signup/free (100 requests/month)
  2. Set environment variable: 
    export AVIATIONSTACK_API_KEY='your-key-here'
  3. Install dependencies: 
    pip3 install requests

For detailed setup instructions, see api-setup.md.

Output Format

The skill displays flight information in a clean, readable format with:

  • ✈️ Airline and flight number
  • 🛩️ Aircraft type and registration
  • 🛫 Departure airport, terminal, gate, times
  • 🛬 Arrival airport, terminal, gate, times
  • 📊 Flight status with visual indicators
  • ⏱️ Delay calculations (if applicable)
  • 🌐 Live position, altitude, speed (when airborne)

Status indicators:

  • 🟢 Active/Airborne/En-route
  • ✅ Landed/Arrived
  • 🟡 Scheduled
  • 🟠 Delayed
  • 🔴 Cancelled

Advanced Usage

Get raw JSON data:

scripts/track_flight.py AA100 --json

Check help:

scripts/track_flight.py --help

Workflow

When a user asks to track a flight:

  1. Extract the flight number from the request
  2. Run the tracking script with the flight number
  3. Present the formatted output to the user
  4. If data is needed for further processing, use --json flag

Flight Number Formats

Accept IATA flight codes:

  • AA100 (American Airlines)
  • UA2402 (United)
  • BA123 (British Airways)
  • DL456 (Delta)

The script automatically converts to uppercase and handles the lookup.

Error Handling

The script handles common errors:

  • Missing API key → Shows setup instructions
  • Flight not found → Suggests verification
  • API errors → Displays error message
  • Rate limit exceeded → Indicates limit reached

API Limits

Free tier: 100 requests/month. Track usage to stay within limits. For heavy usage, consider upgrading or alternative APIs (see references/api-setup.md).

Notes

  • Uses AviationStack free tier (no HTTPS on free plan)
  • Real-time data updated frequently
  • Historical flight data available
  • Worldwide coverage (250+ countries, 13,000+ airlines)
Usage Guidance
Summary and recommendations: - What doesn't add up: the metadata does not declare the required AVIATIONSTACK_API_KEY, but both SKILL.md and scripts/track_flight.py require it. Ask the publisher to update the metadata to declare AVIATIONSTACK_API_KEY as the primary credential before installing. - Transport risk: the script calls AviationStack over HTTP (http://api.aviationstack.com). On the free tier your API key and request data would be sent in plaintext and could be exposed on the network. If you must use this skill, prefer not to store the API key in persistent shell profiles; set it in the session only, or use a paid tier/alternative API that supports HTTPS. - Code review: the included Python script is short and only reads the environment variable, calls the AviationStack API, and prints results — it does not appear to contact other endpoints or exfiltrate unrelated files. Still, run it in a sandbox or inspect it yourself before use. - Alternatives: consider APIs that offer HTTPS on free tiers (OpenSky, or paid AviationStack tiers), or ask the developer to switch the script to HTTPS or proxy requests through a secure endpoint. - Final advice: treat this as usable but imperfect — don’t add the API key to permanent shell startup files until you accept the plaintext-transport risk and confirm the metadata/manifest is corrected.
Capability Analysis
Type: OpenClaw Skill Name: aviationstack-flight-tracker Version: 1.0.0 The skill is classified as suspicious primarily due to the unencrypted transmission of the user's `AVIATIONSTACK_API_KEY` over HTTP, as observed in `scripts/track_flight.py`. While the `SKILL.md` and `references/api-setup.md` documentation explicitly disclose that the free tier of the AviationStack API does not support HTTPS, sending an API key in plaintext over the network is a significant security risk. This constitutes a risky capability that could lead to credential compromise if network traffic is intercepted, even if the intent is to use a legitimate API endpoint.
Capability Assessment
⚠ Purpose & Capability
The SKILL.md and script clearly use the AviationStack API and require an AVIATIONSTACK_API_KEY; that is coherent with the stated purpose. However, the registry metadata lists no required environment variables or primary credential — an omission that is inconsistent with the skill's runtime requirements and should be corrected.
⚠ Instruction Scope
Runtime instructions are narrowly scoped to extracting a flight number, running scripts/track_flight.py, and presenting results; the script only reads the AVIATIONSTACK_API_KEY env var and calls the AviationStack endpoint. However, both SKILL.md and references explicitly state the free tier uses HTTP (no HTTPS) and the script uses http://api.aviationstack.com — this means your API key and requests would be transmitted in plaintext on the network, which is a security risk.
✓ Install Mechanism
There is no install spec that downloads arbitrary code; the skill includes a small Python script and instructs installing the widely used 'requests' package via pip. This is low-risk compared with remote download/extract installers.
⚠ Credentials
Only one credential (AVIATIONSTACK_API_KEY) is needed, which is proportionate for the stated functionality — but the registry metadata fails to declare it (primaryEnv is none). That mismatch reduces transparency. Additionally, because the free-tier API uses HTTP, supplying the key exposes it to network interception.
✓ Persistence & Privilege
The skill does not request permanent presence (always=false) and does not modify other skill or system configs. It runs as a simple script when invoked, so no elevated persistence or privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install aviationstack-flight-tracker
  3. After installation, invoke the skill by name or use /aviationstack-flight-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of flight-tracker skill. - Track any commercial flight worldwide in real-time using AviationStack API. - Provides detailed status, gate/terminal info, live airplane position, and delay calculations. - Presents information in a clear, formatted style modeled after the Flighty app. - Easy setup with free API key and simple command-line usage. - Supports output as formatted text or raw JSON for integrations. - Robust error handling and support for most IATA flight numbers.
Metadata
Slug aviationstack-flight-tracker
Version 1.0.0
License —
All-time Installs 6
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Flight Tracker?

Track flights in real-time with detailed status, gate info, delays, and live position. Use when user asks to track a flight, check flight status, look up flight information by flight number (e.g., "track AA100", "what's the status of United 2402", "check my flight BA123"), or wants to display flight data in a formatted view similar to Flighty app. It is an AI Agent Skill for Claude Code / OpenClaw, with 2239 downloads so far.

How do I install Flight Tracker?

Run "/install aviationstack-flight-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Flight Tracker free?

Yes, Flight Tracker is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Flight Tracker support?

Flight Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Flight Tracker?

It is built and maintained by copey02 (@copey02); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments