# Weather

> Skill `weather` on Faro. 5 sub-skills.

Provides current conditions, forecasts, and short-term precipitation nowcasts for any location on earth. Get the temperature and conditions right now, a multi-day planning forecast, an hour-by-hour breakdown for later today, or a minute-level rain nowcast for the next hour. All data is real and data-backed, not estimated.

**Category:** Maps & Weather  
**Tags:** weather, forecast, climate, conditions  
**Use when:** You need live weather or a forecast for a location, by place name or by coordinates.  
**Not for:** Past or historical weather, climate normals, air quality, guaranteed severe-weather alerts, or safety-critical marine, aviation, or evacuation decisions.  
**Returns:** information — Returns weather data for the resolved location. A place-name lookup may instead return candidate locations when the name is ambiguous, so you can pick the right one.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/weather/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What are the coordinates of Tokyo?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run weather "What are the coordinates of Tokyo?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What are the coordinates of Tokyo?
- What's the weather in Tokyo right now?
- What's the weather forecast for Paris this week?
- What will the weather be like in Rome at 3pm today?

## Sub-skills

### Find a place's coordinates

Turns a place name into coordinates, disambiguating same-name places.

**Cost:** 0.1 credits / lookup

**Use when:** You have a place name and need its latitude and longitude, or need to tell apart places that share a name.

**Details:** https://askfaro.com/llms/skills/weather/geocode.md

---

### Current conditions

Gives current conditions, including temperature, feels-like, humidity, wind, clouds, and UV, with a summary.

**Cost:** 0.1 credits / request

**Use when:** You want the weather right now, the current temperature, or whether it is raining at the moment.

**Details:** https://askfaro.com/llms/skills/weather/current.md

---

### Daily forecast

Gives a multi-day daily outlook for planning across the coming days.

**Cost:** 0.1 credits / request

**Use when:** You want this week's weather, a several-day outlook, or to plan around upcoming conditions.

**Details:** https://askfaro.com/llms/skills/weather/forecast.daily.md

---

### Hourly forecast

Gives an hour-by-hour forecast for later today or the next day or two.

**Cost:** 0.1 credits / request

**Use when:** You want timing within the next day or two, e.g. what it will be like by 3pm or this evening.

**Details:** https://askfaro.com/llms/skills/weather/forecast.hourly.md

---

### Rain nowcast

Tells whether rain is coming in the next hour from a minute-level precipitation nowcast.

**Cost:** 0.1 credits / request

**Use when:** You want to know if rain is about to start, or minute-by-minute precipitation in the next hour.

**Details:** https://askfaro.com/llms/skills/weather/forecast.nowcast.md

---

---
On the web: https://askfaro.com/search/weather