ISS Position

SkillDev tools

Fetch the current ISS latitude and longitude from the WhereTheISS API and return standardized payloads.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ISS Position skill

What this skill tells your AI

The instructions your AI receives, as published by hybridaione/hybridclaw in skills/iss-position/SKILL.md and read by ahel’s review.

Fetch the ISS latitude and longitude with a deterministic Python script that matches this repository's existing get_iss_position tool behavior.

Quick Start

  1. Run:
python3 skills/iss-position/scripts/get_iss_position.py --format text
  1. For machine-readable output, run:
python3 skills/iss-position/scripts/get_iss_position.py --format json

Script Contract

Script path: skills/iss-position/scripts/get_iss_position.py

Behavior:

  1. Call https://api.wheretheiss.at/v1/satellites/25544.
  2. Use a default timeout of 15 seconds (override with --timeout).
  3. Validate latitude and longitude as numeric values.
  4. Return either:
{"status":"success","latitude":12.34,"longitude":56.78,"message":"The ISS is currently at latitude 12.34 and longitude 56.78."}

or:

{"status":"error","message":"Failed to retrieve ISS position."}

or:

{"status":"error","message":"ISS API returned invalid latitude/longitude values"}

Notes

  • Network access is required to fetch live ISS coordinates.
  • Use --format text for human-readable output and --format json for downstream tooling.
  • Use --timeout to adjust request timeout when needed.

Signals

GitHub stars
132
Forks
12
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
iss-position
Source
github.com/hybridaione/hybridclaw