--- slug: "claude-mountaineering-skills" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/dreamiurg/claude-mountaineering-skills@main/README.md" repo: "https://github.com/dreamiurg/claude-mountaineering-skills" source_file: "README.md" branch: "main" ---

Mountaineering Skills for Claude Code

Mentioned in Awesome Claude Code Claude Code Plugin skills.sh

Automated mountain route research for North American peaks, built for Claude Code.

Quick Start • How It Works • Features • Installation • Support

Ask Claude to research any mountain. The route-researcher skill pulls from 10+ mountaineering sources and compiles a detailed Markdown report with current weather, avalanche conditions, daylight windows, trip reports, and route beta. What used to take 3-5 hours of tab-hopping now takes 3-5 minutes. > **Other projects you might like:** [PNW Climb Planner](https://dreamiurg.net/pnw-climb-planner.html) · [mountaineers-mcp](https://github.com/dreamiurg/mountaineers-mcp) · [mountaineers-assistant](https://github.com/dreamiurg/mountaineers-assistant) · [peakbagger-cli](https://github.com/dreamiurg/peakbagger-cli) Buy Me a Coffee at ko-fi.com

Route Researcher Demo

**See it in action:** | Peak | Elevation | What it shows | |------|-----------|---------------| | [Mount Si](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/examples/2025-10-23-mount-si.md) | 4,167 ft | High-traffic trail with abundant trip reports | | [Mount Adams](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/examples/2025-11-06-mount-adams.md) | 12,280 ft | Glaciated volcano with weather/avy conditions | | [Wolf Peak](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/examples/2025-11-06-wolf-peak.md) | 5,813 ft | Technical scramble with sparse beta | | [Mount Shuksan](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/examples/2026-01-29-mount-shuksan.md) | 9,129 ft | Glacier climb requiring crevasse rescue skills | | [Tinkham Peak](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/examples/2026-01-29-tinkham-peak.md) | 5,398 ft | Accessible Class 2-3 scramble near Snoqualmie Pass | --- ## Quick Start Install with [`npx skills`](https://github.com/vercel-labs/skills): ``` npx skills add dreamiurg/claude-mountaineering-skills ``` Then just ask naturally: `"Research Mount Rainier"`. Claude generates a route beta report in your current directory. > `npx skills` installs the `route-researcher` skill, which drives the full workflow from natural-language requests. If you also want the `/mountaineering:*` slash commands, install the plugin instead -- see [Installation](#installation). --- ## How It Works The skill uses a hybrid architecture: Python scripts for deterministic API calls, LLM agents for tasks requiring judgment. ```mermaid graph TB Start([User asks Claude to
research a peak]) --> Search[Phase 1-2: Peak Identification
Search PeakBagger, fetch details] Search --> Parallel[Phase 3: Parallel Data Gathering] Parallel --> Python[Python Script
Weather, daylight,
avalanche, air quality] Parallel --> Agent1[Researcher Agent 1
PeakBagger + SummitPost] Parallel --> Agent2[Researcher Agent 2
WTA + Mountaineers] Parallel --> Agent3[Researcher Agent 3
AllTrails] Python --> Analyze Agent1 --> Analyze Agent2 --> Analyze Agent3 --> Analyze Analyze[Phase 4: Route Analysis
Synthesize data, identify hazards] Analyze --> Writer[Phase 5: Report Writer Agent
Generate markdown report] Writer --> Reviewer[Phase 6: Report Reviewer Agent
Validate accuracy, fix issues] Reviewer --> End([Phase 7: User receives
route beta report]) style Start fill:#e1f5ff style End fill:#e1f5ff style Parallel fill:#fff4e1 style Python fill:#e8f5e9 style Agent1 fill:#f0f0f0 style Agent2 fill:#f0f0f0 style Agent3 fill:#f0f0f0 style Writer fill:#fff3e0 style Reviewer fill:#fff3e0 ``` Three researcher agents gather data in parallel while a Python script fetches conditions. Dedicated agents write and review the final report. If a source fails, the skill documents the gap and continues. --- ## Features ### Data Sources The skill aggregates from specialized mountaineering sites: | Category | Sources | |----------|---------| | Peak info | [PeakBagger](https://www.peakbagger.com) | | Routes | [SummitPost](https://www.summitpost.org), [WTA](https://www.wta.org), [AllTrails](https://www.alltrails.com), [The Mountaineers](https://www.mountaineers.org) | | Weather | [Open-Meteo](https://open-meteo.com), [NOAA/NWS](https://www.weather.gov) | | Avalanche | [NWAC](https://nwac.us), regional centers | | Trip reports | [PeakBagger](https://www.peakbagger.com), [WTA](https://www.wta.org), [The Mountaineers](https://www.mountaineers.org) | **Coverage note:** Report quality depends on how well-documented your peak is across these sources. Works best for popular North American peaks. ### Graceful Degradation Missing data? The skill notes what's unavailable in an "Information Gaps" section and provides manual lookup links. You always get a report, even if some sources are down. --- ## Installation **Prerequisites:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview), [Node.js](https://nodejs.org) (for `npx`), optionally [uv](https://docs.astral.sh/uv/) for Python tools. ### Recommended: `npx skills` [`npx skills`](https://github.com/vercel-labs/skills) installs the `route-researcher` skill directly: ``` npx skills add dreamiurg/claude-mountaineering-skills ``` Useful flags: ``` npx skills add dreamiurg/claude-mountaineering-skills --list # preview before installing npx skills add dreamiurg/claude-mountaineering-skills -g # install globally (all projects) npx skills add dreamiurg/claude-mountaineering-skills -y # skip confirmation prompts ``` This gives you the full natural-language workflow (`"Research Mount Rainier"`). The `/mountaineering:*` slash commands are **not** included -- install the plugin below if you want them. ### Alternative: Claude Code plugin The plugin bundles the same skill plus the `/mountaineering:*` slash commands: ``` /plugin marketplace add dreamiurg/claude-mountaineering-skills /plugin install mountaineering@mountaineering-marketplace /reload-plugins ``` Python dependencies install automatically if `uv` is available. No restart needed -- `/reload-plugins` activates the plugin in the current session. --- ## Usage ### Commands | Command | What it does | Time | |---------|-------------|------| | `/mountaineering:research ` | Full route research report | 3-5 min | | `/mountaineering:conditions ` | Weather, avalanche, air quality, daylight | ~30 sec | | `/mountaineering:trip-reports ` | Recent trip reports from PeakBagger and WTA | 1-2 min | ### Natural Language You can also just ask naturally: ``` "Research Mt Baker" "Get route beta for Forbidden Peak" "I'm planning to climb Sahale Peak, can you research it?" ``` Reports save to your current directory as `YYYY-MM-DD-peak-name.md`. --- ## Migration from v4.x If you previously installed the plugin as `mountaineering-skills`, reinstall with the new name: ``` /plugin uninstall mountaineering-skills /plugin install mountaineering@mountaineering-marketplace ``` --- ## Dependencies - [peakbagger-cli](https://github.com/dreamiurg/peakbagger-cli) >= v1.10.0 - peak data and trip reports - [Python tools](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/skills/route-researcher/tools/README.md) - weather, avalanche, and daylight calculations --- ## Updates If you installed with `npx skills`: ``` npx skills list # see installed skills npx skills update route-researcher # update to latest ``` If you installed the plugin: ``` /plugin list # check current version /plugin update mountaineering # update to latest ``` --- ## Contributing Pull requests welcome. See [CONTRIBUTING.md](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/CONTRIBUTING.md). --- ## Support [Open an issue](https://github.com/dreamiurg/claude-mountaineering-skills/issues) or [start a discussion](https://github.com/dreamiurg/claude-mountaineering-skills/discussions). ## License [MIT](https://github.com/dreamiurg/claude-mountaineering-skills/tree/HEAD/LICENSE) · [Privacy Policy](https://github.com/dreamiurg/claude-mountaineering-skills/blob/HEAD/PRIVACY.md) --- ## More from @dreamiurg - 🏔️ **[PNW Climb Planner](https://dreamiurg.net/pnw-climb-planner.html)** — pick a Washington peak, see the odds of a climbable day from 20 years of weather data, and line up backups ([the story behind it](https://dreamiurg.net/2026/07/01/picking-backup-climbs.html)) - **[mountaineers-mcp](https://github.com/dreamiurg/mountaineers-mcp)** — mountaineers.org for AI assistants: activities, courses, routes, trip reports - **[mountaineers-assistant](https://github.com/dreamiurg/mountaineers-assistant)** — Chrome extension with your Mountaineers climbing stats, local-only - **[peakbagger-cli](https://github.com/dreamiurg/peakbagger-cli)** — search and analyze PeakBagger.com peak data in your terminal - more at [dreamiurg.net/projects](https://dreamiurg.net/projects/) Made by [@dreamiurg](https://dreamiurg.net) in Seattle. If this project saved you time, you can [buy me a coffee](https://ko-fi.com/Q3N622FHZM) — appreciated, never expected.