{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kma-weather-korea",
    "name": "기상청 날씨 (KMA Weather Korea)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sw326/kma-weather-korea",
    "canonicalUrl": "https://clawhub.ai/sw326/kma-weather-korea",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kma-weather-korea",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kma-weather-korea",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "playbook.md",
      "scripts/grid_convert.py",
      "scripts/morning_briefing.sh",
      "scripts/weather.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kma-weather-korea"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/kma-weather-korea",
    "agentPageUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "KMA Weather Forecast Skill",
        "body": "Korea Meteorological Administration short-term forecast API + AirKorea air quality integration."
      },
      {
        "title": "Overview",
        "body": "KeyValueProviderKMA (Korea Meteorological Administration)Service ID15084084Auth~/.config/data-go-kr/api_keyEndpointhttps://apis.data.go.kr/1360000/VilageFcstInfoService_2.0Playbookplaybook.md"
      },
      {
        "title": "Scripts",
        "body": "scripts/\n├── weather.sh             → Weather query (ncst/fcst/short)\n├── morning_briefing.sh    → Morning briefing (weather + air quality)\n└── grid_convert.py        → Lat/lon → grid coordinate conversion"
      },
      {
        "title": "Step 1: Identify location & time",
        "body": "\"서울 날씨\" → Seoul Jongno-gu (nx=60, ny=127)\n\"내일 날씨\" → short-term forecast (short)\n\"지금 비 와?\" → ultra-short-term observation (ncst)\nRefer to playbook.md for default location"
      },
      {
        "title": "Step 2: Fetch weather data",
        "body": "Current: weather.sh ncst [nx] [ny]\n6-hour: weather.sh fcst [nx] [ny]\n3-day: weather.sh short [nx] [ny]"
      },
      {
        "title": "Step 3: Air quality integration (~~air)",
        "body": "Fetch PM data via AirKorea skill\nskills/airkorea-air-quality/scripts/air_quality.sh [station]"
      },
      {
        "title": "Output Template",
        "body": "## 🌤️ [Location] Weather\n\n### Current\n🌡️ Temp: X°C (Feels like X°C)\n💧 Humidity: X% | 🌬️ Wind: Xm/s\n🌧️ Precip: [None/Rain/Snow]\n\n### Today's Forecast\n☀️ High X°C / Low X°C\n🌧️ Precip probability: X%\n🌫️ PM2.5: [Good/Moderate/Bad/Very Bad] (X㎍/㎥)\n\n### 💡 One-liner\n[Bring umbrella / Wear mask / Great day to go out]"
      },
      {
        "title": "API Types",
        "body": "APICommandDescriptionUpdate CycleUltra-short obsncstCurrent observationHourlyUltra-short fcstfcst6hr forecastEvery 30minShort-term fcstshort3-day hourly8x/day"
      },
      {
        "title": "Key Grid Coordinates",
        "body": "LocationnxnySeoul Jongno60127Seoul Gangnam61126Busan9876Daegu8990Incheon55124Daejeon67100Jeju5238"
      },
      {
        "title": "Sky (SKY)",
        "body": "1: Clear ☀️ | 3: Mostly cloudy ⛅ | 4: Overcast ☁️"
      },
      {
        "title": "Precipitation (PTY)",
        "body": "0: None | 1: Rain 🌧️ | 2: Rain/Snow 🌧️❄️ | 3: Snow ❄️ | 4: Shower 🌦️"
      },
      {
        "title": "base_time Rules",
        "body": "APIRelease timeQueryableUltra-short obsEvery hour+10minUltra-short fcstEvery 30min+10minShort-term fcst02,05,08,11,14,17,20,23h+10min"
      },
      {
        "title": "Connectors",
        "body": "PlaceholderPurposeCurrent Tool~~weatherWeather APIKMA Short-term Forecast~~airAir qualityAirKorea~~notifyNotificationTelegram"
      },
      {
        "title": "Intent Router",
        "body": "IntentTrigger ExamplesStrategyQuick Check\"오늘 날씨 어때?\", \"지금 비 와?\", \"기온 몇 도?\"ncst (현재 관측) + fcst (3시간 예보) → 간단 요약Daily Forecast\"내일 비 와?\", \"주말 날씨\", \"모레 눈 올까?\"short (단기예보 3일) → 시간대별 상세Morning Briefing\"아침 날씨 브리핑\"morning_briefing.sh → 날씨+대기질 통합\n\nRouting logic: 현재/지금 → Quick Check, 내일/모레/주말 → Daily Forecast, 브리핑 → Morning Briefing"
      },
      {
        "title": "Cross-Skill Integration",
        "body": "TriggerTarget SkillIntegration날씨 응답 시 항상airkorea-air-qualityPM2.5 수치를 날씨 응답에 포함 (Output Template 참조)미세먼지 나쁨 이상airkorea-air-quality\"마스크 챙기세요\" 팁 추가비/눈 예보 시—\"우산 챙기세요\" 자동 팁"
      },
      {
        "title": "Notes",
        "body": "Uses grid coordinate system (not lat/lon) → use grid_convert.py\nQuery after release time + 10 minutes\nShort-term forecast returns large data → set sufficient numOfRows\n\nCowork architecture v2.2 — 🦞 chumjibot (2026-02-19)"
      },
      {
        "title": "🔧 Setup (공공데이터 포털 API)",
        "body": "data.go.kr 회원가입\n로그인 → 마이페이지 → 일반 인증키(Decoding) 복사\nAPI 키 저장:\nmkdir -p ~/.config/data-go-kr\necho \"YOUR_API_KEY\" > ~/.config/data-go-kr/api_key\n\n\n아래 서비스 활용신청 후 사용 (자동승인)\n\n기상청 단기예보 (15084084)"
      }
    ],
    "body": "KMA Weather Forecast Skill\n\nKorea Meteorological Administration short-term forecast API + AirKorea air quality integration.\n\nOverview\nKey\tValue\nProvider\tKMA (Korea Meteorological Administration)\nService ID\t15084084\nAuth\t~/.config/data-go-kr/api_key\nEndpoint\thttps://apis.data.go.kr/1360000/VilageFcstInfoService_2.0\nPlaybook\tplaybook.md\nScripts\nscripts/\n├── weather.sh             → Weather query (ncst/fcst/short)\n├── morning_briefing.sh    → Morning briefing (weather + air quality)\n└── grid_convert.py        → Lat/lon → grid coordinate conversion\n\nWorkflow\nStep 1: Identify location & time\n\"서울 날씨\" → Seoul Jongno-gu (nx=60, ny=127)\n\"내일 날씨\" → short-term forecast (short)\n\"지금 비 와?\" → ultra-short-term observation (ncst)\nRefer to playbook.md for default location\nStep 2: Fetch weather data\nCurrent: weather.sh ncst [nx] [ny]\n6-hour: weather.sh fcst [nx] [ny]\n3-day: weather.sh short [nx] [ny]\nStep 3: Air quality integration (~~air)\nFetch PM data via AirKorea skill\nskills/airkorea-air-quality/scripts/air_quality.sh [station]\nStep 4: Structured response using output template\nOutput Template\n## 🌤️ [Location] Weather\n\n### Current\n🌡️ Temp: X°C (Feels like X°C)\n💧 Humidity: X% | 🌬️ Wind: Xm/s\n🌧️ Precip: [None/Rain/Snow]\n\n### Today's Forecast\n☀️ High X°C / Low X°C\n🌧️ Precip probability: X%\n🌫️ PM2.5: [Good/Moderate/Bad/Very Bad] (X㎍/㎥)\n\n### 💡 One-liner\n[Bring umbrella / Wear mask / Great day to go out]\n\nAPI Types\nAPI\tCommand\tDescription\tUpdate Cycle\nUltra-short obs\tncst\tCurrent observation\tHourly\nUltra-short fcst\tfcst\t6hr forecast\tEvery 30min\nShort-term fcst\tshort\t3-day hourly\t8x/day\nKey Grid Coordinates\nLocation\tnx\tny\nSeoul Jongno\t60\t127\nSeoul Gangnam\t61\t126\nBusan\t98\t76\nDaegu\t89\t90\nIncheon\t55\t124\nDaejeon\t67\t100\nJeju\t52\t38\nCodes\nSky (SKY)\n\n1: Clear ☀️ | 3: Mostly cloudy ⛅ | 4: Overcast ☁️\n\nPrecipitation (PTY)\n\n0: None | 1: Rain 🌧️ | 2: Rain/Snow 🌧️❄️ | 3: Snow ❄️ | 4: Shower 🌦️\n\nbase_time Rules\nAPI\tRelease time\tQueryable\nUltra-short obs\tEvery hour\t+10min\nUltra-short fcst\tEvery 30min\t+10min\nShort-term fcst\t02,05,08,11,14,17,20,23h\t+10min\nConnectors\nPlaceholder\tPurpose\tCurrent Tool\n~~weather\tWeather API\tKMA Short-term Forecast\n~~air\tAir quality\tAirKorea\n~~notify\tNotification\tTelegram\nIntent Router\nIntent\tTrigger Examples\tStrategy\nQuick Check\t\"오늘 날씨 어때?\", \"지금 비 와?\", \"기온 몇 도?\"\tncst (현재 관측) + fcst (3시간 예보) → 간단 요약\nDaily Forecast\t\"내일 비 와?\", \"주말 날씨\", \"모레 눈 올까?\"\tshort (단기예보 3일) → 시간대별 상세\nMorning Briefing\t\"아침 날씨 브리핑\"\tmorning_briefing.sh → 날씨+대기질 통합\n\nRouting logic: 현재/지금 → Quick Check, 내일/모레/주말 → Daily Forecast, 브리핑 → Morning Briefing\n\nCross-Skill Integration\nTrigger\tTarget Skill\tIntegration\n날씨 응답 시 항상\tairkorea-air-quality\tPM2.5 수치를 날씨 응답에 포함 (Output Template 참조)\n미세먼지 나쁨 이상\tairkorea-air-quality\t\"마스크 챙기세요\" 팁 추가\n비/눈 예보 시\t—\t\"우산 챙기세요\" 자동 팁\nNotes\nUses grid coordinate system (not lat/lon) → use grid_convert.py\nQuery after release time + 10 minutes\nShort-term forecast returns large data → set sufficient numOfRows\n\nCowork architecture v2.2 — 🦞 chumjibot (2026-02-19)\n\n🔧 Setup (공공데이터 포털 API)\ndata.go.kr 회원가입\n로그인 → 마이페이지 → 일반 인증키(Decoding) 복사\nAPI 키 저장:\nmkdir -p ~/.config/data-go-kr\necho \"YOUR_API_KEY\" > ~/.config/data-go-kr/api_key\n\n아래 서비스 활용신청 후 사용 (자동승인)\n기상청 단기예보 (15084084)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/sw326/kma-weather-korea",
    "publisherUrl": "https://clawhub.ai/sw326/kma-weather-korea",
    "owner": "sw326",
    "version": "2.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kma-weather-korea",
    "downloadUrl": "https://openagent3.xyz/downloads/kma-weather-korea",
    "agentUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kma-weather-korea/agent.md"
  }
}