pyHMT2D: Skill for Claude Code

.agents/skills/hmt-calibrate/SKILL.md

hmt-calibrate is a skill for Claude Code, Codex from psu-efd/pyHMT2D. It costs 44 tokens per session (623 once invoked), scanned A, original, MIT.

A calibration tool for adjusting Manning’s n, a roughness value that describes how much a channel or surface slows water. It compares modelled water levels with observed water-surface elevations and searches for better parameter values.

In plain words
What is it for?
Use it to fit hydraulic model materials to measured water levels using Bayesian optimization or the Nelder-Mead search method.
Why use it?
It reduces the need to guess roughness values and test them manually. The tool checks the observation data and lets you set allowed ranges and starting values before calibration.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is psu-efd/pyHMT2D's own configuration. It tells Claude Code and Codex how to work on pyHMT2D itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything pyHMT2D configures →

Reuse

Borrowing it

Nothing to install: this file belongs to psu-efd/pyHMT2D. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/psu-efd/pyHMT2D/main/.agents/skills/hmt-calibrate/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/psu-efd/pyHMT2D

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for hmt-calibrate

README.md
[![agentmods](https://agentmods.dev/badge/skills/psu-efd/pyhmt2d/hmt-calibrate.svg)](https://agentmods.dev/skills/psu-efd/pyhmt2d/hmt-calibrate)
Your own site
<a href="https://agentmods.dev/skills/psu-efd/pyhmt2d/hmt-calibrate"><img src="https://agentmods.dev/badge/skills/psu-efd/pyhmt2d/hmt-calibrate.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 623 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.00623
Opus 5 $0.00022 $0.00311
Sonnet 5 $0.00009 $0.00125
Haiku 4.5 $0.00004 $0.00062

Measured 8d ago against content hash fb41dd252b5a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

hmt-calibrate scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/hmt-calibrate/SKILL.md · 64 lines

How it starts

The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Run automated Manning's n calibration against observed water surface elevations.

Prerequisites

  • Project opened from a base_case/ subdirectory
  • Observation CSV: columns x, y, wse or name, x, y, wse (comment lines start with #)
  • Solver paths configured in hmt_config.json

Steps

  1. Check that a project is open. If not, ask the user to run /hmt-open pointing to base_case/<project_file>.

  2. Validate the observation file. Ask the user for the observation CSV path (e.g., HWMs.dat).

    hmt-cli check_observation_format --args '{"csv_file": "<path>"}'
    

    Show the preview table. On error: report and ask for a corrected path.

  3. Show available materials.

    hmt-cli get_materials
    
  4. Ask the user for calibration parameters. For each material to calibrate:

    • Material name, minimum n, maximum n, optional initial guess
  5. Build validated parameter specifications.

    hmt-cli build_param_specs --args '{"specs": [
      {"type": "manning_n", "material_name": "<name>", "min": <min>, "max": <max>, "initial": <init>},
      ...
    ]}'
    

    Show the specs and confirm with the user.

  6. Optional: single test evaluation at initial values to verify the setup.

    hmt-cli evaluate_parameters --args '{"param_specs": <specs_with_initial_values>, "observation_csv": "<path>"}'
    

    If RMSE = 1e6, the simulation failed — check pyHMT2D.log before proceeding.

  7. Ask for settings: number of iterations (default: automatic) and method ("gp" or "nelder-mead").

  8. Run the calibration.

    hmt-cli run_calibration --args '{"param_specs": <specs>, "observation_csv": "<path>", "n_iterations": <N>, "method": "gp"}'
    

    Periodically show progress while waiting:

    tail -20 calib_progress.log
    
  9. Report results: best parameter values table, best RMSE, iterations completed, history CSV path.

Troubleshooting:

  • RMSE = 1,000,000 → check pyHMT2D.log for solver errors
  • Material not found → name must match exactly; copy from hmt-cli get_materials output

Read the full file on GitHub · 64 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 64 lines · 44 tokens per session scan A fb41dd252b5a

Subscribe to this mod's changes

hmt-calibrate is a skill published in the GitHub repository psu-efd/pyHMT2D (131 stars, last pushed 29d ago), licensed MIT. It adds 44 tokens to every session and 623 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories