Individual skill

evo-flood-risk-analysis

Detects flooding events at USGS streamgages by fetching instantaneous (15-min) gage height data, computing daily maximums, and comparing against NWS flood stage thresholds from the official NWS All Gauges Report. Outputs a CSV of stations with flood days.

tasks-evolved/flood-risk-analysis/environment/skills/evo-flood-risk-analysis/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: Network or broad shell
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.

agent-skills Repository topic
ai-agents Repository topic
llm-agents Repository topic
open-world Repository topic
self-evolving-agents Repository topic
data Derived category

Files and excerpt

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

Browse files

SKILL.mdcore · 2,527 bytes
SKILL.mdcore · 2,527 bytes
scripts/utils.pyruns · 9,224 bytes

Read excerpt


# evo-flood-risk-analysis

End-to-end pipeline for identifying flood days at USGS streamgages using gage height data and NWS flood stage thresholds.

## Methodology

1. **Gage height (parameter 00065)** is used — NOT discharge (00060).
2. **Daily maximum of instantaneous (15-min) readings** is the aggregation method. Use `nwis.get_iv()` to fetch instantaneous values, then resample to daily max with `.resample('D').max()`.
3. **NWS flood stage thresholds** come from the NWS All Gauges Report CSV at `https://water.noaa.gov/resources/downloads/reports/nwps_all_gauges_report.csv`. Match stations by USGS site ID (`usgs_id` or `gaugelid` column). The flood stage column is `sigstages.flood.stage` or similar.
4. **Flood condition**: `daily_max_gage_height >= flood_stage` (greater than or equal).
5. Only stations with a valid numeric NWS flood stage are evaluated.
6. Only stations with at least one flood day are included in output.
7. Sort output by `flood_days` descending.