pp-air-quality

name	pp-air-quality
description	Use OpenAQ and AirNow source-backed recipes for air-quality snapshots, nearby monitors, sensor history, point comparison, and AirNow AQI setup/current observations. Trigger phrases: air quality, OpenAQ, AirNow, AQI, PM2.5, nearby monitor, air-quality-pp-cli.
author	Dhilip Subramanian
license	Apache-2.0
argument-hint	<command> [args] | install cli
allowed-tools	Read Bash
metadata	{"openclaw":{"requires":{"bins":["air-quality-pp-cli"]},"install":[{"kind":"go","bins":["air-quality-pp-cli"],"module":"github.com/mvanhorn/printing-press-library/library/other/air-quality/cmd/air-quality-pp-cli"}]}}

Air Quality - Printing Press CLI

Prerequisites: Install the CLI

This skill drives the air-quality-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install air-quality --cli-only
   

2. Verify: air-quality-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.5 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/other/air-quality/cmd/air-quality-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Security note: this module declares toolchain go1.26.4 so environments with Go toolchain auto-download disabled should install Go 1.26.5 or newer before using the direct go install fallback.

When To Use

Use air-quality-pp-cli when an agent needs source-backed air-quality context:

• Find nearby OpenAQ monitoring locations.
• Fetch latest OpenAQ physical pollutant measurements near coordinates.
• Fetch latest measurements for a known OpenAQ location.
• Fetch a bounded recent measurement window for one OpenAQ sensor.
• Compare two coordinate pairs using nearest OpenAQ snapshots.
• Use AirNow current AQI observations by ZIP when an AirNow API key is configured.

When Not To Use

• Do not use it for medical advice, emergency guidance, or regulatory decisions.
• Do not convert OpenAQ physical measurements into AQI.
• Do not use web-service commands for broad AirNow database population.

Setup

OpenAQ live commands require:

export AIR_QUALITY_OPENAQ_API_KEY="..."

AirNow commands require:

export AIR_QUALITY_AIRNOW_API_KEY="..."

Recipes

Current OpenAQ Snapshot

air-quality-pp-cli current --lat 40.7128 --lon -74.0060 --agent

Use this to find the nearest OpenAQ location and latest physical pollutant measurements.

Nearby OpenAQ Locations

air-quality-pp-cli nearest --lat 40.7128 --lon -74.0060 --agent

Use this when an agent needs candidate locations, sensors, and provider metadata.

Known OpenAQ Location

air-quality-pp-cli location 2178 --agent

Use this when a workflow already has an OpenAQ location ID.

Sensor History

air-quality-pp-cli history --sensor 3917 --days 7 --agent

Use this for a bounded recent measurement window. The CLI caps the window at 31 days.

Compare Two Points

air-quality-pp-cli compare --lat-a 40.7128 --lon-a -74.0060 --lat-b 34.0522 --lon-b -118.2437 --agent

Use this for source-backed comparison prose. Treat it as a snapshot, not exposure or health guidance.

AirNow Current AQI

air-quality-pp-cli airnow current --zip 10001 --agent

Use this only when AIR_QUALITY_AIRNOW_API_KEY is configured.

Source Coverage

air-quality-pp-cli sources --agent
air-quality-pp-cli doctor --agent

Use these before a larger workflow to confirm which source families are configured.