Menu

Individual skill

evo-usgs-flood-detection

Detects flooding events at USGS streamgages by comparing daily streamflow against historical 90th percentile thresholds using the dataretrieval package. Use when analyzing flood occurrences over a date range for a list of USGS station IDs.

tasks-evolved/flood-risk-analysis/environment/skills/evo-usgs-flood-detection/SKILL.md

Read pinned source

Source commit 84ca182da055fafb6453dcec4a6defdbbfd987c1

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
No
Observed behavior
Local scripts
Last checked
Nov 6, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
97
Repository last updated
Sep 10, 2026
License
Apache-2.0

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# evo-usgs-flood-detection

## Overview
End-to-end pipeline for detecting flooding at USGS streamgages. Reads station IDs from a file, fetches daily streamflow values and historical statistics via `dataretrieval.nwis`, computes flood-day counts by comparing observed daily mean streamflow against the 90th percentile historical threshold for each calendar day, and writes filtered results to CSV.

## Key Concepts

### Flood Definition
A **flood day** is defined as a day where the observed daily mean streamflow (`00060_Mean`) exceeds the 90th percentile (`p90_va`) of historical daily mean streamflow for that same calendar day (month + day).

### Data Sources
- **Daily Values**: `nwis.get_dv(sites, parameterCd='00060', start, end)` → returns `(DataFrame, metadata)` tuple
- **Historical Stats**: `nwis.get_stats(sites, statReportType='daily', parameterCd='00060')` → returns `(DataFrame, metadata)` tuple with columns `month_nu`, `day_nu`, `p90_va`