Pp Nhc

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

National Hurricane Center — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: nhc-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 before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

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.

This CLI gives agents the most credible real-time hurricane information straight from the National Hurricane Center and the National Weather Service: active storms (CurrentStorms.json), parsed Public Advisories and Forecast Discussions, the Tropical Weather Outlook with formation odds, and live tropical watches and warnings. It is built text-first and links out to the official GIS for anyone who wants polygons. Deep thanks to the forecasters, hurricane hunters, and support staff at NHC who sacrifice so much for the safety of so many. This is an unofficial tool; in an emergency, follow the official watches, warnings, and evacuation orders from NHC, the NWS, and your local authorities.

When to Use This CLI

Use nhc-pp-cli when an AI agent or operator needs trustworthy, current tropical-cyclone information: whether a storm is active, its forecast and intensity, the meteorologist's discussion, what may develop, and which official watches and warnings are in effect. It is ideal for situational-awareness assistants, briefing generators, and disaster-response tooling that must cite an authoritative source.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to make or replace official forecasts or evacuation decisions; defer to NHC, the NWS, and local authorities.
• Do not use it for non-tropical or general weather; it covers tropical cyclones only.
• Do not expect rendered GIS polygons; it links out to the ArcGIS MapServer instead of parsing it.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

One-call situational awareness

• brief — One command returns active storms, the tropical outlook, and live NWS tropical alerts as a single payload, with an optional human briefing.

  Reach for this first when an agent asks 'what is the tropical situation right now' — one call instead of four.

  nhc-pp-cli brief --basin atl --markdown

Parsed NHC products

• storm — Full detail for one storm: vitals plus every advisory-product URL and GIS link-out, with not-applicable fields returned as explicit null.

  Use when you have a storm id and need its products and graphics without parsing the raw feed.

  nhc-pp-cli storm al092024

• advisory — Fetches and parses the Public Advisory, Forecast Discussion, or Forecast/Marine Advisory into structured fields plus the clean body text, with no HTML scraping by the agent.

  Use when you need the meteorologist's reasoning or exact wind/pressure/movement fields, not a web page.

  nhc-pp-cli advisory al092024 --type tcd

• outlook — Parses the Tropical Weather Outlook for any basin into development areas and 48-hour / 7-day formation chances, with graphic link-outs.

  Use in the quiet season or to forecast-ahead; it is useful when 'storms list' is empty.

  nhc-pp-cli outlook --basin atl

Link-outs done right

• graphics — Returns the cone, track, surge, and wind link-outs for a storm; --download saves the files locally and --open views them.

  Use to hand a dashboard or person the official NHC graphics without re-deriving file paths.

  nhc-pp-cli graphics al092024 --kind cone,surge

• gis — Maps a storm to its ArcGIS REST layer URLs (forecast cone, wind field, watch/warning) for mapping clients. Link-out only; never ingested.

  Use when a caller wants the spatial layers; this CLI references them instead of parsing them.

  nhc-pp-cli gis al092024

Gratitude and safety

• credits — Thanks the people of the National Hurricane Center and states plainly that this is an unofficial tool and NHC/NWS is authoritative.

  Read or surface this so users know the source of truth and who to thank.

  nhc-pp-cli credits

Command Reference

alerts — Active NWS tropical watches and warnings (api.weather.gov)

• nhc-pp-cli alerts — Active tropical alerts. Pass a comma-separated --event list (Hurricane/Tropical Storm/Storm Surge x Warning/Watch).

storms — Active tropical cyclones from NHC CurrentStorms.json (all basins)

• nhc-pp-cli storms — List every active tropical cyclone across all basins.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

nhc-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Active storms as compact JSON for an agent

nhc-pp-cli storms list --json --select id,name,classification,intensity,pressure

Returns just the high-gravity fields so an agent does not burn context on the full feed.