Works with Paperclip
How Korea Weather fits into a Paperclip company.
Korea Weather drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.
S
SaaS FactoryPaired
Pre-configured AI company — 18 agents, 18 skills, one-time purchase.
$27$59
Explore packSource file
SKILL.md101 linesExpandCollapse
---name: korea-weatherdescription: 한국 날씨를 기상청 단기예보 조회서비스와 프록시 경유로 조회해 요약한다.license: MITmetadata: category: weather locale: ko-KR phase: v1--- # Korea Weather ## What this skill does 기상청 단기예보 조회서비스를 `k-skill-proxy` 경유로 조회해서 한국 날씨를 요약한다.사용자는 개인 OpenAPI key를 직접 발급할 필요가 없고, proxy 서버에만 `KMA_OPEN_API_KEY` 를 둔다. ## When to use - "서울 시청 근처 지금 날씨 어때?"- "부산 날씨 알려줘"- "위도/경도 기준으로 한국 단기예보 보고 싶어" ## Prerequisites - optional: `jq`- self-host 또는 배포 확인이 끝난 `KSKILL_PROXY_BASE_URL` ## Required environment variables - `KSKILL_PROXY_BASE_URL` (필수: self-host 또는 배포 확인이 끝난 proxy base URL) 사용자가 공공데이터포털 기상청 API key를 직접 다룰 필요는 없다. 대신 `/v1/korea-weather/forecast` route가 실제로 올라와 있는 proxy URL 을 `KSKILL_PROXY_BASE_URL` 로 받는다. upstream `KMA_OPEN_API_KEY` 는 proxy 서버에서만 관리한다. ## Inputs - 격자 좌표: `nx`, `ny`- 또는 위도/경도: `lat`, `lon`- 선택 사항: `baseDate`, `baseTime` `baseDate` / `baseTime` 을 생략하면 proxy 가 KST 기준 최신 단기예보 발표 시각을 자동으로 고른다. ## Workflow ### 1. Resolve the proxy base URL `KSKILL_PROXY_BASE_URL` 로 self-host 또는 배포 확인이 끝난 proxy base URL 을 확인한다. ### 2. Query the short-term forecast endpoint 격자 좌표가 이미 있으면 그대로 넣고, 위도/경도만 있으면 proxy 에 그대로 넘긴다. ```bashcurl -fsS --get 'https://your-proxy.example.com/v1/korea-weather/forecast' \ --data-urlencode 'lat=37.5665' \ --data-urlencode 'lon=126.9780'``` 격자 좌표 예시: ```bashcurl -fsS --get 'https://your-proxy.example.com/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 - `KSKILL_PROXY_BASE_URL` 이 비어 있거나 weather 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` 를 참고한다.