air-quality-toolkit

Air-Quality-Toolkit

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

• WAQI / aqicn.org API — https://aqicn.org/api/
• OpenAQ — https://openaq.org / https://github.com/openaq/awesome-air-quality
• AireLibre — https://github.com/melizeche/AireLibre
• openair (R) — https://github.com/openair-project/openair
• Air-Quality-Prediction-Model — https://github.com/Akajiaku11/Air-Quality-Prediction-Model

License

MIT