swmm-calibration SKILL.md skillA

swmm-calibration from zhonghao1995/agentic-swmm-workflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zhonghao1995/agentic-swmm-workflow/swmm-calibration@git:20260711.0e57f32

Pins git:20260711.0e57f32 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zhonghao1995/agentic-swmm-workflow
Path
skills/swmm-calibration/SKILL.md
Versions recorded
5
Latest version
git:20260711.0e57f32, committed Jul 11, 2026
First version recorded
May 14, 2026
Size
21,225 bytes
Repository stars
31
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# SWMM Calibration / Validation

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).

## CLI verb: aiswmm calibrate (real engine)

Since ADR-0005 the top-level verb drives this skill's SCE-UA engine directly:

```
aiswmm calibrate --inp model.inp --observed-csv observed.csv \
  --patch-map examples/calibration/patch_map.json \
  --run-id calib_001 --total-iters 200 \
  --param pct_imperv_s1=20,70 --run-dir runs/agent/calib_001 --progress
```

Contract highlights:

- **Units**: observed values MUST be in the same units as the SWMM output
  attribute selected by `--node`/`--attr`. There is no conversion layer; a
  greater-than-100x median magnitude mismatch between the best trial and the
  observed series triggers a loud `UNITS MISMATCH` warning (stderr + summary)
  to catch L/s vs m3/s style errors.
- **Parameters**: `--param name=low,high` supplies search bounds only; every
  name must exist in the `--patch-map` file (the sole parameter-definition
  contract). Unknown names fail fast and list what IS available.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zhonghao1995/agentic-swmm-workflow/swmm-calibration@sha256:5db89c55949fd080

The line at the top of this page pins the label git:20260711.0e57f32, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_etqs2iozy6rcwdnm.svg)](https://markdownregistry.com/a/art_etqs2iozy6rcwdnm)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 14, 2026 and Jul 11, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20260711.0e57f32 latest2026-07-11 0e57f32 21,225 BA view · diff
git:20260711.403b6e32026-07-11 403b6e3 21,237 BA view · diff
git:20260612.9aca7f32026-06-12 9aca7f3 19,661 BA view · diff
git:20260609.399e1d72026-06-09 399e1d7 19,483 BA view · diff
git:20260514.fce02412026-05-14 fce0241 19,489 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (21225 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zhonghao1995/agentic-swmm-workflow · 31 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_etqs2iozy6rcwdnm
GET https://markdownregistry.com/api/v1/resolve?ref=zhonghao1995/agentic-swmm-workflow/swmm-calibration
GET https://markdownregistry.com/api/v1/blob/5db89c55949fd0808c04549c05f7c649c80c04d2fbfadc3120dd3d8a09640c08

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zhonghao1995/agentic-swmm-workflow

skill-author SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/skill-author/SKILL.md · Draft a well-formed new skill (a SKILL.md scaffold, optionally with scripts/references) from a described recurring…
git:20260617.575420b · audit A · 31 stars
swmm-anywhere SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-anywhere/SKILL.md · Synthesize a plausible SWMM drainage network from public data (OSM streets + DEM) when NO real pipe-network data exists…
git:20260708.f3805da · audit A · 31 stars
swmm-builder SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-builder/SKILL.md · Assemble a runnable SWMM INP deterministically from subcatchment geometry/attributes, merged parameter JSON, network…
git:20260623.6b793fb · audit A · 31 stars
swmm-canada SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-canada/SKILL.md · Fetch a ready-to-run SWMM model for any Canadian area from the SWMMCanada upstream service — real published municipal…
git:20260809.548bf5c · audit A · 31 stars
swmm-climate SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-climate/SKILL.md · Deterministic rainfall/climate formatting for SWMM. Use when converting timestamped rainfall CSV files into SWMM-ready…
git:20260623.6b793fb · audit A · 31 stars
swmm-design-review SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-design-review/SKILL.md · Score a completed SWMM run against a configurable YAML rulebook of design checks — GB50014-style standards for real…
git:20260708.f3805da · audit A · 31 stars
swmm-end-to-end SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-end-to-end/SKILL.md · Top-level orchestration skill for agentic SWMM modelling. Use when an agent needs one entrypoint that decides which…
git:20260926.eb0bc4f · audit A · 31 stars
swmm-experiment-audit SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-experiment-audit/SKILL.md · Consolidate Agentic SWMM run artifacts into auditable provenance, comparison records, and local Obsidian audit notes…
git:20260612.9aca7f3 · audit A · 31 stars
swmm-gis SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-gis/SKILL.md · GIS/DEM preprocessing for SWMM experiments using the user's own QGIS/GRASS layers. Use when the user asks to (1)…
git:20260711.0e57f32 · audit A · 31 stars
swmm-network SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-network/SKILL.md · Network QA of an existing INP (disconnected nodes, missing outfalls, adverse or zero slopes) is one call, network_qa…
git:20260902.af3df3c · audit A · 31 stars
swmm-params SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-params/SKILL.md · Deterministic mapping from land use and soil texture to SWMM runoff/subarea and Green-Ampt infiltration parameters. Use…
git:20260623.6b793fb · audit A · 31 stars
swmm-plot SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-plot/SKILL.md · Nature-spec figures from a SWMM run: paired rainfall (inverted) + node/link flow hydrograph (plot_run), network layout…
git:20260816.ab2b679 · audit A · 31 stars

Every file in zhonghao1995/agentic-swmm-workflow

Browse by kind, by grade A, or by owner.