swmm-runner SKILL.md skillA
swmm-runner from zhonghao1995/agentic-swmm-workflow is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add zhonghao1995/agentic-swmm-workflow/swmm-runner@git:20260612.9aca7f3Pins git:20260612.9aca7f3 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-runner/SKILL.md- Versions recorded
- 3
- Latest version
- git:20260612.9aca7f3, committed Jun 12, 2026
- First version recorded
- Feb 26, 2026
- Size
- 4,087 bytes
- Repository stars
- 31
- License
- MIT
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.
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 Runner (CLI-first) 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 - Deterministic execution wrapper around the `swmm5` binary. - A standard **run directory** layout: `inp/`, `rpt/`, `out/`, `stdout`, `stderr`, `manifest.json`. - Metric extraction read directly from SWMM's own `.rpt`: - peak flow + time-of-peak for any junction or outfall; - Runoff Quantity and Flow Routing continuity tables + continuity error %; - cross-run comparison (e.g. GUI vs CLI) on continuity error. ## When to use this skill Use after a SWMM model is fully assembled (typically by `swmm-builder.build_inp`) and you need to actually execute it and read back the metrics. Also use to compare two .rpt files for regression / GUI parity. Do **not** use this skill to assemble the .inp itself (that's `swmm-builder`) or to plot the results (that's `swmm-plot`). ## MCP tools `mcp/swmm-runner/server.js` exposes four tools. 1. **`swmm_run`** — run `swmm5` against an .inp and write rpt + out + stdout + stderr + manifest.json into a run directory. …
Read the whole file at its exact version.
How to install
mdr add zhonghao1995/agentic-swmm-workflow/swmm-runner@sha256:98e4496142c6e074The line at the top of this page pins the label git:20260612.9aca7f3, 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.
[](https://markdownregistry.com/a/art_yxp47yesiqfjcoqm)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Feb 26, 2026 and Jun 12, 2026, about one every 53 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260612.9aca7f3 latest | 2026-06-12 | 9aca7f3 | 4,087 B | A | view · diff |
| git:20260514.2d0ffe1 | 2026-05-14 | 2d0ffe1 | 3,909 B | A | view · diff |
| git:20260226.23412e9 | 2026-02-26 | 23412e9 | 1,119 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4087 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
zhonghao1995/agentic-swmm-workflow · 31 stars · license MIT · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yxp47yesiqfjcoqm GET https://markdownregistry.com/api/v1/resolve?ref=zhonghao1995/agentic-swmm-workflow/swmm-runner GET https://markdownregistry.com/api/v1/blob/98e4496142c6e074153cab35fe082ac205ae25ea2a1bbca5b829c4ac11659165
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.