feat: energy-analyst skill package v0.1.0

2026-08-14 17:49:59 +02:00
commit a0e6066739
9 changed files with 896 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — energy-analyst
+
+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 — energy-analyst
+    "ESCO (occupation & competences)" : 32
+    "O*NET (tasks & tools)" : 82
+    "Job boards (market evidence)" : 78
+    "Anthropic official Claude skills" : 6
+    "External AI skill packs (mapped)" : 143
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 32 | 9.4 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 82 | 24.0 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 78 | 22.9 % | 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 | 6 | 1.8 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 143 | 41.9 % | 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,61 @@
+---
+name: energy-analyst
+description: "Occupational skill for the role 'energy analyst' (also: energy and sustainability analyst, energy advisor, energy regulation specialist, energy procurement analyst, energy efficiency analyst, senior energy analyst). Use when the user asks for typical energy analyst work such as: Perform energy modeling, measurement, verification, commissioning, or retro-commissioning.; Inspect or monitor energy systems, including heating, ventilating, and air conditioning (HVAC) or daylighting systems to determine energy use or potential energy savings.; Manage the development, design, or construction of energy conservation projects to ensure acceptability of budgets and time lines, conformance to federal and state laws, or adherence to approved specifications."
+---
+
+# Energy Analyst
+
+Energy analysts evaluate the consumption of energy in buidings owned by consumers and businesses. By analysing existing energy systems, they recommend cost-effective alternatives. Energy analysts suggest efficiency improvements, make business analyses and participate in the development of policies concerning the use of traditional fuels, transportation, and other factors relating to energy consumption.
+
+## Core workflow
+
+1. Perform energy modeling, measurement, verification, commissioning, or retro-commissioning.
+2. Inspect or monitor energy systems, including heating, ventilating, and air conditioning (HVAC) or daylighting systems to determine energy use or potential energy savings.
+3. Manage the development, design, or construction of energy conservation projects to ensure acceptability of budgets and time lines, conformance to federal and state laws, or adherence to approved specifications.
+4. Monitor and analyze energy consumption.
+5. Promote awareness or use of alternative or renewable energy sources.
+6. Analyze, interpret, or create graphical representations of energy data, using engineering software.
+7. Review or negotiate energy purchase agreements.
+8. Train personnel or clients on topics such as energy management.
+
+## 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)
+
+- advise on carbon emissions reduction
+- advise on heating systems energy efficiency
+- alternative energy
+- analyse energy consumption
+- analyse energy market trends
+- carry out energy management of facilities
+- collaborate on international energy projects
+- conduct energy audit
+- develop energy policy
+- develop energy saving concepts
+- energy
+- energy conservation
+- energy efficiency
+- energy market
+- energy performance of buildings
+
+## Hot technologies
+
+- The MathWorks MATLAB
+- Autodesk AutoCAD
+- Microsoft Access
+- Microsoft Outlook
+- C++
+- Python
+- R
+- Microsoft Office software
+- Microsoft PowerPoint
+- Microsoft Visio
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/cbde1a3a-406d-4d17-b30b-03981925035d), O*NET 30.3 (17-2199.03). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,208 @@
+{
+  "name": "energy-analyst",
+  "title": "energy analyst",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/cbde1a3a-406d-4d17-b30b-03981925035d",
+    "esco_code": "3112.5",
+    "isco_group": "3112",
+    "onet_soc": "17-2199.03",
+    "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": 15,
+    "skills_essential": 27,
+    "skills_optional": 4,
+    "software": 45
+  },
+  "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": 3
+      },
+      "NVIDIA/skills": {
+        "repo": "https://github.com/NVIDIA/skills",
+        "commit": "153b14b",
+        "license": "CC-BY-4.0 (skills/docs), Apache-2.0 (code)",
+        "skills": 12
+      },
+      "google/skills": {
+        "repo": "https://github.com/google/skills",
+        "commit": "b15f327",
+        "license": "Apache-2.0",
+        "skills": 12
+      },
+      "phuryn/pm-skills": {
+        "repo": "https://github.com/phuryn/pm-skills",
+        "commit": "18468a9",
+        "license": "MIT",
+        "skills": 9
+      },
+      "silverstein/minutes": {
+        "repo": "https://github.com/silverstein/minutes",
+        "commit": "3fb2e83",
+        "license": "MIT",
+        "skills": 1
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 6
+      },
+      "alirezarezvani/claude-skills": {
+        "repo": "https://github.com/alirezarezvani/claude-skills",
+        "commit": "0241f43",
+        "license": "MIT",
+        "skills": 5
+      },
+      "HeshamFS/materials-simulation-skills": {
+        "repo": "https://github.com/HeshamFS/materials-simulation-skills",
+        "commit": "fa1ce8d",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "mohitagw15856/pm-claude-skills": {
+        "repo": "https://github.com/mohitagw15856/pm-claude-skills",
+        "commit": "876fa30",
+        "license": "MIT",
+        "skills": 3
+      },
+      "ognjengt/founder-skills": {
+        "repo": "https://github.com/ognjengt/founder-skills",
+        "commit": "a45931c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "sanjay3290/ai-skills": {
+        "repo": "https://github.com/sanjay3290/ai-skills",
+        "commit": "3619692",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 6
+      },
+      "zebbern/claude-code-guide": {
+        "repo": "https://github.com/zebbern/claude-code-guide",
+        "commit": "d2c5280",
+        "license": "MIT",
+        "skills": 2
+      },
+      "mukul975/Anthropic-Cybersecurity-Skills": {
+        "repo": "https://github.com/mukul975/Anthropic-Cybersecurity-Skills",
+        "commit": "673da1f",
+        "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": 5
+      },
+      "affaan-m/everything-claude-code": {
+        "repo": "https://github.com/affaan-m/everything-claude-code",
+        "commit": "ed38744",
+        "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": 5
+      },
+      "huangjia2019/claude-code-engineering": {
+        "repo": "https://github.com/huangjia2019/claude-code-engineering",
+        "commit": "5ed066a",
+        "license": "no explicit license \u2014 referenced by link only",
+        "skills": 1
+      },
+      "FlorianBruniaux/claude-code-ultimate-guide": {
+        "repo": "https://github.com/FlorianBruniaux/claude-code-ultimate-guide",
+        "commit": "5395214",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "pedrohcgs/claude-code-my-workflow": {
+        "repo": "https://github.com/pedrohcgs/claude-code-my-workflow",
+        "commit": "be53c12",
+        "license": "MIT",
+        "skills": 1
+      },
+      "indranilbanerjee/digital-marketing-pro": {
+        "repo": "https://github.com/indranilbanerjee/digital-marketing-pro",
+        "commit": "a3d119c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "jeffallan/claude-skills": {
+        "repo": "https://github.com/jeffallan/claude-skills",
+        "commit": "e8be415",
+        "license": "MIT",
+        "skills": 1
+      },
+      "nexscope-ai/eCommerce-Skills": {
+        "repo": "https://github.com/nexscope-ai/eCommerce-Skills",
+        "commit": "56f3288",
+        "license": "MIT",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 51,
+      "adjacent": 29
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 32,
+      "onet": 82,
+      "jobads": 78,
+      "wiki_ai": 0,
+      "anthropic": 6,
+      "ai_skills": 143,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 9.4,
+      "onet": 24.0,
+      "jobads": 22.9,
+      "wiki_ai": 0.0,
+      "anthropic": 1.8,
+      "ai_skills": 41.9,
+      "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,282 @@
+# External AI agent skills — energy-analyst
+
+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` | core | 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) |
+| `xlsx` | adjacent | Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, … | [source](https://github.com/anthropics/skills/tree/main/skills/xlsx) |
+
+## 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 |
+|---|---|---|---|
+| `root-data-analyzer` | core | ROOT/CERN data analysis skill for high-energy physics data processing, histogramming, and statistical analysis | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/physics/skills/root-data-analyzer) |
+| `learning-needs-analysis` | core | Conduct comprehensive learner audience analysis, identify performance gaps, and determine instructional requirements using surveys, interviews, and data analysis | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/social-sciences-humanities/education/skills/learning-needs-analysis) |
+| `evidently-drift-detector` | core | Evidently AI skill for data drift detection, model performance monitoring, target drift analysis, and automated reporting for ML systems in production. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/data-science-ml/skills/evidently-drift-detector) |
+| `code-quality-analyzer` | core | Static code analysis, technical debt assessment, engineering velocity metrics | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/business/venture-capital/skills/code-quality-analyzer) |
+| `deseq2-differential-expression` | core | DESeq2 differential expression analysis skill with normalization, statistical modeling, and visualization | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/bioinformatics/skills/deseq2-differential-expression) |
+| `psychometric-assessment` | core | Develop, validate, and adapt measurement instruments including factor analysis, reliability testing, and cross-cultural validation | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/social-sciences-humanities/social-sciences/skills/psychometric-assessment) |
+
+## 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 |
+|---|---|---|---|
+| `prediction-market-oracle-research` | core | Research prediction markets as data sources or oracle signals for products, agents, dashboards, and corporate decision intelligence. Use for source-grounded analysis of market-implied probabilities, caveats, and integration patterns … | [source](https://github.com/affaan-m/everything-claude-code/tree/ed38744/skills/prediction-market-oracle-research) |
+
+## Source: alirezarezvani/claude-skills
+
+- Repository: [https://github.com/alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) (commit `0241f43`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `founder-coach` | core | Personal leadership development for founders and first-time CEOs. Covers founder archetype identification, delegation frameworks, energy management, CEO calendar audits, leadership style evolution, blind spot identification, imposter … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/c-level-advisor/skills/founder-coach) |
+| `senior-pm` | core | Senior Project Manager for enterprise software, SaaS, and digital transformation projects. Specializes in portfolio management, quantitative risk analysis, resource optimization, stakeholder alignment, and executive reporting. Uses … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/project-management/skills/senior-pm) |
+| `pm-skills` | core | Use when coordinating project-delivery work across the 8 project-management sub-skills — sprint/velocity analytics, portfolio health, Jira/JQL, Confluence, Atlassian admin, templates, meeting analysis, team comms. Triggers on 'our sprints … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/project-management/skills/pm-skills) |
+| `capa-officer` | core | CAPA system management for medical device QMS. Covers root cause analysis, corrective action planning, effectiveness verification, and CAPA metrics. Use when running CAPA investigations, 5-Why analysis, fishbone diagrams, root cause … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/ra-qm-team/skills/capa-officer) |
+| `financial-analyst` | core | Performs financial ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction for strategic decision-making. Use when analyzing financial statements, building valuation models, assessing budget variances, or … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/finance/skills/financial-analyst) |
+
+## 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 |
+|---|---|---|---|
+| `climate-science-guide` | core | Climate data analysis, modeling workflows, and carbon neutrality research met... | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/geoscience/climate-science-guide) |
+| `econometrics-r` | core | R-based econometric analysis for academic research. Use when writing R code for panel data, difference-in-differences, instrumental variables, spatial econometrics, or regression analysis. Covers data.table, fixest, sf, modelsummary, and … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/14-luischanci-claude-code-research-starter/dot-claude/skills/econometrics-r) |
+| `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) |
+| `linear-algebra-applications` | core | Apply linear algebra concepts to research computing and data analysis | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/math/linear-algebra-applications) |
+| `python-econ-computing` | core | Use when writing Python code for DSGE models, HANK models, numerical economic computation, causal inference, or quantitative economic data analysis | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/20-wenddymacro-python-econ-skill) |
+
+## 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 |
+|---|---|---|---|
+| `postgresql-optimization` | core | PostgreSQL database optimization workflow for query tuning, indexing strategies, performance analysis, and production database management. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/database/postgresql-optimization) |
+| `google-analytics` | core | Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements. Use when the user asks about analytics, website metrics, traffic analysis, conversion rates, user behavior, … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/analytics/google-analytics) |
+| `senior-fullstack` | core | Comprehensive fullstack development skill for building complete web applications with React, Next.js, Node.js, GraphQL, and PostgreSQL. Includes project scaffolding, code quality analysis, architecture patterns, and complete tech stack … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/development/senior-fullstack) |
+| `data-scientist` | core | Expert data scientist for advanced analytics, machine learning, and statistical modeling. Handles complex data analysis, predictive modeling, and business intelligence. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/data-scientist) |
+| `polars` | core | Fast DataFrame library (Apache Arrow). Select, filter, group_by, joins, lazy evaluation, CSV/Parquet I/O, expression API, for high-performance data analysis workflows. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/polars) |
+| `scvi-tools` | core | This skill should be used when working with single-cell omics data analysis using scvi-tools, including scRNA-seq, scATAC-seq, CITE-seq, spatial transcriptomics, and other single-cell modalities. Use this skill for probabilistic modeling, … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/scvi-tools) |
+
+## Source: FlorianBruniaux/claude-code-ultimate-guide
+
+- Repository: [https://github.com/FlorianBruniaux/claude-code-ultimate-guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide) (commit `5395214`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `plan-pipeline-start` | core | 5-phase planning: PRD analysis, design review, technical decisions, dynamic research team, metrics. Produces a complete implementation plan + ADRs before any code is written. | [source](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/5395214/examples/skills/plan-pipeline/start) |
+
+## 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 |
+|---|---|---|---|
+| `simulation-failure-triage` | core | First-response triage for cross-code (LAMMPS/VASP/QE/MOOSE) simulation failures: classifies the failure signature (nonconvergence, NaN/Inf, exploding energy, unstable timestep, pressure blow-up, missing potentials/pseudopotentials, memory … | [source](https://github.com/HeshamFS/materials-simulation-skills/tree/fa1ce8d/skills/robustness/simulation-failure-triage) |
+
+## Source: huangjia2019/claude-code-engineering
+
+- Repository: [https://github.com/huangjia2019/claude-code-engineering](https://github.com/huangjia2019/claude-code-engineering) (commit `5ed066a`, retrieved 2026-07-14)
+- License: no explicit license — referenced by link only
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `financial-analyzing` | core | Analyze financial data, calculate financial ratios, and generate analysis reports. Use when the user asks about revenue, costs, profits, margins, ROI, financial metrics, or needs financial analysis of a company or project. | [source](https://github.com/huangjia2019/claude-code-engineering/tree/5ed066a/04-Skills/projects/03-financial-skill) |
+
+## Source: indranilbanerjee/digital-marketing-pro
+
+- Repository: [https://github.com/indranilbanerjee/digital-marketing-pro](https://github.com/indranilbanerjee/digital-marketing-pro) (commit `a3d119c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `performance-report` | core | Generate performance reports. Use when: tracking KPIs, trend analysis, anomaly detection, and actionable recommendations. | [source](https://github.com/indranilbanerjee/digital-marketing-pro/tree/a3d119c/skills/performance-report) |
+
+## Source: jeffallan/claude-skills
+
+- Repository: [https://github.com/jeffallan/claude-skills](https://github.com/jeffallan/claude-skills) (commit `e8be415`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `postgres-pro` | core | Use when optimizing PostgreSQL queries, configuring replication, or implementing advanced database features. Invoke for EXPLAIN analysis, JSONB operations, extension usage, VACUUM tuning, performance monitoring. | [source](https://github.com/jeffallan/claude-skills/tree/e8be415/skills/postgres-pro) |
+
+## 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 |
+|---|---|---|---|
+| `profiling-application-performance` | core | Execute this skill enables AI assistant to profile application performance, analyzing cpu usage, memory consumption, and execution time. it is triggered when the user requests performance analysis, bottleneck identification, or … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/performance/application-profiler/skills/profiling-application-performance) |
+| `touch-audit` | core | Mobile audit — app size, startup time, crash reporting, store compliance, accessibility, offline behavior. Use when asked for "mobile review", "app store readiness", "mobile performance", or "crash analysis". | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-agency/tonone/skills/touch-audit) |
+| `analyzing-on-chain-data` | core | Process perform on-chain analysis including whale tracking, token flows, and network activity. Use when performing crypto analysis. Trigger with phrases like "analyze crypto", "check blockchain", or "monitor market".  | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/crypto/on-chain-analytics/skills/analyzing-on-chain-data) |
+| `evaluating-machine-learning-models` | core | Build this skill allows AI assistant to evaluate machine learning models using a comprehensive suite of metrics. it should be used when the user requests model performance analysis, validation, or testing. AI assistant can use this skill … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-ml/model-evaluation-suite/skills/evaluating-machine-learning-models) |
+| `optimizing-sql-queries` | core | Execute use when you need to work with query optimization. This skill provides query performance analysis with comprehensive guidance and automation. Trigger with phrases like "optimize queries", "analyze performance", or "improve query … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/database/sql-query-optimizer/skills/optimizing-sql-queries) |
+
+## 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 |
+|---|---|---|---|
+| `product-health-analysis` | core | Interpret product metrics against goals and surface actionable signals. Use when asked to analyse product health, review key metrics, investigate a performance issue, produce a health report, or assess product-market fit signals. Produces … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-analytics/skills/product-health-analysis) |
+| `retention-analysis` | core | Structure a retention analysis, churn investigation, or engagement deep-dive for any product team. Use when asked to analyse user retention, investigate churn, measure DAU/MAU, or build a retention improvement plan. Produces a retention … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-analytics/skills/retention-analysis) |
+| `retro-analysis` | core | Analyses sprint delivery data and produces a structured retrospective brief. Use when asked to run a retrospective, analyse sprint data, prepare a retro brief, or turn sprint metrics into discussion prompts. Produces a data-grounded … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-delivery/skills/retro-analysis) |
+
+## 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 |
+|---|---|---|---|
+| `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: nexscope-ai/eCommerce-Skills
+
+- Repository: [https://github.com/nexscope-ai/eCommerce-Skills](https://github.com/nexscope-ai/eCommerce-Skills) (commit `56f3288`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `sales-tracking-tool` | core | Track and analyze e-commerce sales performance across platforms. Set up KPI dashboards, trend analysis, and performance alerts to catch issues and opportunities early. | [source](https://github.com/nexscope-ai/eCommerce-Skills/tree/56f3288/sales-tracking-tool) |
+
+## Source: ognjengt/founder-skills
+
+- Repository: [https://github.com/ognjengt/founder-skills](https://github.com/ognjengt/founder-skills) (commit `a45931c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `competitor-intel` | core | Analyzes competitors using web research to provide verified business metrics, actionable leverage strategies, and predicted next moves. Use when user needs competitive intelligence, competitor analysis, market positioning insights, or … | [source](https://github.com/ognjengt/founder-skills/tree/a45931c/skills/competitor-intel) |
+
+## Source: pedrohcgs/claude-code-my-workflow
+
+- Repository: [https://github.com/pedrohcgs/claude-code-my-workflow](https://github.com/pedrohcgs/claude-code-my-workflow) (commit `be53c12`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `coauthor-brief` | core | Generate a co-author / collaborator handoff brief for a multi-author, multi-machine project — summarizing what changed since the last brief (git delta), the current state of each artifact (manuscript, analysis, slides), open questions, how … | [source](https://github.com/pedrohcgs/claude-code-my-workflow/tree/be53c12/.claude/skills/coauthor-brief) |
+
+## 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: silverstein/minutes
+
+- Repository: [https://github.com/silverstein/minutes](https://github.com/silverstein/minutes) (commit `3fb2e83`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `minutes-mirror` | core | Self-coaching analysis of your own behavior across meetings — talk-time ratio, filler words, hedging language, monologue length, energy patterns, and (when meetings are tagged via /minutes-tag) what your behavior in winning meetings looks … | [source](https://github.com/silverstein/minutes/tree/3fb2e83/.agents/skills/minutes/minutes-mirror) |
+
+## Source: zebbern/claude-code-guide
+
+- Repository: [https://github.com/zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide) (commit `d2c5280`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `vc-industry-research` | core | Generate professional primary market / venture capital industry research reports, including sector deep-dives, investment memos, and market analysis. Produces detailed PDF reports covering TMT, consumer, healthcare, and industrials. … | [source](https://github.com/zebbern/claude-code-guide/tree/d2c5280/skills/vc-industry-research) |
+| `regression-modeler` | core | Run regression analysis (OLS or logistic) on uploaded CSV/Excel data, generating coefficients, R², p-values, VIF, and plain-language interpretation. Triggered by requests for regression modeling, fitting data, testing significance, … | [source](https://github.com/zebbern/claude-code-guide/tree/d2c5280/skills/regression-modeler) |
+
+## Source: google/skills
+
+- Repository: [https://github.com/google/skills](https://github.com/google/skills) (commit `b15f327`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `bigquery-basics` | core | Manages datasets, tables, and jobs in BigQuery. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resources (datasets, tables, views), or perform basic data ingestion and analysis. | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigquery-basics) |
+| `datalineage-bigquery-asset-impact-analysis` | core | Analyzes the downstream impact (blast radius) when a BigQuery table or view is broken, stale, or modified. Identifies all downstream tables, dashboards, and processes that will be affected. Use when: - Performing a blast radius or impact … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/datalineage-bigquery-asset-impact-analysis) |
+| `agent-platform-alert-configuration` | adjacent | Configures best-practice alerting policies for Google Cloud Vertex AI / Agent Platform agents on Agent Runtime. Use when analyzing, writing, or deploying alerting policies to monitor agent latency, error rates, and quality metrics … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/agent-platform-alert-configuration) |
+| `agent-platform-eval-flywheel` | adjacent | Measures and improves the quality of AI models and agents on Google Cloud using the Eval Quality Flywheel methodology. Use when evaluating an agent or model, building an eval dataset, picking or writing evaluation metrics, analyzing … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/agent-platform-eval-flywheel) |
+| `google-cloud-networking-observability` | adjacent | Investigates Google Cloud networking issues by analyzing logs, metrics, and diagnostics. Use when investigating VPC Flow Logs (including cost estimation), NAT, firewall, or threat logs, querying latency and throughput metrics, or running … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/google-cloud-networking-observability) |
+| `alloydb-basics` | adjacent | Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB model context protocol (MCP) tools for automated database operations. | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/alloydb-basics) |
+| `bigquery-ai-ml` | adjacent | Leverages BigQuery's built-in machine learning and GenAI capabilities for advanced data analytics. Use when you need to write SQL queries that perform time-series forecasting, detect outliers, find key drivers, or leverage generative AI … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigquery-ai-ml) |
+| `bigtable-basics` | adjacent | Assists in provisioning instances/tables, designing performant schemas, and querying data in Bigtable. Use when designing Bigtable row keys, configuring column families, writing SQL queries or client library code (Java, Go, Python) for … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigtable-basics) |
+| `cloud-sql-basics` | adjacent | This file generates or explains Cloud SQL resources. Use this file when the user asks to create a Cloud SQL instance or database for MySQL, PostgreSQL, or SQL Server. Cloud SQL manages third-party MySQL, PostgreSQL, and SQL Server … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/cloud-sql-basics) |
+| `gke-observability` | adjacent | Configures GKE observability, including Cloud Logging, Cloud Monitoring, and managed Prometheus. Use when configuring GKE monitoring, setting up GKE logging, or configuring Prometheus metrics collection. Don't use to configure local … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/gke-observability) |
+| `google-analytics-admin-api-basics` | adjacent | Manages Google Analytics account and property settings, enables the Analytics Admin API via the Cloud CLI, lists accounts and properties, and manages data streams, custom dimensions, conversion events, and integrations. Use when you need … | [source](https://github.com/google/skills/tree/b15f327/skills/analytics/google-analytics-admin-api-basics) |
+| `google-analytics-data-api-basics` | adjacent | Manages Google Analytics reporting data, enables the Analytics Data API via the Cloud CLI, and creates reports using the Google Analytics Data API (v1beta). Use when you need to interact with Google Analytics properties, run customized … | [source](https://github.com/google/skills/tree/b15f327/skills/analytics/google-analytics-data-api-basics) |
+
+## Source: NVIDIA/skills
+
+- Repository: [https://github.com/NVIDIA/skills](https://github.com/NVIDIA/skills) (commit `153b14b`, retrieved 2026-07-14)
+- License: CC-BY-4.0 (skills/docs), Apache-2.0 (code)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `vss-generate-video-report` | core | Use this skill when producing a VSS analysis report — Mode A per-clip VLM, Mode B incident-range via video-analytics. Not for standalone video summarization, real-time alerts or ad-hoc Q&A. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-generate-video-report) |
+| `deepstream-dev` | adjacent | NVIDIA DeepStream SDK 9.0 development with Python pyservicemaker API. Use when building video analytics pipelines, GStreamer-based video processing, TensorRT inference integration, object detection/tracking, or Kafka/message broker … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/deepstream-dev) |
+| `tao-train-depth-anything-v2` | adjacent | Monocular depth estimation using Metric Depth Anything v2 or Relative Depth Anything architectures. Predicts per-pixel depth from single RGB images. Use when training, evaluating, exporting, or running inference for a TAO monocular depth … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-depth-anything-v2) |
+| `vss-setup-behavior-analytics` | adjacent | Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-setup-behavior-analytics) |
+| `vss-setup-video-analytics-api` | adjacent | Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-setup-video-analytics-api) |
+| `nemo-evaluator-plugin` | adjacent | Use when working on the Evaluator plugin CLI, jobs, SDK-backed specs, metric types, or plugin-owned Evaluator skills. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/nemo-evaluator-plugin) |
+| `nv-reason-cxr` | adjacent | Used for command-shape or live NV-Reason-CXR chest X-ray reasoning smoke tests. Not for diagnosis or clinical reporting. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/nv-reason-cxr) |
+| `tao-train-metric-learning-recognition` | adjacent | Metric-learning recognition (ml-recog) for fine-grained visual recognition. Learns embeddings for retrieval-based matching (e.g., retail product recognition) using triplet / contrastive losses. Use when training, evaluating, exporting, or … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-metric-learning-recognition) |
+| `tao-train-reid` | adjacent | Person re-identification (ReID). Learns discriminative embeddings to match the same person across different camera views, based on metric learning. Use when training, evaluating, exporting, or running inference for a TAO person … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-reid) |
+| `vss-generate-video-calibration` | adjacent | Use to run AutoMagicCalib on local MP4s, RTSP, or the bundled sample dataset, and to deploy vss-auto-calibration when needed. Do not use for non-AMC calibration or runtime analytics. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-generate-video-calibration) |
+| `vss-manage-alerts` | adjacent | Use for VSS alert workflows — real-time monitoring, Alert-Bridge subscriptions, Slack notifications, incident queries, camera onboarding. Not for non-alert analytics. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-manage-alerts) |
+| `vss-query-analytics` | adjacent | Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-query-analytics) |
+
+## Source: phuryn/pm-skills
+
+- Repository: [https://github.com/phuryn/pm-skills](https://github.com/phuryn/pm-skills) (commit `18468a9`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `cohort-analysis` | core | Perform cohort analysis on user engagement data — retention curves, feature adoption trends, and segment-level insights. Use when analyzing user retention by cohort, studying feature adoption over time, investigating churn patterns, or … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/cohort-analysis) |
+| `ab-test-analysis` | core | Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/ab-test-analysis) |
+| `metrics-dashboard` | core | Define and design a product metrics dashboard with key metrics, data sources, visualization types, and alert thresholds. Use when creating a metrics dashboard, defining KPIs, setting up product analytics, or building a data monitoring plan. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-discovery/skills/metrics-dashboard) |
+| `dummy-dataset` | adjacent | Generate realistic dummy datasets for testing with customizable columns, constraints, and output formats (CSV, JSON, SQL, Python script). Use when creating test data, building mock datasets, or generating sample data for development and … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-execution/skills/dummy-dataset) |
+| `gtm-strategy` | adjacent | Create a go-to-market strategy covering marketing channels, messaging, success metrics, and launch timeline. Use when planning a product launch, creating a GTM plan from scratch, or defining a launch strategy for a new market. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-go-to-market/skills/gtm-strategy) |
+| `lean-canvas` | adjacent | Generate a Lean Canvas with problem, solution, metrics, cost structure, UVP, unfair advantage, channels, segments, and revenue. Use when exploring a lean startup canvas, testing a business hypothesis, or modeling a new venture. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-strategy/skills/lean-canvas) |
+| `north-star-metric` | adjacent | Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation. Classify the business game (Attention, Transaction, Productivity) and validate against 7 criteria for an effective North Star. Use when choosing … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-marketing-growth/skills/north-star-metric) |
+| `product-strategy` | adjacent | Create a comprehensive product strategy using the 9-section Product Strategy Canvas — vision, segments, costs, value propositions, trade-offs, metrics, growth, capabilities, and defensibility. Use when building a product strategy, creating … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-strategy/skills/product-strategy) |
+| `sql-queries` | adjacent | Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL, building data reports, exploring … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/sql-queries) |
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,63 @@
+# Market evidence report — energy-analyst
+
+Source: **4 real job ads** (JSearch API, countries: us 4), extracted into the MSSQL evidence store; as of 2026-07-11.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| mid | 3 | 75 % |
+| junior | 1 | 25 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | Microsoft Excel | 3 | 75 % |
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | data analysis | 3 | 75 % |
+| 2 | technical analysis | 3 | 75 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Regional breakdown
+
+> **Corpus note:** 4 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+**Insufficient evidence** — 4 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### 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 |
+|---|---|
+| Energy Analyst | 1 |
+| Senior Associate, Energy Systems Analyst | 1 |
+| Sustainable Energy Analyst/Project Coordinator; Arlington, VA; | 1 |
+| Sustainable Energy Analyst/Project Coordinator | 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,24 @@
+# Occupation profile — energy analyst
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/cbde1a3a-406d-4d17-b30b-03981925035d
+- **ESCO code:** 3112.5
+- **ISCO-08 group:** 3112 — Civil engineering technicians
+- **O*NET-SOC:** 17-2199.03 — Energy Engineers, Except Wind and Solar (match: closeMatch)
+
+## Description (ESCO)
+
+Energy analysts evaluate the consumption of energy in buidings owned by consumers and businesses. By analysing existing energy systems, they recommend cost-effective alternatives. Energy analysts suggest efficiency improvements, make business analyses and participate in the development of policies concerning the use of traditional fuels, transportation, and other factors relating to energy consumption.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- energy and sustainability analyst
+- energy advisor
+- energy regulation specialist
+- energy procurement analyst
+- energy efficiency analyst
+- senior energy analyst
+- energy performance analyst
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,109 @@
+# Competences — energy analyst
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/cbde1a3a-406d-4d17-b30b-03981925035d).
+
+## Essential
+
+- **advise on carbon emissions reduction** (skill/competence)
+- **advise on heating systems energy efficiency** (skill/competence)
+- **alternative energy** (knowledge)
+- **analyse energy consumption** (skill/competence)
+- **analyse energy market trends** (skill/competence)
+- **carry out energy management of facilities** (skill/competence)
+- **collaborate on international energy projects** (skill/competence)
+- **conduct energy audit** (skill/competence)
+- **develop energy policy** (skill/competence)
+- **develop energy saving concepts** (skill/competence)
+- **energy** (knowledge)
+- **energy conservation** (knowledge)
+- **energy efficiency** (knowledge)
+- **energy market** (knowledge)
+- **energy performance of buildings** (knowledge)
+- **energy sector policies** (knowledge)
+- **energy transformation** (knowledge)
+- **forecast energy prices** (skill/competence)
+- **identify energy needs** (skill/competence)
+- **inform customers on energy consumption fees** (skill/competence)
+- **prepare energy performance contracts** (skill/competence)
+- **promote sustainable energy** (skill/competence)
+- **renewable energy** (knowledge)
+- **resource-efficient technologies** (knowledge)
+- **solar energy** (knowledge)
+- **state estimation** (knowledge)
+- **zero-energy building design** (knowledge)
+
+## Optional
+
+- computer simulation (knowledge)
+- corporate sustainability (knowledge)
+- execute feasibility study on hydrogen (skill/competence)
+- provide information on hydrogen (skill/competence)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 4 ads, as of 2026-07-11)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- data analysis — **75 %**
+- technical analysis — **75 %**
+- utility bill analysis — **50 %**
+- energy modeling — **50 %**
+- energy project development — **25 %**
+- data visualization — **25 %**
+- debt analysis — **25 %**
+- economic analysis — **25 %**
+- economic benefits analysis — **25 %**
+- business development — **25 %**
+- contract management — **25 %**
+- equity analysis — **25 %**
+- financial modeling — **25 %**
+- geospatial analysis — **25 %**
+- infrastructure mapping — **25 %**
+- market research — **25 %**
+- stakeholder engagement — **25 %**
+- quantitative analysis — **25 %**
+- project development — **25 %**
+- project management — **25 %**
+- power systems engineering — **25 %**
+- research — **25 %**
+
+### Methods
+
+- Utility Energy Service Contracts (UESC) — **50 %**
+- Energy Savings Performance Contracts (ESPC) — **50 %**
+- fault tree analysis — **25 %**
+- interdependency analysis — **25 %**
+- vulnerability assessment — **25 %**
+- spatial analysis — **25 %**
+
+### Responsibilities
+
+- client communication — **50 %**
+- client coordination — **25 %**
+- communication development — **25 %**
+- data analysis — **25 %**
+- data collection and analysis — **25 %**
+- data management — **25 %**
+- data review — **25 %**
+- energy project review — **25 %**
+- junior staff mentoring — **25 %**
+- infrastructure resilience solutions identification — **25 %**
+- financial modeling — **25 %**
+- technical recommendations development — **25 %**
+- report development — **25 %**
+- report writing — **25 %**
+- securities research — **25 %**
+- research — **25 %**
+- research and analysis — **25 %**
+- industry research — **25 %**
+- project coordination — **25 %**
+- project meeting facilitation — **25 %**
+- project roadmap creation — **25 %**
+- project support — **25 %**
+- proposal creation — **25 %**
+- proposal preparation — **25 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,45 @@
+# Tasks & work activities — energy analyst
+
+Source: O*NET 30.3, occupation 17-2199.03 (Energy Engineers, Except Wind and Solar).
+
+## Task statements
+
+- **[Core]** Perform energy modeling, measurement, verification, commissioning, or retro-commissioning.
+- **[Core]** Inspect or monitor energy systems, including heating, ventilating, and air conditioning (HVAC) or daylighting systems to determine energy use or potential energy savings.
+- **[Core]** Manage the development, design, or construction of energy conservation projects to ensure acceptability of budgets and time lines, conformance to federal and state laws, or adherence to approved specifications.
+- **[Core]** Monitor and analyze energy consumption.
+- **[Core]** Promote awareness or use of alternative or renewable energy sources.
+- **[Core]** Analyze, interpret, or create graphical representations of energy data, using engineering software.
+- **[Core]** Review or negotiate energy purchase agreements.
+- **[Core]** Train personnel or clients on topics such as energy management.
+- **[Core]** Write or install energy management routines for building automation systems.
+- **[Core]** Identify and recommend energy savings strategies to achieve more energy-efficient operation.
+- **[Core]** Conduct energy audits to evaluate energy use and to identify conservation and cost reduction measures.
+- **[Core]** Monitor energy related design or construction issues, such as energy engineering, energy management, or sustainable design.
+- **[Core]** Advise clients or colleagues on topics such as climate control systems, energy modeling, data logging, sustainable design, or energy auditing.
+- **[Core]** Verify energy bills and meter readings.
+- **[Core]** Collect data for energy conservation analyses, using jobsite observation, field inspections, or sub-metering.
+- **[Core]** Review architectural, mechanical, or electrical plans or specifications to evaluate energy efficiency.
+- **[Core]** Prepare energy-related project reports or related documentation.
+- **[Core]** Direct the implementation of energy management projects.
+- **[Core]** Research renewable or alternative energy systems or technologies, such as solar thermal or photovoltaic energy.
+- **[Core]** Recommend best fuel for specific sites or circumstances.
+- **[Supplemental]** Consult with construction or renovation clients or other engineers on topics such as Leadership in Energy and Environmental Design (LEED) or Green Buildings.
+
+## Detailed work activities
+
+- Advise others regarding green practices or environmental concerns.
+- Analyze energy usage data.
+- Create models of engineering designs or methods.
+- Direct energy production or management activities.
+- Evaluate plans or specifications to determine technological or environmental implications.
+- Inspect equipment or systems.
+- Monitor industrial energy consumption or management.
+- Operate computer systems.
+- Perform marketing activities.
+- Prepare technical or operational reports.
+- Purchase materials, equipment, or other resources.
+- Recommend technical design or process changes to improve efficiency, quality, or performance.
+- Research design or application of green technologies.
+- Research energy production, use, or conservation.
+- Train personnel on proper operational procedures.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,73 @@
+# Tools & technology — energy analyst
+
+Source: O*NET 30.3 'Software Skills' for 17-2199.03.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| The MathWorks MATLAB | Analytical or scientific software | yes |
+| Autodesk AutoCAD | Computer aided design CAD software | yes |
+| Microsoft Access | Data base user interface and query software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| C++ | Object or component oriented development software | yes |
+| Python | Object or component oriented development software | yes |
+| R | Object or component oriented development software | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Visio | Process mapping and design software | yes |
+| Microsoft Project | Project management software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Microsoft Word | Word processing software | yes |
+| 360 Analytics eQUEST | Analytical or scientific software |  |
+| AIRMaster+ | Analytical or scientific software |  |
+| Architectural Energy Corporation ENFORMA Building Diagnostics | Analytical or scientific software |  |
+| Architectural Energy Corporation VisualDOE | Analytical or scientific software |  |
+| Autodesk Ecotect | Analytical or scientific software |  |
+| Carrier Hourly Analysis Program HAP | Analytical or scientific software |  |
+| Chilled Water System Analysis Tool CWSAT | Analytical or scientific software |  |
+| Combined Heat and Power Application Tool CHP | Analytical or scientific software |  |
+| Cool Roof Calculator | Analytical or scientific software |  |
+| DesignBuilder Software DesignBuilder | Analytical or scientific software |  |
+| DOE-2 | Analytical or scientific software |  |
+| EffTec EffTrack | Analytical or scientific software |  |
+| Energy Efficient Rehab Advisor | Analytical or scientific software |  |
+| EnergyPlus | Analytical or scientific software |  |
+| EnergySoft EnergyPro | Analytical or scientific software |  |
+| Facility Energy Decision Systems FEDS | Analytical or scientific software |  |
+| Fan System Assessment Tool FSAT | Analytical or scientific software |  |
+| Federal Renewable Energy Screening Assistant FRESA | Analytical or scientific software |  |
+| Fielding Data Labs OptoMizer | Analytical or scientific software |  |
+| InterEnergy Software Building Energy Analyzer PRO | Analytical or scientific software |  |
+| Itron Enterprise Energy Management EEM Suite | Analytical or scientific software |  |
+| MotorMaster+ | Analytical or scientific software |  |
+| Performance Systems Development TREAT | Analytical or scientific software |  |
+| Process Heating Assessment and Survey Tool PHAST | Analytical or scientific software |  |
+| Program for Energy Analysis of Residences PEAR | Analytical or scientific software |  |
+| Quick Plant Energy Profiler | Analytical or scientific software |  |
+| Retrofit Energy Savings Estimation Model RESEM | Analytical or scientific software |  |
+| Steam System Tool Suite | Analytical or scientific software |  |
+| Stellar Processes EZ Sim | Analytical or scientific software |  |
+| Trane System Analyzer | Analytical or scientific software |  |
+| Trane TRACE | Analytical or scientific software |  |
+| Home Energy Efficient Design HEED | Computer aided design CAD software |  |
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 4 ads, as of 2026-07-11)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Tools
+
+- Microsoft Excel — **75 %**
+- MS Word — **25 %**
+- Outlook — **25 %**
+- Lexis-Nexis — **25 %**
+- GIS software — **25 %**
+- ArcGIS — **25 %**
+- Bloomberg terminal — **25 %**
+- QGIS — **25 %**
+- PowerPoint — **25 %**
+- S&P website — **25 %**
+- SharePoint — **25 %**
+
+<!-- market-evidence -->