agentic-swmm-workflow

Agentic SWMM is an automated, auditable, and memory-informed framework for reproducible stormwater modelling, integrating QGIS and EPA SWMM through the aiswmm runtime, reusable Skills, and MCP interfaces, with QA verification, provenance tracking, calibration support, and Codex, Hermes, Claude code as well as OpenClaw compatibility

Multi-agent — Targets three or more agents

Works with

Claude
Codex
OpenCode

View on GitHub

30 GitHub stars (30)

+1 in 16 days

Stars gained per day · daily snapshots since Sep 30

Stars gained between daily snapshots
Period	New stars
Oct 1	0
Oct 2	0
Oct 3	0
Oct 4	0
Oct 5	0
Oct 6	+1
Oct 7	0
Oct 8	0
Oct 9	0
Oct 10	0
Oct 11	0
Oct 12	0
Oct 13	0
Oct 14	0
Oct 15	0
Oct 16	0

17 skills (17 skills found in its SKILL.md files)
15 forks (15 forks)
2w ago last update (Last updated 2w ago)

Install

Skills CLI

npx skills add Zhonghao1995/agentic-swmm-workflow

Asks which skills and agents to install. Just one: npx skills add Zhonghao1995/agentic-swmm-workflow --skill skill-author — add -g for every project.

Claude Code

git clone https://github.com/Zhonghao1995/agentic-swmm-workflowcp -r "agentic-swmm-workflow/skills/skill-author" ~/.claude/skills/

Copies the skill-author skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.

Plugin

/plugin marketplace add Zhonghao1995/agentic-swmm-workflow

Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.

Skills can run code on your machine — read the SKILL.md first.

What it does

Filter skills

In the author's own words, from each skill's SKILL.md.

skill-author

Draft a well-formed new skill (a SKILL.md scaffold, optionally with scripts/references) from a described recurring need, for human review and approval. Use whenever a repeated workflow gap has no existing skill covering it, when someone wants to propose or create a new skill or capability, or when an agentic system detects a recurring problem that warrants a brand-new skill rather than editing an…
skills/skill-author/SKILL.md on GitHub (opens in a new tab)
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.
skills/swmm-anywhere/SKILL.md on GitHub (opens in a new tab)
swmm-builder

Assemble a runnable SWMM INP deterministically from subcatchment geometry/attributes, merged parameter JSON, network JSON, and climate references. Use when creating auditable INP + manifest artifacts for downstream swmm-runner/calibration.
skills/swmm-builder/SKILL.md on GitHub (opens in a new tab)
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…
skills/swmm-calibration/SKILL.md on GitHub (opens in a new tab)
swmm-canada

Fetch a ready-to-run SWMM model for any Canadian area from the SWMMCanada upstream service — real published municipal storm pipes where a supported city covers the AOI, synthesized elsewhere in Canada. Input is a bbox or GeoJSON polygon plus a rainfall date window. Use for Canadian locations; outside Canada route to swmm-anywhere instead. Documentation contract only — the runtime tool is the in-p…
skills/swmm-canada/SKILL.md on GitHub (opens in a new tab)
swmm-climate

Deterministic rainfall/climate formatting for SWMM. Use when converting timestamped rainfall CSV files into SWMM-ready [TIMESERIES] lines and [RAINGAGES] helper snippets for swmm-builder.
skills/swmm-climate/SKILL.md on GitHub (opens in a new tab)
swmm-design-review

Score a completed SWMM run against a configurable YAML rulebook of design checks — GB50014-style standards for real catchments, or the reference-free physical-plausibility rulebook for synthesized networks. Reads the run's existing manifest.json / model.rpt / model.inp and never re-runs SWMM. Use it post-run for compliance or plausibility review; continuity gating stays with postflight.
skills/swmm-design-review/SKILL.md on GitHub (opens in a new tab)
swmm-end-to-end

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.
skills/swmm-end-to-end/SKILL.md on GitHub (opens in a new tab)
swmm-experiment-audit

