# Send Weather Query to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "weather-query",
    "name": "Weather Query",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JaceyMarvin99/weather-query",
    "canonicalUrl": "https://clawhub.ai/JaceyMarvin99/weather-query",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/weather-query",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=weather-query",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/forecast.sh",
      "scripts/realtime.sh"
    ],
    "downloadMode": "redirect",
    "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/weather-query"
    },
    "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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/weather-query",
    "downloadUrl": "https://openagent3.xyz/downloads/weather-query",
    "agentUrl": "https://openagent3.xyz/skills/weather-query/agent",
    "manifestUrl": "https://openagent3.xyz/skills/weather-query/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/weather-query/agent.md"
  }
}
```
## Documentation

### 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

### 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

### 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JaceyMarvin99
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/weather-query)
- [Send to Agent page](https://openagent3.xyz/skills/weather-query/agent)
- [JSON manifest](https://openagent3.xyz/skills/weather-query/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/weather-query/agent.md)
- [Download page](https://openagent3.xyz/downloads/weather-query)