{"skill":{"slug":"weather-query","displayName":"Weather Query","summary":"Use when users ask about weather conditions, forecasts, or climate information for locations in China.","description":"---\nname: weather-query\ndescription: Use when users ask about weather conditions, forecasts, or climate information for locations in China.\n---\n\n# Weather Query Skill\n\nThis skill enables AI agents to fetch real-time weather information and forecasts for locations in China using the provided shell scripts.\n\n## When to Use This Skill\n\nUse this skill when users:\n- Ask about current weather conditions\n- Want weather forecasts\n- Need temperature, humidity, wind information\n- Request air quality data\n- Plan outdoor activities and need weather info\n\n## How to Use\n\n### Get Real-time Weather\nUse the `realtime.sh` script to get current conditions, air quality, daily life indices, and weather alerts.\n```bash\n./scripts/realtime.sh <query> [--encoding <text|json|markdown>]\n```\n\n### Get Weather Forecast\nUse the `forecast.sh` script to get hourly and daily forecast data, along with sunrise/sunset times.\n```bash\n./scripts/forecast.sh <query> [--encoding <text|json|markdown>] [--days <0-8>]\n```\n- `query` (Required): The name of the city, district, or area in Chinese (e.g., `雨花台`, `北京`). Can be provided as a positional argument or with `--query`.\n- `encoding` (Optional): Used to specify the returned data format. Can be `text`, `json`, or `markdown`.\n- `days` (Optional, forecast only): Used to specify the weather forecast date range. An integer between 0 and 8.\n\n## Response Format\n\nTo balance information depth with token consumption, you **MUST** use the following rules for the `encoding` parameter:\n\n1. **Default Strategy (`--encoding markdown`)**\n   - **When to use:** By default for standard weather inquiries.\n   - **Why:** Provides well-structured, easy-to-read information with moderate token usage.\n\n2. **Brief Information (`--encoding text`)**\n   - **When to use:** When the user explicitly requests brief or summarized weather information.\n   - **Why:** Returns only essential details in plain text, saving maximum tokens.\n\n3. **Complete Information (`--encoding json`)**\n   - **When to use:** Only when the user explicitly asks for raw data, detailed fields, or comprehensive data (all indices, timestamps).\n   - **Why:** Returns the complete API payload, which is highly token-heavy.\n\n## Best Practices\n\n1. **Location Names**: Always use Chinese characters for location names\n2. **Error Handling**: Check if the location is valid before displaying results\n3. **Context**: Provide relevant context based on weather conditions\n   - Rain: Suggest bringing umbrella\n   - Hot: Recommend staying hydrated\n   - Cold: Advise wearing warm clothes\n   - Poor AQI: Suggest wearing mask\n\n4. **Fallbacks**: If a specific district doesn't work, try the city name\n\n## Troubleshooting\n\n### Issue: Location not found\n- **Solution**: Try using the main city name instead of district\n- Example: Use \"北京\" instead of \"朝阳区\"\n\n### Issue: No forecast data\n- **Solution**: Verify the location name is correct\n- Try standard city names: 北京, 上海, 广州, 深圳, etc.\n\n### Issue: Data seems outdated\n- **Solution**: The API updates regularly, but weather can change quickly\n- Check the `updated` timestamp in the response\n\n## Supported Locations\n\nThe weather API supports most cities and districts in China, including:\n- Provincial capitals: 北京, 上海, 广州, 深圳, 成都, 杭州, 南京, 武汉, etc.\n- Major cities: 苏州, 青岛, 大连, 厦门, etc.\n- Districts: 海淀区, 朝阳区, 浦东新区, etc.\n","topics":["Weather Query"],"tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":1339,"installsAllTime":50,"installsCurrent":11,"stars":2,"versions":1},"createdAt":1772083084966,"updatedAt":1778491644319},"latestVersion":{"version":"0.1.0","createdAt":1772083084966,"changelog":"weather-query 0.1.0\n\n- Initial release of the weather-query skill.\n- Provides real-time weather information and forecasts for locations in China.\n- Supports current conditions, air quality, daily life indices, and weather alerts.\n- Includes scripts for both real-time data and multi-day forecasts.\n- User can request info in text, markdown, or JSON formats.\n- Offers usage best practices and troubleshooting guidance.","license":null},"metadata":null,"owner":{"handle":"jaceymarvin99","userId":"s17fc8dswc5rrr1mgv9dfctchs8850p1","displayName":"JaceyMarvin99","image":"https://avatars.githubusercontent.com/u/73216966?v=4"},"moderation":null}