← Back to Skills Marketplace
davestarling

ADS-B Overhead

by davestarling · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1726
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install moltbot-adsb-overhead
Description
Notify when aircraft are overhead within a configurable radius using a local ADS-B SBS/BaseStation feed (readsb port 30003). Use when setting up or troubleshooting plane-overhead alerts, configuring radius/home coordinates/cooldowns, or creating a Clawdbot cron watcher that sends WhatsApp notifications for nearby aircraft.
Usage Guidance
This skill appears to do exactly what it claims: monitor a local SBS/readsb TCP feed and send WhatsApp alerts via your Clawdbot CLI. Before installing/running: 1) Confirm your SBS host/port are correct and that the feed is local/trusted (the script will connect to whatever --host you supply). 2) Review and set ~/.clawdbot/adsb-overhead/config.json and use secure file permissions (example uses chmod 600). 3) Ensure the clawdbot CLI is installed and available to cron (the notifier calls it via subprocess). 4) Be aware the skill will make outbound HTTP(S) requests only if you enable enrichment or photos (tar1090 URL and Planespotters API). 5) Note a minor code oddity: the image download allowlist checks for the substring "plnspttrs.net" which looks like a typo/abbreviated domain and may prevent photo downloads even when enabled — this is not malicious but you may want to review/adjust that check if you expect photos. If you want a stricter security posture, disable photo/enrichment features and run the checker manually to validate behavior before adding it to cron.
Capability Analysis
Type: OpenClaw Skill Name: moltbot-adsb-overhead Version: 1.0.0 The OpenClaw AgentSkills skill bundle is designed to detect overhead aircraft from a local ADS-B feed and send notifications via Clawdbot messaging. All file system, network, and process execution operations (e.g., connecting to local TCP feed, fetching data from planespotters.net, executing local Python scripts, and using the `clawdbot message send` CLI) are directly aligned with this stated purpose. There is no evidence of intentional harmful behavior such as data exfiltration, unauthorized command execution, persistence mechanisms, or malicious prompt injection attempts against the agent in SKILL.md or README.md. The `download_image` function in `sbs_overhead_check.py` includes a URL allowlist and size limits, demonstrating a focus on security.
Capability Assessment
Purpose & Capability
Name/description match the code and runtime instructions: scripts connect to a local SBS/BaseStation TCP feed, compute distances, apply cooldowns, optionally enrich from a local tar1090/readsb JSON URL, optionally query Planespotters for photos, and send notifications via the Clawdbot CLI. No unrelated credentials, binaries, or installs are requested.
Instruction Scope
SKILL.md and the scripts limit actions to the stated task: connect to a configured SBS TCP host/port, read optional aircraft JSON, fetch optional photos, persist per-aircraft state under ~/.clawdbot/adsb-overhead, and invoke the Clawdbot CLI to send messages. The instructions do not request arbitrary file reads, environment secrets, or external endpoints outside the described enrichment/photo APIs.
Install Mechanism
No install spec is present (instruction-only installation). Code files are included but there is no download-from-URL or package install step; nothing will be written to system locations except the state/photo directories under the user's home when run.
Credentials
The skill requests no environment variables or credentials. It does read and write files under the user's home (~/.clawdbot/adsb-overhead) which is appropriate for local configuration/state. It performs outbound network requests to configured aircraftJsonUrl (often local) and to Planespotters' public API; if you do not want outbound internet access for these lookups, disable photo/enrichment options.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or system-wide agent settings. It persists only its own state and optional photo cache under ~/.clawdbot which is expected for a cron-style watcher.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install moltbot-adsb-overhead
  3. After installation, invoke the skill by name or use /moltbot-adsb-overhead
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the adsb-overhead skill. - Detects nearby aircraft using a local readsb SBS/BaseStation TCP feed. - Configurable home coordinates, radius, alert cooldown, and listen time. - Designed for periodic (cron) checks and WhatsApp notifications via Clawdbot. - Persists alert state to a local JSON file to avoid duplicate notifications.
Metadata
Slug moltbot-adsb-overhead
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ADS-B Overhead?

Notify when aircraft are overhead within a configurable radius using a local ADS-B SBS/BaseStation feed (readsb port 30003). Use when setting up or troubleshooting plane-overhead alerts, configuring radius/home coordinates/cooldowns, or creating a Clawdbot cron watcher that sends WhatsApp notifications for nearby aircraft. It is an AI Agent Skill for Claude Code / OpenClaw, with 1726 downloads so far.

How do I install ADS-B Overhead?

Run "/install moltbot-adsb-overhead" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ADS-B Overhead free?

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

Which platforms does ADS-B Overhead support?

ADS-B Overhead is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ADS-B Overhead?

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

💬 Comments