swmm-design-review SKILL.md skillA

swmm-design-review 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-design-review@git:20260708.f3805da

Pins git:20260708.f3805da 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-design-review/SKILL.md
Versions recorded
4
Latest version
git:20260708.f3805da, committed Jul 8, 2026
First version recorded
Jun 10, 2026
Size
6,512 bytes
Repository stars
31
License
MIT

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.

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-design-review — Design Review / Code-Compliance Checker

## What this skill does

Evaluates a completed SWMM run against a configurable rulebook of design checks.
Reads the run's existing artifacts (manifest.json + model.rpt + model.inp) — SWMM
is never re-run. Classifies each rule as `pass`, `fail`, `warn`, or `needs-data`
and writes `11_review/design_review.json` + `11_review/design_review.md` into the
run directory (canonical per ADR-0004; the underlying script's own bare default
is the legacy `09_review/` — see *CLI usage* below).

This skill is **decision-support only**. It never certifies regulatory compliance.

---

## CLI usage

```bash
# Standalone script
python3 skills/swmm-design-review/scripts/design_review.py \
    --run-dir <path>         # required: directory with model.rpt, manifest.json, model.inp
    [--rpt <path>]           # override: explicit model.rpt path
    [--inp <path>]           # override: explicit model.inp path
    [--manifest <path>]      # override: explicit manifest.json path
    [--rules <rulebook>]     # override rulebook YAML/JSON (repeatable for multiple books)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zhonghao1995/agentic-swmm-workflow/swmm-design-review@sha256:f001158c1e6bad1e

The line at the top of this page pins the label git:20260708.f3805da, 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_7rkkqsfzeesaegbt.svg)](https://markdownregistry.com/a/art_7rkkqsfzeesaegbt)

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

Versions

The registry has recorded 4 versions of this file, between Jun 10, 2026 and Jul 8, 2026, about one every 9 days. Its first recorded version is graded C and its latest A.

versioncommittedcommitsizeaudit
git:20260708.f3805da latest2026-07-08 f3805da 6,512 BA view · diff
git:20260702.6c0b5222026-07-02 6c0b522 6,084 BA view · diff
git:20260610.657610d2026-06-10 657610d 5,631 BC view · diff
git:20260610.3e7035e2026-06-10 3e7035e 4,561 BC 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 (6512 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_7rkkqsfzeesaegbt
GET https://markdownregistry.com/api/v1/resolve?ref=zhonghao1995/agentic-swmm-workflow/swmm-design-review
GET https://markdownregistry.com/api/v1/blob/f001158c1e6bad1e22f00582d51f18c3e7461758612db7ec8e49d36d7c603b2b

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-calibration SKILL.md skill
zhonghao1995/agentic-swmm-workflow · skills/swmm-calibration/SKILL.md · Calibration and validation scaffold for EPA SWMM. Use when an agent needs to (1) compare simulated vs observed flow…
git:20260711.0e57f32 · 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-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.