Agent skill

Pp Air Quality

by mvanhorn in mvanhorn/printing-press-library

Use OpenAQ and AirNow source-backed recipes for air-quality snapshots, nearby monitors, sensor history, point comparison, and AirNow AQI setup/current observations.

Apache-2.0Auto-check: notes

Install Pp Air Quality

skills CLI
$ npx skills add mvanhorn/printing-press-library --skill pp-air-quality -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mvanhorn/printing-press-library pp-air-quality --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-air-quality .claude/skills/pp-air-quality && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pp-air-quality
GitHub stars
2.1k
Token cost
~1.1k tokens
SKILL.md length
377 words
Files
1
Skills in repo
506
Repo updated
First seen
Licence
Apache-2.0

At a glance

Use OpenAQ and AirNow source-backed recipes for air-quality snapshots, nearby monitors, sensor history, point comparison, and AirNow AQI setup/current observations.

  • Works in 3 steps: Install via the Printing Press… → Verify: air-quality-pp-cli --version → Ensure the reported install directory is…
  • Phrases: air quality
  • SKILL.md covers Prerequisites: Install the CLI, When To Use, When Not To Use and Setup, plus 1 more section
  • Calls go and npx; needs AIR_QUALITY_AIRNOW_API_KEY and AIR_QUALITY_OPENAQ_API_KEY

What it does

Pp Air Quality is an agent skill from mvanhorn/printing-press-library. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

  • Phrases: air quality
  • Air-quality-pp-cli

Example prompts

  • “/pp-air-quality”

Requirements

  • Node.js
  • A credential in AIR_QUALITY_OPENAQ_API_KEY
  • A credential in AIR_QUALITY_AIRNOW_API_KEY
  • Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
  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.

What it can do on your machine

Read from SKILL.md and the folder at commit d9a1696. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • AIR_QUALITY_AIRNOW_API_KEY
    • AIR_QUALITY_OPENAQ_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp Air Quality loads about 1.1k tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 377 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit d9a1696, republished under its Apache-2.0 licence (© mvanhorn). 377 words, ~1,150 tokens.

