Skills

English | 简体中文

Installable Agent Skills for querying the Caiyun Weather API.

Installable skill packages live under skills/. Installation uses npx skills add.

Prerequisites

Before anything, ensure you have access to the API. You can apply for it at https://docs.caiyunapp.com/weather-api/.

The script reads credentials in this order:

1. CAIYUN_WEATHER_API_TOKEN environment variable
2. $XDG_CONFIG_HOME/caiyunapp/config.json (falls back to ~/.config/caiyunapp/config.json if XDG_CONFIG_HOME is not set)

Local Config File

Create ~/.config/caiyunapp/config.json (or $XDG_CONFIG_HOME/caiyunapp/config.json):

{
  "caiyun_weather_api_token": "your-key"
}

This is useful when environment setup is inconvenient, but keep in mind the key is stored as plaintext on disk.

Installation

GitHub:

npx skills add https://github.com/caiyunapp/skills

Available Skills

Skill	Description
caiyun-weather	Query Caiyun comprehensive weather data by latitude and longitude. Returns realtime weather, short-term weather guidance, hourly forecast, daily forecast, life index cues, and weather code interpretation.