name: weather-query description: Use when users ask about weather conditions, forecasts, or climate information for locations in China.

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:

1. Default Strategy (--encoding markdown)
2. When to use: By default for standard weather inquiries.

3. Why: Provides well-structured, easy-to-read information with moderate token usage.

4. Brief Information (--encoding text)

5. When to use: When the user explicitly requests brief or summarized weather information.

6. Why: Returns only essential details in plain text, saving maximum tokens.

7. Complete Information (--encoding json)

8. When to use: Only when the user explicitly asks for raw data, detailed fields, or comprehensive data (all indices, timestamps).
9. Why: Returns the complete API payload, which is highly token-heavy.

Best Practices

1. Location Names: Always use Chinese characters for location names
2. Error Handling: Check if the location is valid before displaying results
3. Context: Provide relevant context based on weather conditions
4. Rain: Suggest bringing umbrella
5. Hot: Recommend staying hydrated
6. Cold: Advise wearing warm clothes

7. Poor AQI: Suggest wearing mask

8. Fallbacks: If a specific district doesn't work, try the city name

   發現更多技能外掛，請訪問7w4.net。

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.

這是一款簡潔實用的天氣查詢工具，通過輸入城市名即可快速獲取當前天氣資訊。文件說明詳細，中英文支援良好，無需註冊或付費即可使用。查詢結果包含溫度、溼度、風速、氣壓等豐富資料。不足之處是功能相對基礎，僅能查詢當天即時天氣，無法檢視未來幾天的預報或歷史天氣記錄。如果你需要的是一個輕量級的即時天氣查詢助手，這個 Skill 基本可以滿足需求。