usgs-data-download

Download USGS water level data via the dataretrieval nwis module.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/KaiserWhoLearns/skillsbench --skill usgs-data-download
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usgs-data-download
Source: https://github.com/KaiserWhoLearns/skillsbench/tree/main/tasks/flood-risk-analysis/environment/skills/usgs-data-download
Command: npx skills add https://github.com/KaiserWhoLearns/skillsbench --skill usgs-data-download

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a reproducible method to download USGS water level data using the dataretrieval package, enabling researchers and analysts to fetch gage height and discharge measurements for specified stations and date ranges without manual web queries.

Core Features & Use Cases

  • Access instantaneous gage height and daily discharge data from USGS NWIS.
  • Retrieve site information and metadata to validate station details.
  • Use cases include hydrology trend analysis, flood-risk assessment, and prep for reports that require station-level data.

Quick Start

Use this skill to fetch real-time water level data for a specific USGS station by specifying the station_id, start date, and end date.

Frequently Asked Questions about usgs-data-download

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download USGS water level data for a specific station and date range?

To download USGS water level data, specify the station ID and date range to fetch instantaneous gage height or daily discharge measurements using the dataretrieval nwis module for structured analysis output.

Can I retrieve both real-time and historical gage height data from the NWIS system?

Yes, you can retrieve real-time and historical gage height data from the NWIS system by using nwis.get_iv for instantaneous values and nwis.get_dv for daily discharge data across specified date ranges.

Does this method require manual web queries to access USGS discharge data?

No, this method does not require manual web queries to access USGS discharge data because it uses the dataretrieval package to programmatically fetch station-level measurements for reproducible hydrology analysis.

What is the best way to fetch site information to validate USGS station details?

The best way to fetch site information to validate USGS station details is using the dataretrieval nwis module, which retrieves site metadata alongside gage height and discharge data for accurate hydrology trend analysis.

Is USGS data retrieval suitable for flood-risk assessment and hydrology trend analysis?

Yes, USGS data retrieval is suitable for flood-risk assessment and hydrology trend analysis because it provides structured station-level discharge and gage height data needed for evaluating water resource conditions over time.