Air-Quality-Toolkit

April 30, 2026 · View on GitHub

Claude Code plugin for air quality lookups, historical data, AQI calculation, and modelling utilities. Defaults to WAQI with fallbacks to OpenAQ and AireLibre.

Skills

  • configure — set the user's preferred source and API keys (WAQI token, OpenAQ key if used)
  • retrieve-air-quality — current air quality for a location (city name, address, or lat/lon). Tries the configured favourite source first, falls back to WAQI, then OpenAQ, then AireLibre
  • historical-air-quality — pull historical pollutant data for a location over a date range
  • calculate-aqi — compute US EPA AQI (and category) from raw pollutant concentrations (PM2.5, PM10, O3, NO2, SO2, CO)
  • model-air-quality — modelling and analysis utilities inspired by the openair R package and Air-Quality-Prediction-Model: time-variation plots, polar plots, simple ML forecasts

Data storage

Configuration and cached data live under:

${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/air-quality-toolkit/

API keys are stored in config.json there — never in the plugin install directory.

Installation

# Always available:
claude plugins install air-quality-toolkit@danielrosehill

# Or per-project:
claude plugins install air-quality-toolkit@danielrosehill --scope project

References

License

MIT