How do I install the Adsb Overhead skill?

Run npx skillmds@latest add modbender/adsb-overhead in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Adsb Overhead safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Adsb Overhead?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Adsb Overhead free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Adsb Overhead?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Adsb Overhead by modbender — Agent Skill

Name: Adsb Overhead
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Adsb 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.

modbender Updated Sep 9, 2026 12 repo stars

File contents

adsb-overhead

Detect aircraft overhead (within a radius) from a local readsb SBS/BaseStation TCP feed and notify via Clawdbot messaging.

This skill is designed for a periodic checker (cron) rather than a long-running daemon.

Quick start (manual test)

Run the checker for a few seconds to see if it detects aircraft near you:

python3 skills/public/adsb-overhead/scripts/sbs_overhead_check.py \
  --host <SBS_HOST> --port 30003 \
  --home-lat <LAT> --home-lon <LON> \
  --radius-km 2 \
  --listen-seconds 5 \
  --cooldown-min 15

If it prints lines, those are new alerts (not in cooldown).
If it prints nothing, there were no new overhead aircraft during the sample window.

How it works

Connect to the SBS feed (TCP) for --listen-seconds.
Track latest lat/lon per ICAO hex.
Compute distance to --home-lat/--home-lon (Haversine).
Emit alerts for aircraft within --radius-km only if not alerted within --cooldown-min.
Persist state to a JSON file (default: ~/.clawdbot/adsb-overhead/state.json).

SBS parsing assumptions are documented in: references/sbs-fields.md.

Create a Clawdbot watcher (cron)

Use a Clawdbot cron job to run periodically. The cron job should:

exec the script
If stdout is non-empty, message.send it via WhatsApp

Pseudocode for the agent:

Run:
- python3 .../sbs_overhead_check.py ...
If stdout trimmed is not empty:
- send a WhatsApp message with that text

Suggested polling intervals:

30–60 seconds is usually enough (given cooldowns)
Use --listen-seconds 3..8 so each run can gather a few position frames

Tuning knobs

Increase --radius-km if you want fewer misses.
Increase --listen-seconds if your feed is busy but you’re missing position updates.
Use --cooldown-min to prevent spam (15–60 minutes recommended).

---name: adsb-overheaddescription: 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.--- # adsb-overhead Detect aircraft overhead (within a radius) from a **local readsb SBS/BaseStation TCP feed** and notify via Clawdbot messaging. This skill is designed for a periodic checker (cron) rather than a long-running daemon. ## Quick start (manual test) 1) Run the checker for a few seconds to see if it detects aircraft near you: ```bash python3 skills/public/adsb-overhead/scripts/sbs_overhead_check.py \ --host <SBS_HOST> --port 30003 \ --home-lat <LAT> --home-lon <LON> \ --radius-km 2 \ --listen-seconds 5 \ --cooldown-min 15 ``` - If it prints lines, those are *new* alerts (not in cooldown). - If it prints nothing, there were no new overhead aircraft during the sample window. ## How it works - Connect to the SBS feed (TCP) for `--listen-seconds`. - Track latest lat/lon per ICAO hex. - Compute distance to `--home-lat/--home-lon` (Haversine). - Emit alerts for aircraft within `--radius-km` **only if** not alerted within `--cooldown-min`. - Persist state to a JSON file (default: `~/.clawdbot/adsb-overhead/state.json`). SBS parsing assumptions are documented in: `references/sbs-fields.md`. ## Create a Clawdbot watcher (cron) Use a Clawdbot cron job to run periodically. The cron job should: 1) `exec` the script 2) If stdout is non-empty, `message.send` it via WhatsApp Pseudocode for the agent: - Run: - `python3 .../sbs_overhead_check.py ...` - If stdout trimmed is not empty: - send a WhatsApp message with that text Suggested polling intervals: - 30–60 seconds is usually enough (given cooldowns) - Use `--listen-seconds 3..8` so each run can gather a few position frames ## Tuning knobs - Increase `--radius-km` if you want fewer misses. - Increase `--listen-seconds` if your feed is busy but you’re missing position updates. - Use `--cooldown-min` to prevent spam (15–60 minutes recommended).

Frequently asked questions