Consolidate Agentic SWMM run artifacts into auditable provenance, comparison records, and local Obsidian audit notes. Use after any SWMM build/run/QA attempt, successful or failed, when an agent or CLI workflow needs a traceable record of inputs, commands, artifacts, metrics, QA checks, run-to-run differences, and first-user-friendly Obsidian visualization.
skills/swmm-experiment-audit/SKILL.md on GitHub (opens in a new tab)
swmm-gis

GIS/DEM preprocessing for SWMM experiments using the user's own QGIS/GRASS layers. Use when the user asks to (1) delineate subcatchments through QGIS/GRASS (standard or entropy-guided), (2) preprocess QGIS-derived subcatchment polygons into builder-ready CSV, (3) identify high-entropy hotspot subcatchments, or (4) expose QGIS/GRASS-backed preprocessing as MCP tools for reproducible workflows. For…
skills/swmm-gis/SKILL.md on GitHub (opens in a new tab)
swmm-network

Network QA of an existing INP (disconnected nodes, missing outfalls, adverse or zero slopes) is one call, network_qa, so call it first. Also builds, validates and routes SWMM pipe-network models 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…
skills/swmm-network/SKILL.md on GitHub (opens in a new tab)
swmm-params

Deterministic mapping from land use and soil texture to SWMM runoff/subarea and Green-Ampt infiltration parameters. Use when generating first-pass subcatchment parameter tables for swmm-builder.
skills/swmm-params/SKILL.md on GitHub (opens in a new tab)
swmm-plot

Nature-spec figures from a SWMM run: paired rainfall (inverted) + node/link flow hydrograph (plot_run), network layout map (map_run), study-area map. 89/183 mm columns, 5-7 pt sans-serif, ticks out, no gridlines, Wong colour-blind-safe palette, vector PDF + 450 dpi PNG twin, SI units, no title; optional focus-day / HH:MM window crop. Use whenever an agent needs a publication-ready figure from a r…
skills/swmm-plot/SKILL.md on GitHub (opens in a new tab)
swmm-report

Generate a client-deliverable Word (.docx) report from an audited SWMM run directory. Reads manifest.json, experiment_provenance.json, model_diagnostics.json, comparison.json, and any PNG figures — SWMM is never re-run. Supports custom YAML/JSON section templates.
skills/swmm-report/SKILL.md on GitHub (opens in a new tab)
swmm-runner

Run EPA SWMM (swmm5) simulations reproducibly and extract key metrics from the report file. Use when an agent needs to (1) run a .inp via swmm5 CLI, (2) generate a run directory with rpt/out + manifest, (3) extract peak flow/time for a node/outfall, (4) parse SWMM continuity (Runoff Quantity / Flow Routing) errors from .rpt, or (5) compare two .rpt files (e.g. GUI vs CLI) for equivalence.
skills/swmm-runner/SKILL.md on GitHub (opens in a new tab)
swmm-uncertainty

Parameter and forcing uncertainty for EPA SWMM. Without observed flow, call propagate_parameter_ranges (global ranges, one SWMM run per sample, peak spread); the Morris/OAT/Sobol tools need an observed series. Use when an agent needs to (1) propagate parameter uncertainty through SWMM (fuzzy alpha-cut or Monte Carlo), (2) quantify hydrograph envelopes or output entropy without treating the run as…
skills/swmm-uncertainty/SKILL.md on GitHub (opens in a new tab)
swmm-water-quality

Complete SWMM engine coverage: pollutant buildup/washoff simulation support and load reporting. Validate water-quality config JSON, build INPs with WQ sections, and extract pollutant load summaries from completed runs.
skills/swmm-water-quality/SKILL.md on GitHub (opens in a new tab)

Review before you install

A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.

Encoders & Decoders

Hash Generators

Code Formatters

HTML Tools

JavaScript Tools

Network Tools

Database Tools

Development Tools

Miscellaneous Tools

agentic-swmm-workflow