Skip to content

AI-Hydro/Skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI-Hydro Skills

Domain-specific workflow playbooks for the AI-Hydro VS Code extension. Skills are injected into the agent's system prompt and guide multi-step hydrological analyses.

What is a Skill?

A Skill is a SKILL.md file that tells the AI-Hydro agent how to perform a specific hydrological workflow — step by step, with code examples, interpretation guidance, and common pitfalls. When a skill is installed and enabled, it becomes part of the agent's context for every conversation.

AI-Hydro Skills follow the Agent Skills open standard (SKILL.md format), compatible with Claude Code, Codex, Cursor, Cline, and Windsurf.

Available Skills

Hydrology Workflows

Skill Domain Description
Flood Frequency Analysis frequency-analysis Fit GEV/LP3 distributions, compute return-period quantiles
Drought Indices Calculation frequency-analysis SPI, SPEI, PDSI drought indices from precipitation and temperature
Baseflow Separation baseflow Lyne-Hollick & Eckhardt filters, BFI, recession analysis
Watershed Analysis Workflow composition End-to-end catchment characterisation
Batch Gauge Analysis composition Multi-gauge batch processing with parallel sub-agents
Ungauged Basin Transcription composition Regionalization and donor-gauge transfer for ungauged basins
Model Selection Guide modelling HBV vs LSTM decision framework
Calibration Diagnostics modelling NSE/KGE/FDC diagnostics, residual analysis
Signature Interpretation interpretation Interpret BFI, FDC slope, seasonality, runoff ratio
Snow Hydrology Trends interpretation Snowmelt timing, SWE trends, rain-on-snow analysis

Platform Tools (adapted from Anthropic patterns)

Skill Domain Description
Hydro Visualization interpretation Publication-quality figures — hydrographs, FDCs, Budyko plots, calibration diagnostics
Hydro Data Explorer interpretation Interactive HTML playgrounds — parameter explorers, gauge dashboards, return-period calculators
Interactive Module Builder general Create learning modules — HTML files with executable cells, sliders, quizzes, scrollytelling
Hydro Skill Creator general Author and improve reusable AI-Hydro workflow skills
MCP Tool Builder general Build new @mcp.tool() functions to extend AI-Hydro's capabilities

Installing Skills

Open AI-Hydro → click the Skills toolbar button → Marketplace tab → Install.

Skills are stored globally at ~/.aihydro/skills/ and injected automatically into the agent's system prompt.

Repository Structure

skills/
  <skill-id>/
    SKILL.md        ← workflow instructions (injected into agent)
    manifest.json   ← metadata for the marketplace
api/
  skills.json       ← auto-generated catalog (GitHub Pages)
.github/
  workflows/
    build-api.yml   ← regenerates skills.json on push

Contributing

See CONTRIBUTING.md to author and submit your own skill.

License

Skills are released under CC-BY-4.0.

About

Ai-Hydro Skills repo

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors