weather-alert（天气警报）

Weather Alert Skill

Proactively monitor weather conditions and alert when thresholds are exceeded. Uses free APIs (wttr.in, Open-Meteo) with no API key required.

Quick Start

# Install the skill
npx clawhub install weather-alert

# Check current weather
"Check weather in Prague"

# Set a rain alert for tomorrow
"Alert me if it will rain tomorrow in Prague"

# Set a temperature alert (below 5°C or above 30°C)
"Alert me if temperature drops below 5°C or exceeds 30°C"

# Get a 7-day briefing
"7-day weather briefing for Prague"

# List active alerts
"Show my weather alerts"

Core Features

1. Current Weather Check

Returns current conditions including temperature, humidity, wind, precipitation probability, UV index, and visibility.

🌤 Prague Weather — 2026-04-17 15:00
Temp: 12°C (feels like 10°C) | Humidity: 65%
Wind: 15 km/h NW | Precip: 10% | UV: 3
Visibility: 10 km | Pressure: 1013 hPa
Condition: Partly cloudy

2. Forecast & Briefing

Provides multi-day forecasts with condition summaries.

📅 7-Day Briefing — Prague
Mon 17: ☁️ 8-14°C | Rain 40%
Tue 18: 🌧️ 6-11°C | Rain 80%
Wed 19: ⛅ 10-16°C | Rain 20%
Thu 20: ☀️ 12-20°C | Rain 5%
Fri 21: ☀️ 14-22°C | Rain 0%
Sat 22: ⛈️ 11-18°C | Rain 70%
Sun 23: 🌧️ 8-14°C | Rain 60%

3. Smart Alerts

Set threshold-based alerts that trigger notifications:

• Temperature: Above/below a threshold (°C)
• Rain: Precipitation probability exceeding a %
• Snow: Snowfall depth exceeding mm
• Wind: Sustained speed exceeding km/h
• UV: UV index exceeding a threshold
• Pressure: Barometric pressure dropping/rising rapidly
• Frost: Risk of frost (temperature below 0°C overnight)

🔔 Active Alerts:
• [TOMORROW] Rain > 70% in Prague → Notify me
• [22:00] Temp < 5°C in Prague → Notify me
• [WEEKEND] UV > 7 in Prague → Notify me

4. Event Planner

Check weather suitability for specific activities:

🏃 Running — Prague, Tomorrow
Good: Temp 10°C, no rain, wind < 15 km/h
Warning: Possible morning drizzle (06:00-08:00)

🧺 Picnic — Prague, Sunday
Bad: Rain 70%, wind 25 km/h
Suggestion: Move to Saturday instead

5. Weather Trends

Track how conditions change over time for a location:

📈 Prague Temperature Trend (7 days):
Mon: 12°C → Tue: 8°C → Wed: 14°C → Thu: 16°C → Fri: 18°C → Sat: 12°C → Sun: 10°C
Change: -1°C from yesterday

Configuration

config.yaml defines default location and alert thresholds:

default_location:
  name: "Prague"
  lat: 50.0755
  lon: 14.4378

alerts:
  rain_threshold: 60        # % probability
  temp_min: 5               # °C below which to alert
  temp_max: 30              # °C above which to alert
  wind_max: 40              # km/h
  snow_depth: 5             # cm
  uv_max: 7
  frost_threshold: 0        # °C

notification:
  method: "exec-event"      # How alerts are delivered
  schedule_check: "6h"      # Auto-check interval

Data Sources

• Primary: Open-Meteo API (free, no key, global coverage)
• Secondary: wttr.in (quick lookups, human-readable)
• Fallback: OpenWeatherMap (if API key configured)

Error Handling

• API timeout → show cached data with staleness warning
• Location not found → suggest nearest match
• Rate limit → wait and retry (Open-Meteo: 1000 requests/hour free)

Permissions

permissions:
  read: ["~/weather-alerts/*"]
  network: ["wttr.in", "open-meteo.com"]
  write: ["~/weather-alerts/alerts.yaml"]