feat: water-engineer skill package v0.1.0

2026-08-14 16:50:55 +02:00
commit 2770b44859
10 changed files with 1155 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — water-engineer
+
+Where the content of this skill package comes from, counted by
+content items (tasks, competences, tools, evidence entries, curated
+knowledge). Rendered live by Gitea:
+
+```mermaid
+%%{init: {'theme':'base','themeVariables':{'pie1':'#f9a825','pie2':'#1e88e5','pie3':'#ff355e','pie4':'#d97757','pie5':'#8e24aa','pieOuterStrokeWidth':'0px','pieSectionTextColor':'#fff'}}}%%
+pie showData
+    title Content sources — water-engineer
+    "ESCO (occupation & competences)" : 74
+    "O*NET (tasks & tools)" : 76
+    "Job boards (market evidence)" : 110
+    "Anthropic official Claude skills" : 5
+    "External AI skill packs (mapped)" : 165
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 74 | 17.2 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 76 | 17.7 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 110 | 25.6 % | references/market.md (full report) + "Market evidence" headline sections |
+| Wikipedia & AI expert curation | 0 | 0.0 % | glossary, literature, usecases, intake, quality, evals/ |
+| Anthropic official Claude skills | 5 | 1.2 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 165 | 38.4 % | references/ai-skills.md (per-source attribution inside) |
+| Stack Exchange practitioner Q&A (CC-BY-SA) | 0 | 0.0 % | references/practitioner-qa.md (per-entry attribution inside) |
+
+Licensing: O*NET (USDOL/ETA, CC BY 4.0) · ESCO (© European Union) ·
+job-ad evidence via official APIs (JSearch/Adzuna) · Wikipedia content
+paraphrased with source URLs — never copied · external AI skills are
+linked, not copied (Apache-2.0/MIT/source-available, see ai-skills.md).
--- a/SKILL.md
+++ b/SKILL.md
@@ -0,0 +1,79 @@
+---
+name: water-engineer
+description: "Occupational skill for the role 'water engineer' (also: water resource engineer, hydraulic engineer, water systems engineer, water management specialist). Use when the user asks for typical water engineer work such as: Supervise teams of workers who capture water from wells and rivers.; Review or evaluate designs for water detention facilities, storm drains, flood control facilities, or other hydraulic structures.; Negotiate for water rights with communities or water facilities to meet water supply demands."
+---
+
+# Water Engineer
+
+Water engineers research and develop methods for the provision of clean water, water treatment and flood damage prevention and reaction. They research water needs in a location and develop methods for meeting those needs, such as designing and developing projects for managing water resources such as treatment plants, pipelines, pump systems, irrigation or draining systems and other water supply systems. Water engineers also ensure proper installation of these systems on construction sites. Water engineers also maintain, repair and build structures that control water resources, such as bridges, canals and dams.
+
+## Core workflow
+
+1. Supervise teams of workers who capture water from wells and rivers.
+2. Review or evaluate designs for water detention facilities, storm drains, flood control facilities, or other hydraulic structures.
+3. Negotiate for water rights with communities or water facilities to meet water supply demands.
+4. Perform hydrologic, hydraulic, or water quality modeling.
+5. Compile water resource data, using geographic information systems (GIS) or global position systems (GPS) software.
+6. Compile and maintain documentation on the health of a body of water.
+7. Write proposals, project reports, informational brochures, or other documents on wastewater purification, water supply and demand, or other water resource subjects.
+8. Recommend new or revised policies, procedures, or regulations to support water resource or conservation goals.
+
+## How to use this skill
+
+- Read [references/profile.md](references/profile.md) for the occupation profile and scope.
+- Consult [references/tasks.md](references/tasks.md) for the full task and activity inventory.
+- Check [references/skills.md](references/skills.md) for essential vs. optional competences.
+- Check [references/tools.md](references/tools.md) for the software commonly used in this role.
+- See [references/ai-skills.md](references/ai-skills.md) — matched external AI agent skills (per-source attribution).
+
+## Key competences (essential)
+
+- adjust engineering designs
+- advise on irrigation projects
+- analyse community needs
+- approve engineering design
+- conserve water resource
+- create designs for pipeline engineering
+- detect flaws in pipeline infrastructure
+- develop flood remediation strategies
+- engineering principles
+- engineering processes
+- ensure compliance with environmental legislation
+- ensure compliance with safety legislation
+- flood remediation equipment
+- hydraulic fluid
+- hydraulics
+
+## Hot technologies
+
+- Autodesk AutoCAD
+- Structured query language SQL
+- Microsoft Outlook
+- ESRI ArcGIS software
+- Microsoft Office software
+- Microsoft PowerPoint
+- Microsoft Excel
+- Microsoft Word
+
+
+<!-- hot-tech -->
+
+## Hot technologies
+
+Top tools from 34 gated job ads (see references/market.md, as of 2026-07-20):
+
+- HEC-RAS — 38 %
+- AutoCAD — 29 %
+- HEC-HMS — 21 %
+- SWMM — 21 %
+- ArcGIS — 18 %
+- AutoCAD Civil 3D — 18 %
+- MicroStation — 18 %
+- Microsoft Office — 15 %
+- OpenRoads Designer — 12 %
+- Revit — 12 %
+
+<!-- hot-tech -->
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/fcf9024e-277c-43c7-8ec8-8903e5c9c576), O*NET 30.3 (11-9121.02). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,250 @@
+{
+  "name": "water-engineer",
+  "title": "water engineer",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/fcf9024e-277c-43c7-8ec8-8903e5c9c576",
+    "esco_code": "2142.1.11",
+    "isco_group": "2142",
+    "onet_soc": "11-9121.02",
+    "crosswalk_match": "closeMatch"
+  },
+  "sources": [
+    {
+      "name": "ESCO",
+      "version": "1.2.1",
+      "url": "https://esco.ec.europa.eu/"
+    },
+    {
+      "name": "O*NET",
+      "version": "30.3",
+      "url": "https://www.onetcenter.org/",
+      "license": "CC BY 4.0"
+    }
+  ],
+  "attribution": "This package includes information from the O*NET Database (v30.3) by the U.S. Department of Labor, Employment and Training Administration (USDOL/ETA), CC BY 4.0. skillfactor is not endorsed by USDOL/ETA. ESCO data (v1.2.1) (c) European Union, used per the ESCO download conditions: https://esco.ec.europa.eu/en/use-esco/download",
+  "counts": {
+    "tasks": 21,
+    "dwas": 20,
+    "skills_essential": 24,
+    "skills_optional": 49,
+    "software": 34
+  },
+  "enrichment_ai_skills": {
+    "generated": "2026-07-14",
+    "method": "deterministic mapping (ISCO prefix + title/competence keywords)",
+    "sources": {
+      "anthropics/skills": {
+        "repo": "https://github.com/anthropics/skills",
+        "commit": "f6656c1",
+        "license": "Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available \u2014 see the LICENSE.txt in the upstream skill folder",
+        "skills": 2
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 8
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 8
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 8
+      },
+      "rohitg00/skillkit": {
+        "repo": "https://github.com/rohitg00/skillkit",
+        "commit": "d2e5c34",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "brycewang-stanford/Auto-Empirical-Research-Skills": {
+        "repo": "https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills",
+        "commit": "85bf545",
+        "license": "CC-BY-4.0",
+        "skills": 12
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 5
+      },
+      "foryourhealth111-pixel/Vibe-Skills": {
+        "repo": "https://github.com/foryourhealth111-pixel/Vibe-Skills",
+        "commit": "34429a8",
+        "license": "Apache-2.0",
+        "skills": 7
+      },
+      "affaan-m/everything-claude-code": {
+        "repo": "https://github.com/affaan-m/everything-claude-code",
+        "commit": "ed38744",
+        "license": "MIT",
+        "skills": 1
+      },
+      "nexu-io/open-design": {
+        "repo": "https://github.com/nexu-io/open-design",
+        "commit": "4b66023",
+        "license": "Apache-2.0",
+        "skills": 2
+      },
+      "AgriciDaniel/claude-blog": {
+        "repo": "https://github.com/AgriciDaniel/claude-blog",
+        "commit": "49842ea",
+        "license": "MIT",
+        "skills": 1
+      },
+      "infrasity-labs/dev-gtm-claude-skills": {
+        "repo": "https://github.com/infrasity-labs/dev-gtm-claude-skills",
+        "commit": "02cfefb",
+        "license": "MIT",
+        "skills": 2
+      },
+      "ferdinandobons/startup-skill": {
+        "repo": "https://github.com/ferdinandobons/startup-skill",
+        "commit": "a5f97c3",
+        "license": "MIT",
+        "skills": 1
+      },
+      "rampstackco/claude-skills": {
+        "repo": "https://github.com/rampstackco/claude-skills",
+        "commit": "bc6d961",
+        "license": "MIT",
+        "skills": 2
+      },
+      "mohitagw15856/pm-claude-skills": {
+        "repo": "https://github.com/mohitagw15856/pm-claude-skills",
+        "commit": "876fa30",
+        "license": "MIT",
+        "skills": 1
+      },
+      "mukul975/Anthropic-Cybersecurity-Skills": {
+        "repo": "https://github.com/mukul975/Anthropic-Cybersecurity-Skills",
+        "commit": "673da1f",
+        "license": "Apache-2.0",
+        "skills": 2
+      },
+      "hypnguyen1209/offensive-claude": {
+        "repo": "https://github.com/hypnguyen1209/offensive-claude",
+        "commit": "4d62be7",
+        "license": "MIT",
+        "skills": 1
+      },
+      "basicmachines-co/basic-memory": {
+        "repo": "https://github.com/basicmachines-co/basic-memory",
+        "commit": "53da71c",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "worldwonderer/novel-to-game": {
+        "repo": "https://github.com/worldwonderer/novel-to-game",
+        "commit": "3c18abd",
+        "license": "MIT",
+        "skills": 1
+      },
+      "SnailSploit/Claude-Red": {
+        "repo": "https://github.com/SnailSploit/Claude-Red",
+        "commit": "aeb41ec",
+        "license": "MIT",
+        "skills": 1
+      },
+      "0xwilliamortiz/claude-red": {
+        "repo": "https://github.com/0xwilliamortiz/claude-red",
+        "commit": "ad8436b",
+        "license": "MIT",
+        "skills": 1
+      },
+      "AgriciDaniel/claude-ads": {
+        "repo": "https://github.com/AgriciDaniel/claude-ads",
+        "commit": "669c760",
+        "license": "MIT",
+        "skills": 1
+      },
+      "jeremylongshore/claude-code-plugins-plus-skills": {
+        "repo": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills",
+        "commit": "e112938a",
+        "license": "MIT",
+        "skills": 4
+      },
+      "code-yeongyu/oh-my-openagent": {
+        "repo": "https://github.com/code-yeongyu/oh-my-openagent",
+        "commit": "b19f652",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "sanjay3290/ai-skills": {
+        "repo": "https://github.com/sanjay3290/ai-skills",
+        "commit": "3619692",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "nWave-ai/nWave": {
+        "repo": "https://github.com/nWave-ai/nWave",
+        "commit": "1d0f13c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "HeshamFS/materials-simulation-skills": {
+        "repo": "https://github.com/HeshamFS/materials-simulation-skills",
+        "commit": "fa1ce8d",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "avelikiy/great_cto": {
+        "repo": "https://github.com/avelikiy/great_cto",
+        "commit": "4fe1e39",
+        "license": "MIT",
+        "skills": 1
+      },
+      "uxKero/anydesign": {
+        "repo": "https://github.com/uxKero/anydesign",
+        "commit": "1b47880",
+        "license": "MIT",
+        "skills": 1
+      },
+      "wondelai/skills": {
+        "repo": "https://github.com/wondelai/skills",
+        "commit": "326b380",
+        "license": "MIT",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 78,
+      "adjacent": 2
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 74,
+      "onet": 76,
+      "jobads": 110,
+      "wiki_ai": 0,
+      "anthropic": 5,
+      "ai_skills": 165,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 17.2,
+      "onet": 17.7,
+      "jobads": 25.6,
+      "wiki_ai": 0.0,
+      "anthropic": 1.2,
+      "ai_skills": 38.4,
+      "stackx": 0.0
+    },
+    "method": "content items per source category"
+  },
+  "collar": "white",
+  "computer_work": true
+}
--- a/references/ai-skills.md
+++ b/references/ai-skills.md
@@ -0,0 +1,338 @@
+# External AI agent skills — water-engineer
+
+Proven, publicly available AI agent skills mapped to this occupation.
+Nothing is copied from the sources: every entry is a name, a one-line
+summary and a link to the upstream skill package. Each section names
+its source repository, commit, license and retrieval date.
+
+**Tiers:** `core` = the skill directly exercises a top market hard
+skill, tool or method (from gated job-ad evidence) or an essential
+ESCO competence of this occupation; `adjacent` =
+plausibly useful, secondary. Entries are capped at 12 per source
+and 80 in total per occupation (core first,
+strongest matches survive); everything beyond the caps is excluded
+and logged in the pipeline audit trail, not in this package.
+
+_Matched deterministically (ISCO group + title/competence keywords,
+tiered against market evidence + ESCO essentials) by
+`pipeline/p5_enrich_ai_skills.py` on 2026-07-14._
+
+## Source: anthropics/skills
+
+- Repository: [https://github.com/anthropics/skills](https://github.com/anthropics/skills) (commit `f6656c1`, retrieved 2026-07-14)
+- License: Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available — see the LICENSE.txt in the upstream skill folder
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `docx` | adjacent | Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to … | [source](https://github.com/anthropics/skills/tree/main/skills/docx) |
+| `pdf` | adjacent | Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating … | [source](https://github.com/anthropics/skills/tree/main/skills/pdf) |
+
+## Source: 0xwilliamortiz/claude-red
+
+- Repository: [https://github.com/0xwilliamortiz/claude-red](https://github.com/0xwilliamortiz/claude-red) (commit `ad8436b`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `offensive-reporting` | core | Penetration test and red team report writing methodology. Covers executive summary structuring (risk-led narrative for non-technical readers), technical finding format (title, severity, affected scope, narrative, reproduction steps, … | [source](https://github.com/0xwilliamortiz/claude-red/tree/ad8436b/Skills/utility/offensive-reporting) |
+
+## Source: a5c-ai/babysitter
+
+- Repository: [https://github.com/a5c-ai/babysitter](https://github.com/a5c-ai/babysitter) (commit `44a5d58b`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `context-engineering` | core | Context window monitoring and budget management. Keeps orchestrator at 15-30% context usage while subagents get full 200k tokens. Provides warnings at thresholds, context-aware summarization triggers, and wave-level budget planning. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/methodologies/gsd/skills/context-engineering) |
+| `quantitative-methods` | core | Design and execute statistical analyses including regression modeling, hypothesis testing, power analysis, and robustness checks using R, Stata, SPSS, or Python | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/social-sciences-humanities/social-sciences/skills/quantitative-methods) |
+| `doe-designer` | core | Design of Experiments planning and analysis skill for factorial and response surface experiments. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/industrial-engineering/skills/doe-designer) |
+| `simulation-experiment-designer` | core | Simulation experimental design skill for efficient scenario analysis and optimization. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/industrial-engineering/skills/simulation-experiment-designer) |
+| `A/B Test Design` | core | Statistical experiment design and analysis capabilities for product experimentation | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/product-management/skills/ab-test-design) |
+
+## Source: affaan-m/everything-claude-code
+
+- Repository: [https://github.com/affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) (commit `ed38744`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `blueprint` | core | Turn a one-line objective into a step-by-step construction plan for multi-session, multi-agent engineering projects. Each step has a self-contained context brief so a fresh agent can execute it cold. Includes adversarial review gate, … | [source](https://github.com/affaan-m/everything-claude-code/tree/ed38744/skills/blueprint) |
+
+## Source: AgriciDaniel/claude-ads
+
+- Repository: [https://github.com/AgriciDaniel/claude-ads](https://github.com/AgriciDaniel/claude-ads) (commit `669c760`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ads-test` | core | Design and evaluate paid-ad experiments with hypotheses, randomization units, sample-size and duration assumptions, guardrails, platform experiment tools, analysis, and decision rules. Use for A/B test, split test, experiment design, … | [source](https://github.com/AgriciDaniel/claude-ads/tree/669c760/skills/ads-test) |
+
+## Source: AgriciDaniel/claude-blog
+
+- Repository: [https://github.com/AgriciDaniel/claude-blog](https://github.com/AgriciDaniel/claude-blog) (commit `49842ea`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `blog-strategy` | core | Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI Overviews, distribution channel planning … | [source](https://github.com/AgriciDaniel/claude-blog/tree/49842ea/skills/blog-strategy) |
+
+## Source: avelikiy/great_cto
+
+- Repository: [https://github.com/avelikiy/great_cto](https://github.com/avelikiy/great_cto) (commit `4fe1e39`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `anydesign` | core | Analyze images, websites, and Figma files to extract their design and generate a `design.md` with token system, component inventory, and reconstruction notes. Use this skill whenever the user wants to understand, document, replicate, or … | [source](https://github.com/avelikiy/great_cto/tree/4fe1e39/skills/anydesign) |
+
+## Source: basicmachines-co/basic-memory
+
+- Repository: [https://github.com/basicmachines-co/basic-memory](https://github.com/basicmachines-co/basic-memory) (commit `53da71c`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `memory-literary-analysis` | core | Analyze a complete literary work into a structured Basic Memory knowledge graph. Covers schema design, entity seeding, chapter-by-chapter processing, cross-referencing, validation, and visualization. | [source](https://github.com/basicmachines-co/basic-memory/tree/53da71c/skills/memory-literary-analysis) |
+
+## Source: brycewang-stanford/Auto-Empirical-Research-Skills
+
+- Repository: [https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills) (commit `85bf545`, retrieved 2026-07-14)
+- License: CC-BY-4.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `law-skills` | core | 9 legal research skills. Trigger: legal research, case law analysis, regulatory compliance. Design: legal databases, citation networks, and judicial analytics tools. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/law) |
+| `g2` | core | Publication Specialist - Writing, Review, Pre-registration & Quality Assurance Light VS applied: Avoids template-based writing + audience-specific message design Absorbed G3 (Peer Review Strategist), G4 (Pre-registration Composer), F1-F3 … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/25-HosungYou-Diverga/skills/g2) |
+| `claude-scientific-guide` | core | Ready-to-use agent skills for scientific research and engineering | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/methodology/claude-scientific-guide) |
+| `methodology-skills` | core | 13 research methodology skills. Trigger: study design, methodology selection, scientific reasoning, mentoring. Design: rigorous methods frameworks covering qualitative, quantitative, and mixed approaches. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/methodology) |
+| `psychology-research-guide` | core | Psychological research methods, experimental design, and analysis | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/social-science/psychology-research-guide) |
+| `universal-ma-codebook` | core | Universal Meta-Analysis Codebook v2.2 - AI-Human collaboration for meta-analysis data extraction. 4-layer design: Identifiers, Statistics, AI Provenance, Human Verification. Integrates with C5/C6/C7 agents and Category I systematic review … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/25-HosungYou-Diverga/skills/universal-ma-codebook) |
+| `metadata-skills` | core | 24 metadata & bibliometrics skills. Trigger: DOI resolution, citation metrics, author disambiguation, bibliometrics. Design: metadata APIs and bibliometric analysis tools for scholarly records. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/literature/metadata) |
+| `paper-review-skills` | core | 8 peer review skills. Trigger: reviewing manuscripts, comparing papers, quality assessment. Design: systematic review criteria, evaluation rubrics, and automated review tools. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/paper-review) |
+| `aer-statspai` | core | Use when aer-identification has fixed the design, after methodology choice and before aer-robustness or aer-tables-figures, to run an AER-track analysis with StatsPAI — the agent-native Python engine and MCP server for causal inference, … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/50-brycewang-aer-skills/skills/aer-statspai) |
+| `new-project` | core | Full research pipeline from idea to paper. Orchestrates all phases — discovery, strategy, analysis, writing, peer review, and submission. Use when starting a new research project from scratch. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/16-hsantanna88-clo-author/dot-claude/skills/new-project) |
+| `statistics-skills` | core | 10 statistical analysis skills. Trigger: statistical tests, Bayesian analysis, hypothesis testing, sampling. Design: method guides covering assumptions, code, and result interpretation. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/analysis/statistics) |
+| `review-julia` | core | Run the Julia code review protocol on Julia scripts. Checks code quality, type stability, parallel computing patterns, and scientific computing standards. Produces a report without editing files. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/14-luischanci-claude-code-research-starter/dot-claude/skills/review-julia) |
+
+## Source: code-yeongyu/oh-my-openagent
+
+- Repository: [https://github.com/code-yeongyu/oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) (commit `b19f652`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `debugging` | core | MUST USE for any real runtime debugging across ANY language or binary — crashes, silent failures, wrong responses, stuck processes, memory leaks, async misbehavior, unexplained timing, reverse engineering. Runs a hypothesis-driven loop: … | [source](https://github.com/code-yeongyu/oh-my-openagent/tree/b19f652/packages/shared-skills/skills/debugging) |
+
+## Source: davila7/claude-code-templates
+
+- Repository: [https://github.com/davila7/claude-code-templates](https://github.com/davila7/claude-code-templates) (commit `fa79251`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `scientific-critical-thinking` | core | Evaluate research rigor. Assess methodology, experimental design, statistical validity, biases, confounding, evidence quality (GRADE, Cochrane ROB), for critical analysis of scientific claims. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/scientific-critical-thinking) |
+| `pymoo` | core | Multi-objective optimization framework. NSGA-II, NSGA-III, MOEA/D, Pareto fronts, constraint handling, benchmarks (ZDT, DTLZ), for engineering design and optimization problems. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/pymoo) |
+| `cobrapy` | core | Constraint-based metabolic modeling (COBRA). FBA, FVA, gene knockouts, flux sampling, SBML models, for systems biology and metabolic engineering analysis. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/cobrapy) |
+| `latex-posters` | core | Create professional research posters in LaTeX using beamerposter, tikzposter, or baposter. Support for conference presentations, academic posters, and scientific communication. Includes layout design, color schemes, multi-column formats, … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/latex-posters) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/scientific-slides) |
+| `crewai` | core | Expert in CrewAI - the leading role-based multi-agent framework used by 60% of Fortune 500 companies. Covers agent design with roles and goals, task definition, crew orchestration, process types (sequential, hierarchical, parallel), memory … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/crewai) |
+| `diffdock` | core | Diffusion-based molecular docking. Predict protein-ligand binding poses from PDB/SMILES, confidence scores, virtual screening, for structure-based drug design. Not for affinity prediction. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/diffdock) |
+| `exploratory-data-analysis` | core | Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats. This skill should be used when analyzing any scientific data file to understand its structure, content, quality, and characteristics. … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/exploratory-data-analysis) |
+
+## Source: ferdinandobons/startup-skill
+
+- Repository: [https://github.com/ferdinandobons/startup-skill](https://github.com/ferdinandobons/startup-skill) (commit `a5f97c3`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `startup-design` | core | Design, validate, and plan a startup from scratch. Covers market research, competitive analysis, business model, brand identity, product definition, financial projections, and validation experiments. Trigger when the user has a startup … | [source](https://github.com/ferdinandobons/startup-skill/tree/a5f97c3/startup-design) |
+
+## Source: foryourhealth111-pixel/Vibe-Skills
+
+- Repository: [https://github.com/foryourhealth111-pixel/Vibe-Skills](https://github.com/foryourhealth111-pixel/Vibe-Skills) (commit `34429a8`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `scientific-critical-thinking` | core | Evaluate scientific claims and evidence quality. Use for assessing experimental design validity, identifying biases and confounders, applying evidence grading frameworks (GRADE, Cochrane Risk of Bias), or teaching critical analysis. Best … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-critical-thinking) |
+| `designing-experiments` | core | Design experiments and quasi-experiments before analysis. Use when choosing study design, treatment/control structure, outcomes, assumptions, validation plans after scientific experiment failure, or which of DiD, ITS, synthetic control, or … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/designing-experiments) |
+| `scientific-reporting` | core | Write research/technical reports with strong structure + figure standards. Supports Markdown/HTML/PDF outputs (Quarto optional), executive summary, methods, results, discussion, and reproducibility appendix. | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-reporting) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-slides) |
+| `markdown-mermaid-writing` | core | Comprehensive markdown and Mermaid diagram writing skill that establishes text-based diagrams as the DEFAULT documentation standard. Use this skill when creating ANY scientific document, report, analysis, or visualization — it ensures all … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/markdown-mermaid-writing) |
+| `exploratory-data-analysis` | core | Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats. This skill should be used when analyzing any scientific data file to understand its structure, content, quality, and characteristics. … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/exploratory-data-analysis) |
+| `scientific-schematics` | core | Create publication-quality scientific diagrams using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-schematics) |
+
+## Source: HeshamFS/materials-simulation-skills
+
+- Repository: [https://github.com/HeshamFS/materials-simulation-skills](https://github.com/HeshamFS/materials-simulation-skills) (commit `fa1ce8d`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `parameter-optimization` | core | Explore and optimize simulation parameters via design of experiments (DOE), sensitivity analysis, and optimizer selection — generate Latin Hypercube, quasi-random, or factorial sample plans, rank parameter influence with sensitivity … | [source](https://github.com/HeshamFS/materials-simulation-skills/tree/fa1ce8d/skills/simulation-workflow/parameter-optimization) |
+
+## Source: hypnguyen1209/offensive-claude
+
+- Repository: [https://github.com/hypnguyen1209/offensive-claude](https://github.com/hypnguyen1209/offensive-claude) (commit `4d62be7`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `malware-analysis` | core | Use when reverse-engineering or detecting malware — static triage + capa/YARA-X, emulation/DBI/.NET unpacking, dynamic/fileless/Volatility 3 memory analysis, C2 config extraction (Cobalt Strike/CAPE), C2 traffic detection (JA4+, beaconing) | [source](https://github.com/hypnguyen1209/offensive-claude/tree/4d62be7/skills/malware-analysis) |
+
+## Source: infrasity-labs/dev-gtm-claude-skills
+
+- Repository: [https://github.com/infrasity-labs/dev-gtm-claude-skills](https://github.com/infrasity-labs/dev-gtm-claude-skills) (commit `02cfefb`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `blog-strategy` | core | Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI Overviews, distribution channel planning … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/.claude/skills/blog-strategy) |
+| `anydesign` | core | Analyze images, websites, and Figma files to extract their design and generate a `design.md` with token system, component inventory, and reconstruction notes. Use this skill whenever the user wants to understand, document, replicate, or … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/.claude/skills/anydesign) |
+
+## Source: jeremylongshore/claude-code-plugins-plus-skills
+
+- Repository: [https://github.com/jeremylongshore/claude-code-plugins-plus-skills](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) (commit `e112938a`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `apify-cost-tuning` | core | Optimize Apify platform costs through memory tuning, compute unit management, and proxy budgeting. Use when analyzing Apify billing, reducing Actor run costs, or implementing usage monitoring and budget alerts. Trigger: "apify cost", … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/saas-packs/apify-pack/skills/apify-cost-tuning) |
+| `hypothesis-tester` | core | Structured hypothesis formulation, experiment design, and results interpretation for Product Managers. Use when the user needs to validate an assumption, design an A/B test, evaluate experiment results, or decide whether to ship based on … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/productivity/pm-ai-partner/skills/hypothesis-tester) |
+| `procore-cost-tuning` | core | Procore cost tuning \u2014 construction management platform integration.\n\ Use when working with Procore API for project management, RFIs, or submittals.\n\ Trigger with phrases like \"procore cost tuning\", \"procore-cost-tuning\".\n | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/saas-packs/procore-pack/skills/procore-cost-tuning) |
+| `cro-methodology` | core | Audit websites and landing pages for conversion issues and design evidence-based A/B tests. Use when the user mentions "landing page isnt converting", "conversion rate", "A/B test", "why visitors leave", "objection handling", "bounce … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/business-tools/wondelai-cro-methodology) |
+
+## Source: K-Dense-AI/claude-scientific-skills
+
+- Repository: [https://github.com/K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `hugging-science` | core | Use when the user is doing AI/ML work in a scientific domain such as biology, chemistry, physics, astronomy, climate, genomics, materials, medicine, ecology, energy, engineering, math, drug discovery, protein design, weather modeling, … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/hugging-science) |
+| `scientific-critical-thinking` | core | Evaluate scientific claims and evidence quality. Use for assessing experimental design validity, identifying biases and confounders, applying evidence grading frameworks (GRADE, Cochrane Risk of Bias), or teaching critical analysis. Best … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/scientific-critical-thinking) |
+| `latex-posters` | core | Create professional research posters in LaTeX using beamerposter, tikzposter, or baposter. Support for conference presentations, academic posters, and scientific communication. Includes layout design, color schemes, multi-column formats, … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/latex-posters) |
+| `exa-search` | core | Web toolkit powered by Exa, tuned for scientific and technical content. Use this skill when the user needs to search the web or fetch/extract URL content. Covers: web search (semantic lookups, research, current info — with optional … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/exa-search) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/scientific-slides) |
+| `markdown-mermaid-writing` | core | Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/markdown-mermaid-writing) |
+| `exploratory-data-analysis` | core | Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats. This skill should be used when analyzing any scientific data file to understand its structure, content, quality, and characteristics. … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/exploratory-data-analysis) |
+| `scientific-schematics` | core | Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.1 Pro Preview for quality review. Only regenerates if quality is below threshold for your document type. Specialized in … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/scientific-schematics) |
+
+## Source: K-Dense-AI/scientific-agent-skills
+
+- Repository: [https://github.com/K-Dense-AI/scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) (commit `4d97e29`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `hugging-science` | core | Use when the user is doing AI/ML work in a scientific domain such as biology, chemistry, physics, astronomy, climate, genomics, materials, medicine, ecology, energy, engineering, math, drug discovery, protein design, weather modeling, … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/hugging-science) |
+| `scientific-critical-thinking` | core | Evaluate scientific claims and evidence quality. Use for assessing experimental design validity, identifying biases and confounders, applying evidence grading frameworks (GRADE, Cochrane Risk of Bias), or teaching critical analysis. Best … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/scientific-critical-thinking) |
+| `latex-posters` | core | Create professional research posters in LaTeX using beamerposter, tikzposter, or baposter. Support for conference presentations, academic posters, and scientific communication. Includes layout design, color schemes, multi-column formats, … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/latex-posters) |
+| `exa-search` | core | Web toolkit powered by Exa, tuned for scientific and technical content. Use this skill when the user needs to search the web or fetch/extract URL content. Covers: web search (semantic lookups, research, current info — with optional … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/exa-search) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/scientific-slides) |
+| `markdown-mermaid-writing` | core | Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/markdown-mermaid-writing) |
+| `exploratory-data-analysis` | core | Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats. This skill should be used when analyzing any scientific data file to understand its structure, content, quality, and characteristics. … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/exploratory-data-analysis) |
+| `scientific-schematics` | core | Create publication-quality scientific diagrams using Nano Banana 2 AI with smart iterative refinement. Uses Gemini 3.1 Pro Preview for quality review. Only regenerates if quality is below threshold for your document type. Specialized in … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/scientific-schematics) |
+
+## Source: mohitagw15856/pm-claude-skills
+
+- Repository: [https://github.com/mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) (commit `876fa30`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `experiment-designer` | core | Design statistically rigorous A/B tests and interpret experiment results. Use when asked to design an experiment, run an A/B test, calculate sample size, interpret test results, or assess whether an experiment was successful. Produces a … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-advanced/skills/experiment-designer) |
+
+## Source: mukul975/Anthropic-Cybersecurity-Skills
+
+- Repository: [https://github.com/mukul975/Anthropic-Cybersecurity-Skills](https://github.com/mukul975/Anthropic-Cybersecurity-Skills) (commit `673da1f`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `implementing-security-chaos-engineering` | core | Implements security chaos engineering experiments that deliberately disable or degrade security controls to verify detection and response capabilities. Tests WAF bypass, firewall rule removal, log pipeline disruption, and EDR disablement … | [source](https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/673da1f/skills/implementing-security-chaos-engineering) |
+| `analyzing-macro-malware-in-office-documents` | core | Analyzes malicious VBA macros embedded in Microsoft Office documents (Word, Excel, PowerPoint) to identify download cradles, payload execution, persistence mechanisms, and anti-analysis techniques. Uses olevba, oledump, and VBA … | [source](https://github.com/mukul975/Anthropic-Cybersecurity-Skills/tree/673da1f/skills/analyzing-macro-malware-in-office-documents) |
+
+## Source: nexu-io/open-design
+
+- Repository: [https://github.com/nexu-io/open-design](https://github.com/nexu-io/open-design) (commit `4b66023`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `html-ppt-zhangzara-coral` | core | Open Design's community-growth campaign across GitHub, Discord, and X: the loops, the content calendar, and the pipeline math. Built as a decision-grade marketing & GTM deck for growth team, community lead. | [source](https://github.com/nexu-io/open-design/tree/4b66023/design-templates/html-ppt-zhangzara-coral) |
+| `slides` | core | Create and edit .pptx presentation decks with PptxGenJS. Useful for sales decks, kickoff briefs, and design-system showcases. | [source](https://github.com/nexu-io/open-design/tree/4b66023/skills/slides) |
+
+## Source: nWave-ai/nWave
+
+- Repository: [https://github.com/nWave-ai/nWave](https://github.com/nWave-ai/nWave) (commit `1d0f13c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `nw-interviewing-techniques` | core | Mom Test questioning toolkit, JTBD analysis, interview conduct, assumption testing framework, and hypothesis design | [source](https://github.com/nWave-ai/nWave/tree/1d0f13c/nWave/skills/nw-interviewing-techniques) |
+
+## Source: rampstackco/claude-skills
+
+- Repository: [https://github.com/rampstackco/claude-skills](https://github.com/rampstackco/claude-skills) (commit `bc6d961`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `experiment-design` | core | A discipline for designing experiments (A/B tests, multivariate, holdouts) so the results actually answer the question you asked. Hypothesis writing, sample size, duration, segment analysis, interpretation, decision-making, and the common … | [source](https://github.com/rampstackco/claude-skills/tree/bc6d961/skills/experiment-design) |
+| `cro-optimization` | core | Run conversion rate optimization through hypothesis-driven testing including audit, hypothesis generation, test design, statistical analysis, and rollout decisions. Use this skill whenever the user wants to optimize conversion, run A/B … | [source](https://github.com/rampstackco/claude-skills/tree/bc6d961/skills/cro-optimization) |
+
+## Source: rohitg00/skillkit
+
+- Repository: [https://github.com/rohitg00/skillkit](https://github.com/rohitg00/skillkit) (commit `d2e5c34`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `design-first` | core | Guides the creation of technical design documents before writing code, producing architecture diagrams, data models, API interface definitions, implementation plans, and multi-option trade-off analyses. Use when the user asks to plan a … | [source](https://github.com/rohitg00/skillkit/tree/d2e5c34/packages/core/src/methodology/packs/planning/design-first) |
+
+## Source: sanjay3290/ai-skills
+
+- Repository: [https://github.com/sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) (commit `3619692`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `deep-research` | core | Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited … | [source](https://github.com/sanjay3290/ai-skills/tree/3619692/skills/deep-research) |
+
+## Source: SnailSploit/Claude-Red
+
+- Repository: [https://github.com/SnailSploit/Claude-Red](https://github.com/SnailSploit/Claude-Red) (commit `aeb41ec`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `offensive-reporting` | core | Penetration test and red team report writing methodology. Covers executive summary structuring (risk-led narrative for non-technical readers), technical finding format (title, severity, affected scope, narrative, reproduction steps, … | [source](https://github.com/SnailSploit/Claude-Red/tree/aeb41ec/Skills/utility/offensive-reporting) |
+
+## Source: uxKero/anydesign
+
+- Repository: [https://github.com/uxKero/anydesign](https://github.com/uxKero/anydesign) (commit `1b47880`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `anydesign` | core | Analyze images, websites, and Figma files to extract their design and generate a `design.md` with token system, component inventory, and reconstruction notes. Use this skill whenever the user wants to understand, document, replicate, or … | [source](https://github.com/uxKero/anydesign/tree/1b47880) |
+
+## Source: wondelai/skills
+
+- Repository: [https://github.com/wondelai/skills](https://github.com/wondelai/skills) (commit `326b380`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `cro-methodology` | core | Audit websites and landing pages for conversion issues and design evidence-based A/B tests. Use when the user mentions "landing page isnt converting", "conversion rate", "A/B test", "why visitors leave", "objection handling", "bounce … | [source](https://github.com/wondelai/skills/tree/326b380/cro-methodology) |
+
+## Source: worldwonderer/novel-to-game
+
+- Repository: [https://github.com/worldwonderer/novel-to-game](https://github.com/worldwonderer/novel-to-game) (commit `3c18abd`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `novel-to-game` | core | Turn a novel into a playable web game. Orchestrates the whole adaptation pipeline — requirements intake, gameable deconstruction, concept selection, world and visual design, agent build, and evidence-based QA — for a novel in any language. … | [source](https://github.com/worldwonderer/novel-to-game/tree/3c18abd/skills/novel-to-game) |
--- a/references/berufsbild-de.md
+++ b/references/berufsbild-de.md
@@ -0,0 +1,73 @@
+# Berufsbild (Deutschland) — Ingenieur/in - Wasserwirtschaft
+
+> **Quelle:** BERUFENET, Bundesagentur für Arbeit — Beruf-ID 59343,
+> KldB 2010: B 31144 · via öffentliche BERUFENET-API,
+> abgerufen 2026-07-12. Automatisches Label-Matching
+> (Score 1.00); Inhalte paraphrasiert/gekürzt, Volltext beim
+> Original: https://web.arbeitsagentur.de/berufenet/beruf/59343
+
+## Aufgaben und Tätigkeiten kompakt
+
+Ingenieure und Ingenieurinnen für Wasserwirtschaft untersuchen Wasservorkommen in Fluss- und Versorgungsgebieten, um deren optimale Nutzung zu planen. Sie kümmern sich um Hochwasser- oder Küstenschutz, konzipieren Schutz- und Sanierungsprojekte für Gewässer und Böden, Flussregulierungen oder Gewässerrenaturierungen. Sie leiten Projekte ein, wirken bei Genehmigungsverfahren mit und überprüfen wasserrechtliche Vorschriften, etwa zum Erosionsschutz. Sie entwickeln Anlagen, die mit der Ressource Wasser zu tun haben (z.B. Wasserwerke). Sie stellen Berechnungen an, fertigen Pläne und Zeichnungen und überwachen die Bauausführung. Anschließend nehmen sie die Anlagen in Betrieb und sorgen dafür, dass sie störungsfrei und wirtschaftlich funktionieren.
+
+## Tätigkeitsbezeichnungen
+
+Ingenieur/in - Wasserwirtschaft
+
+Auch übliche Berufsbezeichnung/SynonymBauingenieur/in für Wasserbau
+
+Berufsbezeichnungen in englischer SpracheHydraulic engineer (m/f)
+
+Water engineer (m/f)
+
+Berufsbezeichnung in französischer SpracheIngénieur/Ingénieure en traitement des eaux
+
+## Die Tätigkeit im Überblick
+
+Ingenieure und Ingenieurinnen für Wasserwirtschaft entwickeln Konzepte, um Gewässer und Böden zu schützen oder zu sanieren, Flüsse zu regulieren und Gewässer zu renaturieren. Sie planen Anlagen der Wassergewinnung, -aufbereitung, -speicherung, -verteilung und -entsorgung.
+
+## Trends
+
+Digitales WasserDer Begriff "Digitales Wasser" bezeichnet den Einsatz digitaler Technologien in der Wasserwirtschaft. Dabei werden Anlagen und Prozesse in der Wasserversorgung und Abwasserbehandlung automatisiert, digitalisiert und vernetzt. Der Digitale Repräsentation eines realen Objekts, etwa von Produktionslinien, Maschinen, Fahrzeugen, medizinischen Implantaten oder ganzen Städten und Fabriken. Digitale Zwillinge sind aus Daten und Algorithmen aufgebaut und können über Sensoren mit der realen Welt gekoppelt sein. Die ständige Übertragung von Realdaten ermöglicht eine Echtzeit-Simulation des Verhaltens des physischen Vorbilds.
+" name="Digitaler Zwilling">Digitale Zwillinge einer Kläranlage erleichtert z.B. deren Optimierung und Instandhaltung. Frühwarnsysteme können Störungen erkennen bzw. vermeiden und bei Extremwetterlagen helfen. Aber auch einzelne Systemkomponenten wie intelligente Pumpen oder Online-Messtechniken können Prozesse flexibler gestalten. Fach- und Führungskräfte werden sich auf die technologischen Entwicklungen vorbereiten.
+
+## Aufgaben und Tätigkeiten (Beschreibung)
+
+Worum geht es?Ingenieure und Ingenieurinnen für Wasserwirtschaft entwickeln Konzepte, um Gewässer und Böden zu schützen oder zu sanieren, Flüsse zu regulieren und Gewässer zu renaturieren. Sie planen Anlagen der Wassergewinnung, -aufbereitung, -speicherung, -verteilung und -entsorgung.
+Wasserversorgung und Abwasserentsorgung Ingenieure und Ingenieurinnen für Wasserwirtschaft gewährleisten durch Schadstoffmessungen und -analysen von Gewässern und entsprechende Schutzmaßnahmen, dass die gesetzlichen Anforderungen an die Wasserqualität eingehalten werden. Beispielsweise überwachen sie die Einleitungen aus der Landwirtschaft und aus Industriebetrieben in Gewässer oder überprüfen den Einsatz naturnaher Verfahren und Kläranlagen bei der Abwasserreinigung.
+Anlagen nach MaßIngenieure und Ingenieurinnen für Wasserwirtschaft planen Bauten und Anlagen, die dem Hochwasser- und Erosionsschutz dienen oder die Wasserver- und -entsorgung sicherstellen (z.B. Wassergewinnungs-, Wasseraufbereitungs-, Wasserverteilungs- und Abwasseranlagen). Auch die Regulierung der Flüsse, der Bau von Trinkwasserspeichern, von Kanälen, Schleusen und Häfen und die Renaturierung von Gewässern sind mögliche Aufgaben. Außerdem errichten sie Wasserkraftwerke zur Stromgewinnung und Anlagen zur Be- und Entwässerung im Bereich der Landwirtschaft.
+Überwachung und VerwaltungAls Bauleiter/innen von größeren Bauprojekten sind die Ingenieure und Ingenieurinnen für die termin- und sachgerechte Durchführung der Baumaßnahmen verantwortlich. Auch das Überwachen des laufenden Betriebs kann zu ihrem Aufgabengebiet gehören. Für den Betrieb von technischen Anlagen, z.B. Ver- und Entsorgungsanlagen oder Wasserkraftwerken, sind immer wieder Anpassungs- und Erhaltungsmaßnahmen nötig, um optimale Funktionsfähigkeit und Wirtschaftlichkeit zu sichern. Ebenso übernehmen sie Sanierungsaufgaben, beispielsweise an Kanälen und Abwasserentsorgungsanlagen.
+In Behörden des Bundes, der Länder oder der Kommunen prüfen die Ingenieure und Ingenieurinnen z.B. Bauanträge nach wasser- und umweltschutzrechtlichen Kriterien, erteilen Baugenehmigungen und überwachen das Einhalten der gesetzlichen Bestimmungen. Sie wirken auch bei der Festsetzung von Wasserschutzgebieten oder von Bedingungen für die Gewässerbenutzung auf Seen und Flüssen mit.
+Vielfältige EinsatzmöglichkeitenFragen des nachhaltigen Umwelt- und Ressourcenschutzes und der Gefahrenabwehr z.B. durch Hochwasser nehmen in der Wasserwirtschaft einen wichtigen Raum ein. Ingenieu
+
+## Aufgaben und Tätigkeiten im Einzelnen
+
+Analyse, Planung und KontrolleUntersuchungen durchführen, Gewässergüte prüfen
+
+ Einhaltung wasserrechtlicher Vorschriften und Gesetze überwachen
+
+ Konzepte, Verfahren und Anlagen entwickeln
+
+Baugenehmigungsverfahren unter Berücksichtigung wasser- und umweltschutzrechtlicher Bestimmungen bearbeiten
+
+Vergleich verschiedener wasserwirtschaftlicher Ansätze unter ökologischen, technischen und wirtschaftlichen Aspekten durchführen
+
+Kosten kalkulieren, Konstruktionspläne und baureife Ausführungsunterlagen erarbeiten, Ausschreibungsunterlagen erstellen
+
+Beratungs- und Leitungsaufgaben in wasserwirtschaftlichen Fragen übernehmen
+
+als Bausachverständige/r Gutachten und Prüfberichte erstellen
+
+Umsetzung und Durchführung Ingenieurbaumaßnahmen zu Wassergewinnung, -aufbereitung, -speicherung, -verteilung und -entsorgung sowie Gewässer- und Umweltschutz ausführen
+
+Wasserschutzgebiete ausweisen, Wasserbewirtschaftungspläne erarbeiten
+
+ Wirtschaftlichkeit und Nachhaltigkeit sicherstellen
+
+Bauleitung für das jeweilige Bauobjekt übernehmen
+
+Wissenschaftliche Forschung und Lehrean Forschungsvorhaben mitwirken
+
+Vorlesungen und Seminare vorbereiten bzw. abhalten, Unterricht nachbereiten, ggf. Prüfungen abnehmen
+
+Forschungsberichte verfassen
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,151 @@
+# Market evidence report — water-engineer
+
+Source: **34 real job ads** (JSearch API, countries: us 34), extracted into the MSSQL evidence store; as of 2026-07-20.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| mid | 18 | 53 % |
+| senior | 11 | 32 % |
+| junior | 4 | 12 % |
+| lead | 1 | 3 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | HEC-RAS | 13 | 38 % |
+| 2 | AutoCAD | 10 | 29 % |
+| 3 | HEC-HMS | 7 | 21 % |
+| 4 | SWMM | 7 | 21 % |
+| 5 | ArcGIS | 6 | 18 % |
+| 6 | AutoCAD Civil 3D | 6 | 18 % |
+| 7 | MicroStation | 6 | 18 % |
+| 8 | Microsoft Office | 5 | 15 % |
+| 9 | OpenRoads Designer | 4 | 12 % |
+| 10 | Revit | 4 | 12 % |
+| 11 | GEO-RAS | 3 | 9 % |
+| 12 | HEC-1 | 3 | 9 % |
+| 13 | Microsoft Excel | 3 | 9 % |
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | hydraulic modeling | 13 | 38 % |
+| 2 | hydrologic modeling | 9 | 26 % |
+| 3 | cost estimation | 7 | 21 % |
+| 4 | regulatory compliance | 7 | 21 % |
+| 5 | data analysis | 6 | 18 % |
+| 6 | stormwater management | 6 | 18 % |
+| 7 | drainage design | 5 | 15 % |
+| 8 | project management | 5 | 15 % |
+| 9 | technical report writing | 5 | 15 % |
+| 10 | engineering design | 4 | 12 % |
+| 11 | hydraulic analysis | 4 | 12 % |
+| 12 | hydrology | 4 | 12 % |
+| 13 | engineering plan preparation | 3 | 9 % |
+| 14 | hydraulic calculations | 3 | 9 % |
+| 15 | stormwater system design | 3 | 9 % |
+| 16 | technical report preparation | 3 | 9 % |
+| 17 | technical specification development | 3 | 9 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | report preparation | 8 | 24 % |
+| 2 | project planning | 6 | 18 % |
+| 3 | technical leadership | 4 | 12 % |
+| 4 | client communication | 3 | 9 % |
+| 5 | data interpretation | 3 | 9 % |
+| 6 | design calculation production | 3 | 9 % |
+| 7 | project delivery | 3 | 9 % |
+| 8 | proposal development | 3 | 9 % |
+| 9 | proposal preparation | 3 | 9 % |
+| 10 | task management | 3 | 9 % |
+
+## Regional breakdown
+
+> **Corpus note:** 34 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+34 ads.
+
+**Top hard skills:**
+
+- hydraulic modeling — 38 % (13 ads)
+- hydrologic modeling — 26 % (9 ads)
+- cost estimation — 21 % (7 ads)
+- regulatory compliance — 21 % (7 ads)
+- data analysis — 18 % (6 ads)
+- stormwater management — 18 % (6 ads)
+- drainage design — 15 % (5 ads)
+- project management — 15 % (5 ads)
+- technical report writing — 15 % (5 ads)
+- engineering design — 12 % (4 ads)
+
+**Top tools:**
+
+- HEC-RAS — 38 % (13 ads)
+- AutoCAD — 29 % (10 ads)
+- HEC-HMS — 21 % (7 ads)
+- SWMM — 21 % (7 ads)
+- ArcGIS — 18 % (6 ads)
+- AutoCAD Civil 3D — 18 % (6 ads)
+- MicroStation — 18 % (6 ads)
+- Microsoft Office — 15 % (5 ads)
+- OpenRoads Designer — 12 % (4 ads)
+- Revit — 12 % (4 ads)
+
+**Seniority:** mid 53 % · senior 32 % · junior 12 % · lead 3 %
+
+### UK (gb)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### EU/DACH (de, at, ch, nl)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+
+## Job title variants in the market
+
+| Title | Ads |
+|---|---|
+| Senior Water Resources Engineer | 3 |
+| Water Resources Engineer | 3 |
+| Senior Water Technology and Reuse Engineer | 2 |
+| Water Treatment Process Engineer | 2 |
+| Water/Wastewater Treatment Engineer | 2 |
+| Civil Engineer - Water / Wastewater Engineering | 1 |
+| Civil Engineer - Water Resources | 1 |
+| Early Professional, Water Resources Engineering | 1 |
+| Entry Level Water Resources Engineer - May 2026 | 1 |
+| Lead Due Diligence Engineer Water | 1 |
+| Lead Water Resources Engineer | 1 |
+| Mid-Level Coastal / Water Resources Engineer | 1 |
+| Professional Engineer - Water Resources | 1 |
+| Senior Engineer, Water | 1 |
+| Senior Integrated Water Resource Planner / Engineer | 1 |
+| Senior Project Engineer, Water Resources | 1 |
+| Senior Water Infrastructure Engineer | 1 |
+| Senior Water Resources Engineer - Urban Stormwater | 1 |
+| Sr. Water Resources Engineer - Water Business | 1 |
+| Water and PFAS Senior Engineer | 1 |
+| Water Resources Engineer - CAD Design & Hydraulics | 1 |
+| Water Resources Engineer - Entry Level | 1 |
+| Water Resources Engineer – Floodplain & Dam Safety | 1 |
+| Water Resources Engineer - Resiliency & Modeling | 1 |
+| Water/Wastewater Civil Engineer - Lead Projects & Growth | 1 |
+
+Methodology: entities extracted per ad ({hard_skills, tools, methods, responsibilities, seniority}), normalized, counted as DISTINCT ads per entity; report threshold ≥ 3 ads. Headline sections in skills.md/tools.md use the stricter ≥ 20 % threshold.
--- a/references/profile.md
+++ b/references/profile.md
@@ -0,0 +1,21 @@
+# Occupation profile — water engineer
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/fcf9024e-277c-43c7-8ec8-8903e5c9c576
+- **ESCO code:** 2142.1.11
+- **ISCO-08 group:** 2142 — Civil engineers
+- **O*NET-SOC:** 11-9121.02 — Water Resource Specialists (match: closeMatch)
+
+## Description (ESCO)
+
+Water engineers research and develop methods for the provision of clean water, water treatment and flood damage prevention and reaction. They research water needs in a location and develop methods for meeting those needs, such as designing and developing projects for managing water resources such as treatment plants, pipelines, pump systems, irrigation or draining systems and other water supply systems. Water engineers also ensure proper installation of these systems on construction sites. Water engineers also maintain, repair and build structures that control water resources, such as bridges, canals and dams.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- water resource engineer
+- hydraulic engineer
+- water systems engineer
+- water management specialist
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,104 @@
+# Competences — water engineer
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/fcf9024e-277c-43c7-8ec8-8903e5c9c576).
+
+## Essential
+
+- **adjust engineering designs** (skill/competence)
+- **advise on irrigation projects** (skill/competence)
+- **analyse community needs** (skill/competence)
+- **approve engineering design** (skill/competence)
+- **conserve water resource** (skill/competence)
+- **create designs for pipeline engineering** (skill/competence)
+- **detect flaws in pipeline infrastructure** (skill/competence)
+- **develop flood remediation strategies** (skill/competence)
+- **engineering principles** (knowledge)
+- **engineering processes** (knowledge)
+- **ensure compliance with environmental legislation** (skill/competence)
+- **ensure compliance with safety legislation** (skill/competence)
+- **flood remediation equipment** (knowledge)
+- **hydraulic fluid** (knowledge)
+- **hydraulics** (knowledge)
+- **interpret scientific data to assess water quality** (skill/competence)
+- **landscape design** (knowledge)
+- **lead a team in water management** (skill/competence)
+- **perform scientific research** (skill/competence)
+- **technical drawings** (knowledge)
+- **types of pipelines** (knowledge)
+- **use technical drawing software** (skill/competence)
+- **water policies** (knowledge)
+- **water reuse** (knowledge)
+
+## Optional
+
+- advise on environmental remediation (skill/competence)
+- advise on pollution prevention (skill/competence)
+- advise on soil and water protection (skill/competence)
+- analyse route possibilities in pipeline projects (skill/competence)
+- compute irrigation pressure (skill/competence)
+- conserve natural resources (skill/competence)
+- consider the impact of material characteristics on pipeline flows (skill/competence)
+- design dams (skill/competence)
+- design drainage well systems (skill/competence)
+- design piers (skill/competence)
+- design sprinkler systems (skill/competence)
+- design weirs (skill/competence)
+- develop environmental remediation strategies (skill/competence)
+- develop irrigation strategies (skill/competence)
+- develop sewerage networks (skill/competence)
+- develop water purification methods (skill/competence)
+- develop water supply schedule (skill/competence)
+- ecosystems (knowledge)
+- ensure equipment maintenance (skill/competence)
+- ensure regulatory compliance in pipeline infrastructures (skill/competence)
+- environmental engineering (knowledge)
+- follow up pipeline integrity management priorities (skill/competence)
+- identify risk of flooding (skill/competence)
+- inspect pipelines (skill/competence)
+- install irrigation systems (skill/competence)
+- irrigation systems (knowledge)
+- livestock (knowledge)
+- maintain irrigation controllers (skill/competence)
+- manage desalination control system (skill/competence)
+- manage water quality testing (skill/competence)
+- measure water quality parameters (skill/competence)
+- mitigate environmental impact of pipeline projects (skill/competence)
+- monitor legislation developments (skill/competence)
+- monitor water quality (skill/competence)
+- perform follow-up on pipeline route services (skill/competence)
+- perform pipeline routing studies (skill/competence)
+- perform water chemistry analysis (skill/competence)
+- perform water testing procedures (skill/competence)
+- perform water treatment procedures (skill/competence)
+- pollution prevention (knowledge)
+- prepare timelines for pipeline development projects (skill/competence)
+- supervise sewerage systems construction (skill/competence)
+- supervise waste disposal (skill/competence)
+- supervise waste water treatments (skill/competence)
+- survey sites for pipeline installation (skill/competence)
+- train employees (skill/competence)
+- use water disinfection equipment (skill/competence)
+- water chemistry analysis (knowledge)
+- watershed development (knowledge)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 34 ads, as of 2026-07-20)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- hydraulic modeling — **38 %**
+- hydrologic modeling — **26 %**
+- cost estimation — **21 %**
+- regulatory compliance — **21 %**
+- stormwater management — **18 %**
+- data analysis — **18 %**
+
+### Responsibilities
+
+- report preparation — **24 %**
+- project planning — **18 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,50 @@
+# Tasks & work activities — water engineer
+
+Source: O*NET 30.3, occupation 11-9121.02 (Water Resource Specialists).
+
+## Task statements
+
+- **[Core]** Supervise teams of workers who capture water from wells and rivers.
+- **[Core]** Review or evaluate designs for water detention facilities, storm drains, flood control facilities, or other hydraulic structures.
+- **[Core]** Negotiate for water rights with communities or water facilities to meet water supply demands.
+- **[Core]** Perform hydrologic, hydraulic, or water quality modeling.
+- **[Core]** Compile water resource data, using geographic information systems (GIS) or global position systems (GPS) software.
+- **[Core]** Compile and maintain documentation on the health of a body of water.
+- **[Core]** Write proposals, project reports, informational brochures, or other documents on wastewater purification, water supply and demand, or other water resource subjects.
+- **[Core]** Recommend new or revised policies, procedures, or regulations to support water resource or conservation goals.
+- **[Core]** Provide technical expertise to assist communities in the development or implementation of storm water monitoring or other water programs.
+- **[Core]** Present water resource proposals to government, public interest groups, or community groups.
+- **[Core]** Monitor water use, demand, or quality in a particular geographic area.
+- **[Core]** Identify and characterize specific causes or sources of water pollution.
+- **[Core]** Develop plans to protect watershed health or rehabilitate watersheds.
+- **[Core]** Develop or implement standardized water monitoring and assessment methods.
+- **[Core]** Conduct technical studies for water resources on topics such as pollutants and water treatment options.
+- **[Core]** Conduct, or oversee the conduct of, investigations on matters such as water storage, wastewater discharge, pollutants, permits, or other compliance and regulatory issues.
+- **[Core]** Conduct cost-benefit studies for watershed improvement projects or water management alternatives.
+- **[Core]** Analyze storm water systems to identify opportunities for water resource improvements.
+- **[Core]** Develop strategies for watershed operations to meet water supply and conservation goals or to ensure regulatory compliance with clean water laws or regulations.
+- **[Core]** Conduct, or oversee the conduct of, chemical, physical, and biological water quality monitoring or sampling to ensure compliance with water quality standards.
+- **[Supplemental]** Identify methods for distributing purified wastewater into rivers, streams, or oceans.
+
+## Detailed work activities
+
+- Advise others on green energy or related technologies.
+- Analyze data to determine project feasibility.
+- Compile operational data.
+- Develop environmental remediation or protection plans.
+- Develop procedures to evaluate organizational activities.
+- Develop sustainable organizational policies or practices.
+- Evaluate environmental or sustainability projects.
+- Evaluate green operations or programs for compliance with standards or regulations.
+- Evaluate quality of materials or products.
+- Identify environmental concerns.
+- Identify opportunities for green initiatives.
+- Implement organizational process or policy changes.
+- Maintain operational records.
+- Monitor organizational compliance with regulations.
+- Monitor resources.
+- Negotiate contracts for environmental remediation, green energy, or renewable resources.
+- Prepare proposals or grant applications to obtain project funding.
+- Present sustainable products or services information to the public.
+- Supervise workers performing environmentally sustainable activities.
+- Test green technologies or processes.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,58 @@
+# Tools & technology — water engineer
+
+Source: O*NET 30.3 'Software Skills' for 11-9121.02.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| Autodesk AutoCAD | Computer aided design CAD software | yes |
+| Structured query language SQL | Data base user interface and query software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| ESRI ArcGIS software | Geographic information system | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Microsoft Word | Word processing software | yes |
+| DHI MIKE URBAN | Analytical or scientific software |  |
+| FishXing | Analytical or scientific software |  |
+| HEC-HMS | Analytical or scientific software |  |
+| HEC-RAS | Analytical or scientific software |  |
+| Laboratory information management system LIMS | Analytical or scientific software |  |
+| MWH Soft H2ONET MSX | Analytical or scientific software |  |
+| MWH Soft InfoSWMM | Analytical or scientific software |  |
+| TIBCO Spotfire S+ | Analytical or scientific software |  |
+| Wallingford Software InfoSewer | Analytical or scientific software |  |
+| Wallingford Software InfoWater | Analytical or scientific software |  |
+| Wallingford Software InfoWorks CS | Analytical or scientific software |  |
+| Wallingford Software InfoWorks WS | Analytical or scientific software |  |
+| Water flow modeling software | Analytical or scientific software |  |
+| Database software | Data base user interface and query software |  |
+| RIVERMorph | Data base user interface and query software |  |
+| ESRI ArcGIS Spatial Analyst | Geographic information system |  |
+| ESRI ArcInfo | Geographic information system |  |
+| ESRI ArcPad | Geographic information system |  |
+| ESRI ArcView | Geographic information system |  |
+| ESRI ArcView 3D Analyst | Geographic information system |  |
+| Geographic information system GIS software | Geographic information system |  |
+| Geographic information system GIS systems | Geographic information system |  |
+| Google Earth Pro | Geographic information system |  |
+| Web browser software | Internet browser software |  |
+| Mapping software | Map creation software |  |
+| Global positioning system GPS software | Mobile location based services software |  |
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 34 ads, as of 2026-07-20)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Tools
+
+- HEC-RAS — **38 %**
+- AutoCAD — **29 %**
+- HEC-HMS — **21 %**
+- SWMM — **21 %**
+- AutoCAD Civil 3D — **18 %**
+- ArcGIS — **18 %**
+- MicroStation — **18 %**
+
+<!-- market-evidence -->