← Back to Skills Marketplace
copey02

Flight Tracker

by copey02 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2016
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install copey-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
This skill's code matches its description and only needs an AviationStack API key, but the registry metadata omits that required env var — ask the publisher to fix the metadata. Before installing: (1) review the script yourself (it is small and readable); (2) be aware the free AviationStack tier uses HTTP (your API key and queries may be sent unencrypted) — consider a paid tier or alternative API that supports HTTPS; (3) only set AVIATIONSTACK_API_KEY in environments you trust (avoid exposing it in shared or public shells); (4) install the 'requests' Python package in an isolated environment (venv) rather than system-wide; and (5) prefer skills with a known source/homepage or contact the owner if you need provenance assurance.
Capability Analysis
Type: OpenClaw Skill Name: copey-flight-tracker Version: 1.0.0 The skill's core functionality is benign, tracking flights using the AviationStack API as described. However, the `scripts/track_flight.py` script makes API calls over unencrypted HTTP (`http://api.aviationstack.com`) to `aviationstack.com`, transmitting the `AVIATIONSTACK_API_KEY` in plain text. While this limitation of the free API tier is disclosed in `SKILL.md` and `references/api-setup.md`, sending an API key (a credential) over an unencrypted channel is a significant security risk, making the skill suspicious due to potential credential interception.
Capability Assessment
ℹ Purpose & Capability
Name, description, SKILL.md, and the included Python script all align: the skill queries AviationStack for flight data and formats it. However, the published registry metadata lists no required environment variables while the runtime instructions and script clearly require AVIATIONSTACK_API_KEY — this mismatch is an incoherence that should be corrected or explained by the publisher.
✓ Instruction Scope
Runtime instructions are narrowly scoped to extracting a flight number, calling the AviationStack API, and formatting results. The script only references the AviationStack endpoint and does not access other system files or credentials. Note: SKILL.md and the code explicitly document that the free AviationStack tier is HTTP-only (unencrypted), which is a privacy/security consideration for API key and flight queries.
ℹ Install Mechanism
There is no install spec (instruction-only skill plus a script), which limits disk persistence risk. The SKILL.md and script require the Python 'requests' package to be installed (pip3 install requests) — this dependency is reasonable but not declared in registry metadata. No downloads from unknown URLs or archive extraction are present.
⚠ Credentials
The only runtime secret required is AVIATIONSTACK_API_KEY, which is proportionate to the stated purpose. However, the skill metadata does not declare this required environment variable (registry shows 'Required env vars: none'), creating an inconsistency that could mislead users into installing without supplying the key. Additionally, because the free tier uses HTTP, the API key would be transmitted in cleartext unless the user upgrades to a paid (HTTPS) tier or uses a different API.
✓ Persistence & Privilege
The skill does not request elevated or persistent platform privileges (always:false). It does not modify other skills or system-wide settings. It is user-invocable and can be called autonomously by the agent (default), which is expected for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install copey-flight-tracker
  3. After installation, invoke the skill by name or use /copey-flight-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Real-time flight tracking with AviationStack API. Displays Flighty-style formatted output with departure/arrival times, gates, delays, and live position.
Metadata
Slug copey-flight-tracker
Version 1.0.0
License —
All-time Installs 2
Active Installs 2
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 2016 downloads so far.

How do I install Flight Tracker?

Run "/install copey-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