Korea Weather
Researchkorea-weatherKorea Weather is an Agent Skill for research published in the NomaDamas/k-skill repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
한국 날씨를 기상청 단기예보 조회서비스와 프록시 경유로 조회해 요약한다.
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.
Inspect the Agent Skill at https://github.com/NomaDamas/k-skill/blob/HEAD/korea-weather/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/korea-weather, 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.
Korea Weather
What this skill does
기상청 단기예보 조회서비스를 k-skill-proxy 경유로 조회해서 한국 날씨를 요약한다.
사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만 KMA_OPEN_API_KEY 를 둔다.
When to use
- "서울 시청 근처 지금 날씨 어때?"
- "부산 날씨 알려줘"
- "위도/경도 기준으로 한국 단기예보 보고 싶어"
Prerequisites
- optional:
jq - optional:
KSKILL_PROXY_BASE_URL(self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hostedhttps://k-skill-proxy.nomadamas.org를 사용한다.)
Required environment variables
- 없음.
KSKILL_PROXY_BASE_URL은 선택 사항이며, 비우면 기본 hostedhttps://k-skill-proxy.nomadamas.org를 사용한다.
사용자가 공공데이터포털 기상청 API key를 직접 다룰 필요는 없다. /v1/korea-weather/forecast route는 기본 hosted proxy에서 호출하고, upstream KMA_OPEN_API_KEY 는 proxy 서버에서만 관리한다. 별도 proxy를 쓰는 경우에만 KSKILL_PROXY_BASE_URL 을 설정한다.
Inputs
- 격자 좌표:
nx,ny - 또는 위도/경도:
lat,lon - 선택 사항:
baseDate,baseTime
baseDate / baseTime 을 생략하면 proxy 가 KST 기준 최신 단기예보 발표 시각을 자동으로 고른다.
Workflow
1. Resolve the proxy base URL
KSKILL_PROXY_BASE_URL 이 있으면 그 값을 사용하고, 없거나 비어 있으면 기본 hosted proxy https://k-skill-proxy.nomadamas.org 를 사용한다.
2. Query the short-term forecast endpoint
격자 좌표가 이미 있으면 그대로 넣고, 위도/경도만 있으면 proxy 에 그대로 넘긴다.
BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "${BASE}/v1/korea-weather/forecast" \
--data-urlencode 'lat=37.5665' \
--data-urlencode 'lon=126.9780'
격자 좌표 예시:
BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "${BASE}/v1/korea-weather/forecast" \
--data-urlencode 'nx=60' \
--data-urlencode 'ny=127' \
--data-urlencode 'baseDate=20260405' \
--data-urlencode 'baseTime=0500'
3. Summarize the response conservatively
가능하면 아래 항목만 먼저 요약한다.
TMP: 기온SKY: 하늘상태PTY: 강수형태POP: 강수확률PCP: 강수량SNO: 적설REH: 습도WSD: 풍속
응답에는 조회 시점과 baseDate / baseTime 도 함께 적는다.
Done when
- 요청 위치의 단기예보 응답이 정리되어 있다
- 조회 시점과 예보 발표 시각이 명시되어 있다
- upstream key가 클라이언트에 노출되지 않았다
Failure modes
- proxy upstream key 미설정 또는 hosted/self-host route 장애
nx/ny또는lat/lon이 불완전한 경우- 기상청 quota 초과 또는 upstream 장애
- 선택한 발표 시각에 아직 예보가 준비되지 않은 경우
Notes
- 공식 API는
nx/ny격자를 쓰지만, proxy 는lat/lon도 받아 내부에서 격자로 변환한다. - 단기예보 category 는
TMP,SKY,PTY,POP,PCP,SNO,REH,WSD등을 중심으로 본다. - proxy 운영/환경변수 설정은
docs/features/k-skill-proxy.md를 참고한다.