Pp Tenki

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

tenki.jp

Prerequisites: Install the CLI

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

2. Verify: tenki-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:

go install github.com/mvanhorn/printing-press-library/library/travel/tenki/cmd/tenki-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.

Local checkout

Before a public-library merge and catalog refresh, build the checkout with Go 1.26.6 or newer:

go build -o bin/tenki-pp-cli ./cmd/tenki-pp-cli
bin/tenki-pp-cli --version

Use bin/tenki-pp-cli instead of the bare command prefix in examples when that verified local binary is not on $PATH.

Use command --help for current flags and bounds. Product commands read public HTML and write only local cache. Do not use this CLI for summit or route safety, historical weather observations, or unpublished future seasons.

Choose the branch

• Resolve a name/postal code: places search; select the canonical URL explicitly. Leisure searches cover the reported bounded directory, with optional --directory, rather than nationwide keyword search.
• Inspect identity and forecast reference: places show.
• Inspect dates: forecast daily; add --detail for separate six-hour intervals and instants.
• Inspect a supported activity window: forecast hourly --date YYYY-MM-DD --hours HH:00-HH:00.
• Evaluate supplied thresholds: compare; require at least one criterion and choose its deterministic --sort key when ranking.
• Inspect mountain evidence: mountain show; --level matches an actual source altitude.
• Inspect seasonal reports: seasonal list or seasonal show --kind sakura|kouyou --year YYYY. For ended Sakura name discovery, choose a retained prefecture --directory; a miss covers the reported scan.

Examples

tenki-pp-cli places search --query 金閣寺 --kind leisure --directory https://tenki.jp/leisure/6/29/ --limit 5 --agent --select results.places.name,results.places.url,results.search_scope
tenki-pp-cli places show --place https://tenki.jp/leisure/6/29/189/7327/ --agent
tenki-pp-cli forecast daily --place https://tenki.jp/forecast/3/16/4410/13101/ --days 3 --agent --select results.periods.date,results.periods.weather,results.periods.precip_probability_pct,results.source
tenki-pp-cli forecast hourly --place https://tenki.jp/forecast/3/16/4410/13101/ --hours 09:00-17:00 --agent --select results.periods.valid_at,results.periods.kind,results.periods.precip_rate_mm_h,results.periods.temperature_c
tenki-pp-cli compare --place https://tenki.jp/forecast/3/16/4410/13101/ --days 3 --max-pop 30 --max-temp 30 --sort max-pop --agent
tenki-pp-cli mountain show --place https://tenki.jp/mountain/famous100/5/25/150.html --level 3000 --limit 8 --agent
tenki-pp-cli seasonal show --kind kouyou --place https://tenki.jp/kouyou/3/13/30139.html --agent --select results.spot,results.source,results.status,results.year
tenki-pp-cli seasonal list --kind sakura --directory https://tenki.jp/sakura/3/16/ --query 上野 --year 2026 --limit 5 --agent
tenki-pp-cli seasonal show --kind sakura --place https://tenki.jp/sakura/3/16/54401.html --year 2026 --agent

Interpret evidence

Read the source timestamps, freshness, actual coverage and destination's forecast_reference_url before interpreting values. meta.source is the actual transport (live/local, or mixed/unavailable for comparisons); meta.metrics counts HTTP requests, cache hits and decoded source-response bytes, not network transfer bytes. Comparison decisions carry meta.data_origin: computed, a separate axis from acquisition. Missing numeric values are null; an explicit provider zero stays zero.

Weather dates/times use Asia/Tokyo. Hourly precipitation describes the preceding start–end hour; temperature/wind belong to valid_at. A 09:00–17:00 comparison uses eight complete rain intervals ending 10:00–17:00 and temperature/wind instants from 09:00 through 17:00, inclusive. The hourly inspection command also shows the 09:00 endpoint and its preceding rain interval. Probabilities are per source interval: their maximum is not the probability of any rain over the outing. Rain thresholds use daily amount in mm or hourly rate in mm/h; wind uses m/s; temperature uses °C. Estimated past hours are estimated_actual, not forecasts or municipal station observations.

Daily temperature minima are morning lows and maxima are daytime highs. Today's temperature fields can mix forecasts with estimated actual values; their per-field type stays explicit and cannot certify a forecast-only criterion. Today's daily period can be partial, with remaining weather/probability coverage beginning at issuance. Four six-hour rain intervals coexist with five instant labels; keep their boundaries distinct. Daily values cannot certify an hourly window. Daily wind is max_of_five_source_instants at 00/06/12/18/24; it is not a continuous daily maximum. Days 12–14 may contain confidence letters and fewer fields; retain unknown values and source confidence letters as supplied.

Municipal weather refers to the government-office vicinity; leisure and seasonal weather refers to the linked municipality. Preserve requested destination identity separately. Mountain main weather is foothill weather. Altitude tables are nearby_model_guidance, with their own model_initial_at; they do not establish summit weather, trail condition or ascent safety. A mountain destination cannot earn a summit suitability result from municipal/foothill evidence.

Seasonal spot reports, predictions and normal periods are distinct evidence. Keep requested_year, actual year, update state, report date and weather issue time separate. A fresh forecast does not refresh seasonal facts. Ended Sakura, a year mismatch or future-date current foliage cannot be positive seasonal evidence. --season pairs evidence without a hidden peak-quality criterion. With no condition preference, report that explicitly and retain the raw condition. --season-condition supplies an exact raw state preference. If the source supplies no applicable exact-date prediction, future seasonal suitability remains unknown while weather criteria can still be evaluated.

Comparison returns meets_criteria, fails_criteria or insufficient_data, with per-criterion pass/fail/unknown, thresholds, source values and coverage. Missing, stale, unknown-freshness, past-estimated, partial or out-of-horizon evidence cannot produce meets_criteria. A definite failed criterion can produce fails_criteria while other criteria remain explicitly unknown. Ties are shown; there is no universal sightseeing score. Thresholds describe the user's preferences.