iss-position

Research

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

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/HybridAIOne/hybridclaw/blob/HEAD/skills/iss-position/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/iss-position, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

ISS Position

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

Quick Start

Run:

python3 skills/iss-position/scripts/get_iss_position.py --format text

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:

Call https://api.wheretheiss.at/v1/satellites/25544.
Use a default timeout of 15 seconds (override with --timeout).
Validate latitude and longitude as numeric values.
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.