kma-api-python-builder

What problem does it solve?

This Skill helps you implement and maintain a Python client library for the Korean Meteorological Administration (KMA) public weather APIs while preserving critical, hard-to-recall invariants such as coordinate handling, time-base selection, authentication rules, typed error mapping, and response parsing safety.

Core Features & Use Cases

• Enforces project invariants before code changes: verifies which documents to read (README, kma-api.md, docs/api-coverage.md, docs/apihub*.md, docs/datagokr.md, AGENTS.md) to prevent accidental behavior changes.
• Guarantees correct input semantics: validates that users pass either LatLon or GridPoint (or properly shaped mappings) and rejects ambiguous or mixed lat/lon vs nx/ny inputs.
• Prevents common KMA pitfalls: preserves PCP/SNO Korean range strings (no forced float conversion), applies endpoint-aware PTY mapping, ensures resultCode != "00" becomes typed exceptions, and avoids accidental credential leakage.
• Supports robust offline-first development: requires mock/fixture-based tests by default and isolates live integration tests behind explicit opt-in markers and environment variables.

Quick Start

Ask the assistant to implement and validate an update to HTTP error handling across the KmaClient, DataGoKrClient, and ApiHubClient while keeping all KMA invariants and ensuring the change is covered by offline tests.