swmm-end-to-end

Solid

Top-level orchestration skill for agentic SWMM modelling. Use when an agent needs one entrypoint that decides which module tools to run, in what order, and when to stop, for example to build, run, QA, and optionally calibrate a SWMM case from prepared or partially prepared inputs.

AI & Automation 21 stars 9 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
45
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# SWMM End-to-End Orchestration Part of [Agentic SWMM](https://github.com/Zhonghao1995/agentic-swmm-workflow) — install the project first for the executable toolchain (aiswmm CLI, SWMM solver, MCP servers). ## What this skill provides - A top-level orchestration contract for the agent runtime. - A stable handoff point for Agentic AI project memory in `agent/memory/`. - A deterministic execution order across the existing module skills: - `swmm-anywhere` (entry skill for data-scarce regions — no real pipe data) - `swmm-gis` - `swmm-climate` - `swmm-params` - `swmm-network` - `swmm-builder` - `swmm-runner` - `swmm-design-review` - `swmm-plot` - `swmm-calibration` - `swmm-uncertainty` - `swmm-lid-optimization` - `swmm-experiment-audit` ## Routing rule — real-data path vs synth-data path The orchestrator MUST inspect the user's inputs before choosing the entry skill: - If the request includes any of `.shp`, `.csv`, `network.json`, a CAD file, or an existing `.inp` path → the user has real data; route to `swmm-network` (or `swmm-builder` if the INP is already prepared). - If the request includes only a **bbox** or a **location name** with no pipe-network file attached → the user is in data-scarce mode; route to `swmm-anywhere`, which produces a synth `.inp` that downstream skills (`swmm-runner`, `swmm-experiment-audit`, `swmm-plot`) then consume identically to a real-data INP. - If both signals appear (bbox **and** a SHP) → prefer the real-data path (...

Details

Author
Zhonghao1995
Repository
Zhonghao1995/agentic-swmm-workflow
Created
5 months ago
Last Updated
3 days ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

swmm-anywhere

Synthesize a plausible SWMM drainage network from public data (OSM streets + DEM) when NO real pipe-network data exists — input is just a bbox. Use ONLY when the user has no pipe shapefile/CAD/GIS data, or to establish a baseline before real data arrives; if real pipe data exists, route to swmm-network or swmm-gis instead.

21 Updated 3 days ago
Zhonghao1995
AI & Automation Solid

swmm-calibration

Calibration and validation scaffold for EPA SWMM. Use when an agent needs to (1) compare simulated vs observed flow, (2) evaluate candidate parameter sets, (3) rank explicit candidates by an objective, (4) run a bounded random / LHS / adaptive search for the best-fitting parameters, (5) run a publication-grade SCE-UA calibration with KGE as the primary objective and (r, alpha, beta) decomposition reported, or (6) run a DREAM-ZS Bayesian calibration producing a posterior over parameters with Gelman-Rubin convergence checks. Dedicated sensitivity-analysis methods (OAT, Morris, Sobol') now live on the `swmm-uncertainty` skill.

21 Updated 3 days ago
Zhonghao1995
Data & Documents Solid

swmm-network

Build, validate, and route SWMM pipe-network models for urban drainage from raw municipal shapefiles or structured GIS/CAD exports. Use when handling junctions, conduits, outfalls, xsections, network field-mapping configs, or wiring subcatchments to upstream nodes. Requires real pipe data as SHP / GeoJSON / CSV — native CAD (DXF/DWG) is not parsed and must first be exported to one of these. For data-scarce areas where only a bbox is available and no pipe inventory exists, use `swmm-anywhere` instead.

21 Updated 3 days ago
Zhonghao1995