Weather Query Skill
This skill enables AI agents to fetch real-time weather information and forecasts for locations in China using the provided shell scripts.
When to Use This Skill
Use this skill when users:
- Ask about current weather conditions
- Want weather forecasts
- Need temperature, humidity, wind information
- Request air quality data
- Plan outdoor activities and need weather info
How to Use
Get Real-time Weather
Use the realtime.sh script to get current conditions, air quality, daily life indices, and weather alerts.
./scripts/realtime.sh <query> [--encoding <text|json|markdown>]
Get Weather Forecast
Use the forecast.sh script to get hourly and daily forecast data, along with sunrise/sunset times.
./scripts/forecast.sh <query> [--encoding <text|json|markdown>] [--days <0-8>]
query (Required): The name of the city, district, or area in Chinese (e.g., 雨花台, 北京). Can be provided as a positional argument or with --query.encoding (Optional): Used to specify the returned data format. Can be text, json, or markdown.days (Optional, forecast only): Used to specify the weather forecast date range. An integer between 0 and 8.
Response Format
To balance information depth with token consumption, you MUST use the following rules for the encoding parameter:
Default Strategy (--encoding markdown)
- When to use: By default for standard weather inquiries.
- Why: Provides well-structured, easy-to-read information with moderate token usage.
Brief Information (--encoding text)
- When to use: When the user explicitly requests brief or summarized weather information.
- Why: Returns only essential details in plain text, saving maximum tokens.
Complete Information (--encoding json)
- When to use: Only when the user explicitly asks for raw data, detailed fields, or comprehensive data (all indices, timestamps).
- Why: Returns the complete API payload, which is highly token-heavy.
Best Practices
Location Names: Always use Chinese characters for location names
Error Handling: Check if the location is valid before displaying results
Context: Provide relevant context based on weather conditions
- Rain: Suggest bringing umbrella
- Hot: Recommend staying hydrated
- Cold: Advise wearing warm clothes
- Poor AQI: Suggest wearing mask
Fallbacks: If a specific district doesn't work, try the city name
Troubleshooting
Issue: Location not found
- Solution: Try using the main city name instead of district
- Example: Use "北京" instead of "朝阳区"
Issue: No forecast data
- Solution: Verify the location name is correct
- Try standard city names: 北京, 上海, 广州, 深圳, etc.
Issue: Data seems outdated
- Solution: The API updates regularly, but weather can change quickly
- Check the
updated timestamp in the response
Supported Locations
The weather API supports most cities and districts in China, including:
- Provincial capitals: 北京, 上海, 广州, 深圳, 成都, 杭州, 南京, 武汉, etc.
- Major cities: 苏州, 青岛, 大连, 厦门, etc.
- Districts: 海淀区, 朝阳区, 浦东新区, etc.
1---2name: weather-query3description: Use when users ask about weather conditions, forecasts, or climate information for locations in China.4---56# Weather Query Skill78This skill enables AI agents to fetch real-time weather information and forecasts for locations in China using the provided shell scripts.910## When to Use This Skill1112Use this skill when users:13- Ask about current weather conditions14- Want weather forecasts15- Need temperature, humidity, wind information16- Request air quality data17- Plan outdoor activities and need weather info1819## How to Use2021### Get Real-time Weather22Use the `realtime.sh` script to get current conditions, air quality, daily life indices, and weather alerts.23```bash24./scripts/realtime.sh <query> [--encoding <text|json|markdown>]25```2627### Get Weather Forecast28Use the `forecast.sh` script to get hourly and daily forecast data, along with sunrise/sunset times.29```bash30./scripts/forecast.sh <query> [--encoding <text|json|markdown>] [--days <0-8>]31```32- `query` (Required): The name of the city, district, or area in Chinese (e.g., `雨花台`, `北京`). Can be provided as a positional argument or with `--query`.33- `encoding` (Optional): Used to specify the returned data format. Can be `text`, `json`, or `markdown`.34- `days` (Optional, forecast only): Used to specify the weather forecast date range. An integer between 0 and 8.3536## Response Format3738To balance information depth with token consumption, you **MUST** use the following rules for the `encoding` parameter:39401. **Default Strategy (`--encoding markdown`)**41 - **When to use:** By default for standard weather inquiries.42 - **Why:** Provides well-structured, easy-to-read information with moderate token usage.43442. **Brief Information (`--encoding text`)**45 - **When to use:** When the user explicitly requests brief or summarized weather information.46 - **Why:** Returns only essential details in plain text, saving maximum tokens.47483. **Complete Information (`--encoding json`)**49 - **When to use:** Only when the user explicitly asks for raw data, detailed fields, or comprehensive data (all indices, timestamps).50 - **Why:** Returns the complete API payload, which is highly token-heavy.5152## Best Practices53541. **Location Names**: Always use Chinese characters for location names552. **Error Handling**: Check if the location is valid before displaying results563. **Context**: Provide relevant context based on weather conditions57 - Rain: Suggest bringing umbrella58 - Hot: Recommend staying hydrated59 - Cold: Advise wearing warm clothes60 - Poor AQI: Suggest wearing mask61624. **Fallbacks**: If a specific district doesn't work, try the city name6364## Troubleshooting6566### Issue: Location not found67- **Solution**: Try using the main city name instead of district68- Example: Use "北京" instead of "朝阳区"6970### Issue: No forecast data71- **Solution**: Verify the location name is correct72- Try standard city names: 北京, 上海, 广州, 深圳, etc.7374### Issue: Data seems outdated75- **Solution**: The API updates regularly, but weather can change quickly76- Check the `updated` timestamp in the response7778## Supported Locations7980The weather API supports most cities and districts in China, including:81- Provincial capitals: 北京, 上海, 广州, 深圳, 成都, 杭州, 南京, 武汉, etc.82- Major cities: 苏州, 青岛, 大连, 厦门, etc.83- Districts: 海淀区, 朝阳区, 浦东新区, etc.
xyva-yuangui