Pp Weather Goat

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/weather-goat/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/". -->

Weather GOAT — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the weather-goat-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 weather-goat --cli-only

2. Verify: weather-goat-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):

go install github.com/mvanhorn/printing-press-library/library/other/weather-goat/cmd/weather-goat-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.

When to Use This CLI

Reach for this when a user wants a weather lookup, storm or alert check, air-quality read, activity recommendation (bike, hike, walk, commute, drive) based on current conditions, or a "is today normal for this time of year" comparison. Particularly valuable as a morning-briefing source with weather-goat-pp-cli (no args → current + today's forecast + active alerts for your configured home location).

Don't reach for this when the user needs hyperlocal or commercial-grade meteorology (use a paid provider like Tomorrow.io or ECMWF), or for international severe-weather alerts (NWS is US-only).

Unique Capabilities

Activity verdicts — the differentiator

• go walk|bike|hike|commute|drive [location] — GO / CAUTION / STOP verdict for a specific activity, with reasoning.

  Turns "look at the weather" into "what should I do." Each activity has its own thresholds.

  • walk — preparation advice (umbrella? jacket? sunscreen? layers?)
  • bike — wind, rain, AQI, ice thresholds tuned for cycling
  • hike — lightning, hypothermia risk, altitude UV
  • commute — compares AM departure vs PM return weather (time-aware)
  • drive — visibility, ice, wind gusts, NWS warnings

Severe weather intelligence

• alerts [location] — Active NWS warnings: tornado, storm, flood, heat. Structured output with severity and area polygons.

• watch [location] — Poll NWS every 60 seconds during active severe weather. Prints new/updated alerts as they arrive. For running during a storm.

Context and comparison

• normal [location] — Is today normal for this time of year? Compares today's high/low/precip against historical average for the same date.

• compare <location1> <location2> [...] — Side-by-side forecast for 2+ locations. Useful for travel planning or "which city is the weather better this weekend."

• morning-brief (or just weather-goat-pp-cli with no args, if config set-location was run) — Current conditions + today's forecast + active NWS alerts in one call. The daily-kickoff command.

Air, UV, and pollen

• breathe [location] — AQI + pollen + UV with an exercise recommendation.

• air-quality [location] — Detailed AQI with PM2.5, ozone, etc.

• weather_codes — Reference for Open-Meteo weather code mappings (internal but useful when working with --json output).

Command Reference

Core:

• weather-goat-pp-cli — Morning brief (requires config set-location first, or pass [location])
• weather-goat-pp-cli forecast [location] — Multi-day forecast
• weather-goat-pp-cli alerts [location] — Active NWS severe weather
• weather-goat-pp-cli history [location] — Historical weather

Activity:

• weather-goat-pp-cli go <activity> [location] — walk, bike, hike, commute, drive

Air / environment:

• weather-goat-pp-cli breathe [location] — AQI + pollen + UV brief
• weather-goat-pp-cli air-quality [location] — Detailed AQI

Context:

• weather-goat-pp-cli normal [location] — Today vs historical average
• weather-goat-pp-cli compare <loc1> <loc2> — Side-by-side
• weather-goat-pp-cli watch [location] — Live NWS monitoring loop

Config + utility:

• weather-goat-pp-cli config set-location <place> — Set home location
• weather-goat-pp-cli geocoding <name> — Resolve place names to coordinates
• weather-goat-pp-cli doctor — Verify connectivity

Recipes

"Should I bike to work today?"

weather-goat-pp-cli go bike --agent

Returns a structured GO/CAUTION/STOP verdict with reasoning — wind speed, precipitation, AQI, temperature, ice risk — weighted for cycling specifically.

Morning briefing after setting home location

weather-goat-pp-cli config set-location "Seattle, WA"
weather-goat-pp-cli --agent  # morning brief — no args

Once location is saved, the no-arg invocation returns current conditions + today's forecast + active NWS alerts. Run from a shell startup script or cron at 7am.