Guide · Agent skill
How to use the Weather Lookup agent skill (weather)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Weather Lookup skill (named weather) gives an AI agent the ability to fetch current conditions and short forecasts for a city, using free public weather services and no API key. This guide explains what a skill is, how to install this one, how to ask for weather in natural language, and where it should not be relied on. By the end you will be able to install the skill, trigger it, and check the answers it gives you.
Quick start
- 1Check curl. Confirm curl is available on your command line, since the skill requires it.
- 2Download the ZIP. Download the weather skill ZIP from this page.
- 3Unzip into a skills folder. Unzip into ~/.claude/skills/ for a personal install, or into a project's .claude/skills/ folder.
- 4Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the ZIP.
- 5Ask a weather question. Name a city and ask for current conditions or a forecast in plain language.
- 6Check the answer. Confirm the agent restated the matched city, region or country, and observation time.
What is an agent skill and what does this one do?
An agent skill is a folder containing a SKILL.md file with instructions that an AI agent reads when a task matches the skill's description. The skill tells the agent how to do the task, which tools to use and what rules to follow.
Once this skill is installed, the agent can answer questions such as what the weather is in a city right now or what tomorrow's forecast looks like. It fetches data from wttr.in and Open-Meteo by running curl commands. The skill's instructions ask the agent to confirm which city it matched (country, region, population) and to state the observation time, so it is less likely to report the weather for the wrong place. It also pays extra attention to Chinese and other non-Latin city names.
What you need before installing
The skill requires curl, a command-line tool, and internet access to the wttr.in and Open-Meteo services. It does not need an API key or an account.
- curl installed and available on the command line
- Internet access to wttr.in and Open-Meteo APIs
- No API key or account needed
- The skill runs scripts and uses the network
Install the Weather Lookup skill
Download the ZIP for the weather skill from this page. Then choose one of the following methods.
For a personal install that works across your projects, unzip the download into your user skills folder, ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder. In the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload the ZIP
How to trigger the skill with natural requests
You do not need a special command. Ask the agent about the weather in plain language, naming the city and, if useful, the time frame. The skill's description covers current weather and forecasts, so requests of that kind are the ones it is meant to handle.
Name the city as clearly as you can. If the name is ambiguous, include the country or region. The skill will ask a follow-up question or state its assumption when several plausible matches remain.
- What's the weather in London right now?
- What will the weather be in Chengdu tomorrow?
- Give me the current temperature and humidity in Shanghai.
- Is it windy in New York at the moment?
Commands the skill uses behind the scenes
You do not need to run these yourself, but they show what the agent does. For a quick current-conditions line, the skill calls wttr.in with a format string. For structured data, it geocodes the city with Open-Meteo, checks the returned country, admin1, admin2 and population fields, then requests the forecast using the verified coordinates and timezone=auto.
- Use ?m for metric units and ?u for US units on wttr.in
- URL-encode spaces and non-ASCII text, for example New York becomes New+York
- For Chinese city names, prefer wttr.in with the original name, or geocode the English or pinyin name
curl -s "https://wttr.in/London?format=%l:+%c+%t+%h+%w"Safety notes: network use and scripts
The skill sends city names to external servers (wttr.in and Open-Meteo) and runs curl commands. Do not install it in an environment where the agent must not make outbound internet requests. The data comes from free third-party services, and the source gives no guarantee of accuracy or timeliness.
Do not rely on this skill for safety-critical decisions such as severe storm warnings or flight and marine operations. Check an official weather service for those.
- Sends city names to external servers
- Runs curl commands, so review the skill before installing it
- Not suitable for severe weather warnings or flight or marine decisions
What people use it for
- Checking current temperature and conditions in a city before heading out
- Getting tomorrow's forecast for a trip planning conversation
- Looking up weather for cities with Chinese or other non-Latin names
- Adding a key-free weather lookup step inside a developer's agent workflow
Frequently asked questions
Do I need an API key to use the weather skill?
No. The skill is described as requiring no API key, and the source lists no account requirement. It uses wttr.in and Open-Meteo, which are free public services.
What does the weather skill require?
It requires curl, a command-line tool, and internet access to the wttr.in and Open-Meteo APIs. It runs scripts and uses the network.
Is the weather agent skill free?
The skill is published under the MIT licence. The data comes from free public services, and the source does not list any prices.
Where do I put the weather skill folder?
Unzip the downloaded ZIP into ~/.claude/skills/ for a personal install, or into a project's .claude/skills/ folder. In the Claude apps, upload it under Settings → Capabilities → Skills.
Why does the skill handle Chinese city names differently?
Chinese and other non-Latin names can match the wrong place in geocoding. The skill prefers wttr.in with the original name, or geocodes the English or pinyin name, and checks the country and region before answering.
Can I use this skill for storm warnings or flight planning?
No. The data comes from free third-party services with no guarantee of accuracy or timeliness, so use an official weather service for safety-critical decisions.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you want quick current conditions or a short forecast from an AI agent, especially for cities with non-English or ambiguous names, and you want no API key. Pick something else if you need safety-critical warnings, or if your environment must not make outbound internet requests.
Download the skill