git:20260708.a53db92 to git:20260817.d5a007c

---

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

---

<!-- GENERATED FILE — DO NOT EDIT.

This file is a verbatim mirror of library/other/air-quality/SKILL.md,

regenerated post-merge by tools/generate-skills/. Hand-edits here are

silently overwritten on the next regen. Edit the library/ source instead.

See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# 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:

```bash

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.

```bash

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:

```bash

export AIR_QUALITY_OPENAQ_API_KEY="..."

```

AirNow commands require:

```bash

export AIR_QUALITY_AIRNOW_API_KEY="..."

```

## Recipes

### Current OpenAQ Snapshot

```bash

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

```bash

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

```bash

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

```

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

### Sensor History

```bash

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

```bash

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

```bash

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

```

Use this only when `AIR_QUALITY_AIRNOW_API_KEY` is configured.

### Source Coverage

```bash

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.