Planefilter

Aviation flight lookup — query aircraft type, equipment changes, and confidence scoring for any flight number. Use when: looking up flight aircraft, checking...

Security Scan

The skill's code, instructions, and requirements align with its stated purpose (flight/aircraft lookup); it only needs Node and a RapidAPI key to call AeroDataBox (plus optional AirLabs/OpenSky) and does not request unrelated access.

Purpose & Capability

Name/description (aircraft lookup) match the code and runtime instructions. Required binaries (node) and the declared primaryEnv (RAPIDAPI_KEY) are appropriate for calling AeroDataBox via RapidAPI. Optional AIRLABS_KEY is documented and used for an additional data source.

Instruction Scope

SKILL.md instructs running the included Node scripts and only references the declared env vars and expected endpoints. The scripts perform HTTP(S) calls to OpenSky, AeroDataBox (RapidAPI host), and AirLabs only; they do not read local files, access other environment secrets, or send data to unexpected endpoints.

Install Mechanism

Install spec only suggests installing Node via Homebrew (well-known package manager). No downloads from arbitrary URLs or archive extraction are present. The package.json has no external dependencies.

Credentials

Only RAPIDAPI_KEY is required (primaryEnv) and AIRLABS_KEY is optional. Those credentials are directly relevant to the described external APIs. There are no additional unrelated credential or config requests.

Persistence & Privilege

Skill does not request always:true and does not modify other skills or system-wide settings. It runs on-demand and uses only its own scripts; autonomous invocation is allowed by platform default but is not privileged here.

Assessment

This skill appears internally consistent and only performs network queries to OpenSky, AeroDataBox (via RapidAPI), and optionally AirLabs. Before installing: (1) create a dedicated RapidAPI key (do not reuse highly privileged keys) and monitor your RapidAPI quota; (2) be aware that queries (flight numbers/dates) are sent to third-party services — do not submit sensitive/private data; (3) if you need extra assurance, run the included health_check.js locally to verify behavior and inspect the scripts yourself (they are short, zero-dependency, and visible). If you do not trust RapidAPI or AirLabs, do not provide those keys.

PlaneFilter — Flight Aircraft Type Lookup

Look up aircraft type, equipment changes, and confidence scoring for any flight by querying multiple aviation data sources (OpenSky, AeroDataBox, AirLabs) and merging results with weighted confidence scoring.

Prerequisites

Required

• Node.js (v18+)
• RAPIDAPI_KEY — Subscribe to AeroDataBox on RapidAPI (free Basic plan: 150 req/month)

Optional (more data sources)

• AIRLABS_KEY — Get from AirLabs (free: 150 req/month)

Commands

1. Search Flight

node {baseDir}/scripts/search_flight.js --flight=CI101 [--date=2026-03-22]

Required env: RAPIDAPI_KEY Optional env: AIRLABS_KEY (adds another data source for higher confidence)

2. Health Check

node {baseDir}/scripts/health_check.js

Verifies all API keys are set and reachable. Shows which data sources are available.

Output Format

search_flight.js outputs JSON to stdout:

{
  "flightNumber": "CI101",
  "date": "2026-03-22",
  "airline": "China Airlines",
  "origin": "NRT",
  "destination": "TPE",
  "aircraftType": "A333",
  "registration": "B-18311",
  "confidence": 0.6,
  "equipmentChange": null,
  "typeDistribution": { "A333": 1 },
  "sources": ["aerodatabox"]
}

Output Interpretation

When presenting results to the user, follow these rules:

Field	How to Interpret
confidence ≥ 0.8	High confidence — present the aircraft type directly
confidence 0.5–0.8	Medium — mention "likely" or "most probable"
confidence < 0.5	Low — warn that data is uncertain, show typeDistribution
equipmentChange not null	⚠️ Important — Highlight this! The actual aircraft differs from the scheduled one. Show from, to, and changeType (upgrade/downgrade/lateral)
typeDistribution	Shows agreement across sources. Multiple entries = sources disagree
sources empty	No data found — suggest trying a different date

Note on aircraft type codes: The script automatically normalizes model names (e.g. "Airbus A330-300" → "A333") and filters invalid typecodes. In rare cases, an unrecognized model name may pass through as-is.

How It Works

1. Parallel query — Hits OpenSky (free, no key) + AeroDataBox (RapidAPI) + AirLabs (optional) simultaneously
2. Confidence scoring — Weighted votes from each source (AeroDataBox 0.9, OpenSky 0.7, AirLabs 0.6)
3. Equipment change detection — If scheduled aircraft ≠ actual aircraft, classifies as Upgrade/Downgrade/Lateral

Troubleshooting

Error	Cause	Fix
RAPIDAPI_KEY not set	Missing env var	export RAPIDAPI_KEY=your_key or set in ~/.openclaw/openclaw.json
403 from AeroDataBox	Invalid or expired key	Check your RapidAPI subscription
No flight data found	Flight not in any database	Try with a different date or a major airline flight