Download SKILL.mdSave it as .claude/skills/pp-air-quality/SKILL.md (or your agent's skills folder).
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.
allowed-tools
Read, Bash
author
Dhilip Subramanian
license
Apache-2.0
argument-hint
<command> [args] | install 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.

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

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.
Show full SKILL.md (150 more words)Show less

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.

© mvanhorn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-skills/pp-air-quality of mvanhorn/printing-press-library.

Open the folder on GitHubat commit d9a1696

Compare with similar skills

Pp Air Quality next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp Air Quality compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pp Air Quality this skillmvanhorn/printing-press-library2.1k—~1.1kAutomated safety check: NotesApache-2.0
Ecc Recipesaffaan-m/ECC276k1 repos~1.6kAutomated safety check: PassMIT
Recipe Portfolio Snapshot CSVkrakenfx/kraken-cli751—~337Automated safety check: PassMIT
Insta Snapshot Reviewoxc-project/oxc23k—~356Automated safety check: PassMIT
Playground Snapshot Releasemastra-ai/mastra29k—~1.7kAutomated safety check: PassCustom licence
Generate Snapshot Testsgetsentry/sentry46k—~3.3kAutomated safety check: PassCustom licence

Similar skills

  • Ecc Recipes

    affaan-m/ECC

    Map a described workflow to the right ECC command group with run-order and stop condition, or browse all command-group recipe families read live from the commands directory.

    276k GitHub starsUsed in 1 repo~1.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Export a portfolio snapshot with balances and valuations to CSV.

    751 GitHub stars~337 tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Insta Snapshot Review

    oxc-project/oxc

    Reviews and accepts Insta snapshot changes in the Oxc repo from the command line, one reviewed snapshot at a time, instead of using the interactive UI.

    23k GitHub stars~356 tokensUpdated today
    Testing & QAAuto-check passed
  • Publish a Playground UI snapshot (@mastra/playground-ui and its workspace dependencies) from main or the current branch via the playground-snapshot mode of the Publish to npm workflow, wait for it…

    29k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Generate Snapshot Tests

    getsentry/sentry

    Official

    Generate snapshot test files for Sentry frontend React components.

    46k GitHub stars~3.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Scaffold Python ADK Recipe

    google/adk-recipes

    Official

    Creates a new Python recipe for the ADK recipes repository by running a scaffold script that copies template files, after confirming the output directory and recipe name.

    10k GitHub stars~931 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from mvanhorn/printing-press-library

All 506 skills in this repo
  • Agent Desktop

    mvanhorn/printing-press-library

    Desktop automation through the real Rust agent-desktop CLI, published in Printing Press through a small bridge.

    2.1k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check: notes
  • Gfonts

    mvanhorn/printing-press-library

    Search, browse, and download Google Fonts from the terminal via the gfonts CLI.

    2.1k GitHub stars~574 tokensUpdated yesterday
    Auto-check passed
  • Pp 1688

    mvanhorn/printing-press-library

    The free, offline Trigger phrases: search 1688 for, find a factory on 1688 for, wholesale price on 1688 for, who is the cheapest supplier on 1688 for, compare 1688 suppliers for, use 1688, run 1688.

    2.1k GitHub stars~3k tokensUpdated yesterday
    Auto-check: notes
  • Pp Activity Japan

    mvanhorn/printing-press-library

    Inspect known Activity Japan plan IDs or URLs, compare dated prices and sessions, check language-sitemap coverage, and hand off to canonical booking pages.

    2.1k GitHub stars~2k tokensUpdated yesterday
    Auto-check: notes
  • Pp Adminbyrequest

    mvanhorn/printing-press-library

    Every Admin By Request portal action, plus a local SQLite mirror of audit, events, inventory and requests for ad-hoc...

    2.1k GitHub stars~3.3k tokensUpdated yesterday
    Auto-check: notes
  • Pp Agent Capture

    mvanhorn/printing-press-library

    macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

    2.1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check: notes

Questions about Pp Air Quality

What does Pp Air Quality do?

Use OpenAQ and AirNow source-backed recipes for air-quality snapshots, nearby monitors, sensor history, point comparison, and AirNow AQI setup/current observations. Pp Air Quality is an agent skill from mvanhorn/printing-press-library. Use OpenAQ and AirNow source-backed recipes for air-quality snapshots, nearby monitors, sensor history, point comparison, and AirNow AQI setup/current observations.

When should I use Pp Air Quality?

Pp Air Quality fits situations like: phrases: air quality; air-quality-pp-cli.

How do I install Pp Air Quality in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-air-quality -a claude-code`. Or copy the skill folder (cli-skills/pp-air-quality in mvanhorn/printing-press-library) into .claude/skills/pp-air-quality in your project. Claude Code loads it when a task matches its description.

How do I install Pp Air Quality in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-air-quality -a codex`. Or copy the skill folder (cli-skills/pp-air-quality in mvanhorn/printing-press-library) into .agents/skills/pp-air-quality in your project. Codex loads it when a task matches its description.

Can I use Pp Air Quality in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-air-quality -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-air-quality, .gemini/skills/pp-air-quality, .github/skills/pp-air-quality and .opencode/skills/pp-air-quality in your project.

What does Pp Air Quality need to run?

Going by SKILL.md and its folder, Pp Air Quality needs the command-line tools its instructions call (go and npx) and credentials named AIR_QUALITY_AIRNOW_API_KEY and AIR_QUALITY_OPENAQ_API_KEY. Our summary lists: Node.js; A credential in AIR_QUALITY_OPENAQ_API_KEY; A credential in AIR_QUALITY_AIRNOW_API_KEY. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Air Quality access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pp Air Quality safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Air Quality use?

Pp Air Quality is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Air Quality use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp Air Quality?

Skills that share tags, products or a category with Pp Air Quality: Ecc Recipes (affaan-m/ECC, 276k stars), Recipe Portfolio Snapshot CSV (krakenfx/kraken-cli, 751 stars), Insta Snapshot Review (oxc-project/oxc, 23k stars) and Playground Snapshot Release (mastra-ai/mastra, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Air Quality?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.