swmm-report

80 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By Zhonghao1995/agentic-swmm-workflow (GitHub) · coding · 33 stars · scanned at commit a3bf4f2

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.

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. Expected for a coding skill.

Found in 2 places.

skills/swmm-report/SKILL.md, line 29python3 skills/swmm-report/scripts/generate_report.py \
skills/swmm-report/SKILL.md, line 69mkdir -p /tmp/swmm_report_fixture/09_audit

Downloads and installs other software

The author does not mention this.

Found in 6 places.

skills/swmm-report/SKILL.md, line 41**python-docx dependency:** install with `pip install 'aiswmm[report]'`.
skills/swmm-report/SKILL.md, line 61`summary` carries the install hint `pip install 'aiswmm[report]'`.
skills/swmm-report/SKILL.md, line 159| `python-docx` | Write `.docx` output | `pip install 'aiswmm[report]'` |

Show 3 more

skills/swmm-report/SKILL.md, line 160| `PyYAML` | Parse YAML template files | `pip install PyYAML` |
skills/swmm-report/scripts/generate_report.py, line 32"python-docx is required: it ships with aiswmm; reinstall with: pip install --force-reinstall aiswmm",
skills/swmm-report/scripts/generate_report.py, line 40print("PyYAML is required: pip install PyYAML", file=sys.stderr)

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'swmm-report' ] || [ -L ~/.agents/skills/'swmm-report' ]; then echo 'A skill folder named swmm-report already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/Zhonghao1995/agentic-swmm-workflow' "$d" && git -C "$d" checkout --quiet 'a3bf4f23469cf4252955901176c86b9c94578963' -- 'skills/swmm-report' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/swmm-report' ~/.agents/skills/'swmm-report' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'swmm-report' ~/.claude/skills/'swmm-report' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for Zhonghao1995/agentic-swmm-workflow shows the score of its lowest-scoring skill.

SkillTrust badge for Zhonghao1995/agentic-swmm-workflow

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/Zhonghao1995/agentic-swmm-workflow.svg)](https://zalavijaysinh.github.io/skilltrust/repos/Zhonghao1995/agentic-swmm-workflow/)

Score history

Date	Version	Score
2026-11-07	`a3bf4f2`	80