feat: optical-engineer skill package v0.1.0

2026-08-14 16:57:46 +02:00
commit 566300d7ca
9 changed files with 1122 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — optical-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 — optical-engineer
+    "ESCO (occupation & competences)" : 119
+    "O*NET (tasks & tools)" : 100
+    "Job boards (market evidence)" : 103
+    "Anthropic official Claude skills" : 5
+    "External AI skill packs (mapped)" : 159
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 119 | 24.5 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 100 | 20.6 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 103 | 21.2 % | 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.0 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 159 | 32.7 % | 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,81 @@
+---
+name: optical-engineer
+description: "Occupational skill for the role 'optical engineer' (also: optics engineer, optical technology engineer, optical engineering specialist, optical engineering expert, optical technology engineering expert, optical technology engineering specialist). Use when the user asks for typical optical engineer work such as: Analyze, fabricate, or test fiber-optic links.; Design electro-optical sensing or imaging systems.; Determine commercial, industrial, scientific, or other uses for electro-optical applications or devices."
+---
+
+# Optical Engineer
+
+Optical engineers design and develop different industrial applications with optics. They have knowledge of light, light transmission principles, and optics in order to design engineering specs of equipment such as microscopes, lenses, telescopes, and other optical devices.
+
+## Core workflow
+
+1. Analyze, fabricate, or test fiber-optic links.
+2. Design electro-optical sensing or imaging systems.
+3. Determine commercial, industrial, scientific, or other uses for electro-optical applications or devices.
+4. Conduct research on new photonics technologies.
+5. Design, integrate, or test photonics systems or components.
+6. Analyze system performance or operational requirements.
+7. Conduct testing to determine functionality or optimization or to establish limits of photonics systems or components.
+8. Design gas lasers, solid state lasers, infrared, or other light emitting or light sensitive devices.
+
+## 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
+- analyse test data
+- approve engineering design
+- conduct literature research
+- conduct quality control analysis
+- demonstrate disciplinary expertise
+- design drawings
+- design optical prototypes
+- develop optical test procedures
+- engineering principles
+- interact professionally in research and professional environments
+- manage personal professional development
+- manage research data
+- mathematics
+- model optical systems
+
+## Hot technologies
+
+- SAS
+- The MathWorks MATLAB
+- Autodesk AutoCAD
+- Dassault Systemes SolidWorks
+- C
+- Go
+- Microsoft .NET Framework
+- Microsoft Visual Basic
+- Microsoft Outlook
+- ESRI ArcGIS software
+
+
+<!-- hot-tech -->
+
+## Hot technologies
+
+Top tools from 57 gated job ads (see references/market.md, as of 2026-07-18):
+
+- Zemax — 42 %
+- Code V — 30 %
+- MATLAB — 26 %
+- Python — 26 %
+- FRED — 18 %
+- LightTools — 7 %
+- COMSOL — 5 %
+- Microsoft Excel — 5 %
+- Solidworks — 5 %
+- Zemax OpticStudio — 5 %
+
+<!-- hot-tech -->
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/ab3c4d3e-3189-47ad-82af-57cdae3cb589), O*NET 30.3 (17-2199.07). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,238 @@
+{
+  "name": "optical-engineer",
+  "title": "optical engineer",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/ab3c4d3e-3189-47ad-82af-57cdae3cb589",
+    "esco_code": "2149.12",
+    "isco_group": "2149",
+    "onet_soc": "17-2199.07",
+    "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": 26,
+    "dwas": 21,
+    "skills_essential": 33,
+    "skills_optional": 85,
+    "software": 52
+  },
+  "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
+      },
+      "rampstackco/claude-skills": {
+        "repo": "https://github.com/rampstackco/claude-skills",
+        "commit": "bc6d961",
+        "license": "MIT",
+        "skills": 2
+      },
+      "nWave-ai/nWave": {
+        "repo": "https://github.com/nWave-ai/nWave",
+        "commit": "1d0f13c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 7
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 11
+      },
+      "ferdinandobons/startup-skill": {
+        "repo": "https://github.com/ferdinandobons/startup-skill",
+        "commit": "a5f97c3",
+        "license": "MIT",
+        "skills": 1
+      },
+      "AgriciDaniel/claude-ads": {
+        "repo": "https://github.com/AgriciDaniel/claude-ads",
+        "commit": "669c760",
+        "license": "MIT",
+        "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
+      },
+      "foryourhealth111-pixel/Vibe-Skills": {
+        "repo": "https://github.com/foryourhealth111-pixel/Vibe-Skills",
+        "commit": "34429a8",
+        "license": "Apache-2.0",
+        "skills": 8
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 9
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 9
+      },
+      "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": 1
+      },
+      "HeshamFS/materials-simulation-skills": {
+        "repo": "https://github.com/HeshamFS/materials-simulation-skills",
+        "commit": "fa1ce8d",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "basicmachines-co/basic-memory": {
+        "repo": "https://github.com/basicmachines-co/basic-memory",
+        "commit": "53da71c",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "dotnet/skills": {
+        "repo": "https://github.com/dotnet/skills",
+        "commit": "79a2ada",
+        "license": "MIT",
+        "skills": 1
+      },
+      "sanjay3290/ai-skills": {
+        "repo": "https://github.com/sanjay3290/ai-skills",
+        "commit": "3619692",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "jeremylongshore/claude-code-plugins-plus-skills": {
+        "repo": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills",
+        "commit": "e112938a",
+        "license": "MIT",
+        "skills": 1
+      },
+      "hypnguyen1209/offensive-claude": {
+        "repo": "https://github.com/hypnguyen1209/offensive-claude",
+        "commit": "4d62be7",
+        "license": "MIT",
+        "skills": 1
+      },
+      "nexscope-ai/eCommerce-Skills": {
+        "repo": "https://github.com/nexscope-ai/eCommerce-Skills",
+        "commit": "56f3288",
+        "license": "MIT",
+        "skills": 1
+      },
+      "zebbern/claude-code-guide": {
+        "repo": "https://github.com/zebbern/claude-code-guide",
+        "commit": "d2c5280",
+        "license": "MIT",
+        "skills": 1
+      },
+      "OpenSenseNova/SenseNova-Skills": {
+        "repo": "https://github.com/OpenSenseNova/SenseNova-Skills",
+        "commit": "d8bb438",
+        "license": "MIT",
+        "skills": 1
+      },
+      "pedrohcgs/claude-code-my-workflow": {
+        "repo": "https://github.com/pedrohcgs/claude-code-my-workflow",
+        "commit": "be53c12",
+        "license": "MIT",
+        "skills": 1
+      },
+      "davepoon/buildwithclaude": {
+        "repo": "https://github.com/davepoon/buildwithclaude",
+        "commit": "3c94e0c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "snyk/agent-scan": {
+        "repo": "https://github.com/snyk/agent-scan",
+        "commit": "f3a4621",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "ThinkInAIXYZ/deepchat": {
+        "repo": "https://github.com/ThinkInAIXYZ/deepchat",
+        "commit": "f275c92",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "claude-world/director-mode-lite": {
+        "repo": "https://github.com/claude-world/director-mode-lite",
+        "commit": "9d0c333",
+        "license": "MIT",
+        "skills": 1
+      },
+      "rohitg00/skillkit": {
+        "repo": "https://github.com/rohitg00/skillkit",
+        "commit": "d2e5c34",
+        "license": "Apache-2.0",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 78,
+      "adjacent": 2
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 119,
+      "onet": 100,
+      "jobads": 103,
+      "wiki_ai": 0,
+      "anthropic": 5,
+      "ai_skills": 159,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 24.5,
+      "onet": 20.6,
+      "jobads": 21.2,
+      "wiki_ai": 0.0,
+      "anthropic": 1.0,
+      "ai_skills": 32.7,
+      "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,322 @@
+# External AI agent skills — optical-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: 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 |
+|---|---|---|---|
+| `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) |
+| `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 Statistical Analyzer` | core | Performs statistical analysis for A/B testing experiments | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/data-engineering-analytics/skills/ab-test-statistical-analyzer) |
+| `statistical-testing` | core | Apply statistical hypothesis testing, significance analysis, A/B test evaluation, and distribution comparisons for data science workflows. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/data-science-ml/skills/statistical-testing) |
+| `growing-outside-in-systems` | core | Drive feature development using Outside-In TDD with Hexagonal Architecture. Design emerges through inline code, in-memory fakes, interface extraction, and deferred I/O. Use when building features, writing tests, or structuring backend … | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/backend-development/skills/growing-outside-in-systems) |
+
+## 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: 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) |
+| `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) |
+| `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) |
+| `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) |
+| `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) |
+| `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) |
+| `research-ideation` | core | This skill should be used when the user asks to "brainstorm research ideas", "use 5W1H framework", "identify research gaps", "conduct gap analysis", "start research project", "conduct literature review", "define research question", "select … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/33-Galaxy-Dawn-claude-scholar/skills/research-ideation) |
+| `academic-baseline` | core | Use when working on any empirical academic research context — paper writing, data analysis, literature review, or any task involving citations, results, or publication artifacts. Establishes non-negotiable principles that govern all other … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/60-regisely-superpapers/skills/academic-baseline) |
+| `ai-ml-skills` | core | 27 ai & machine learning skills. Trigger: ML experiments, model training, deep learning, NLP, computer vision. Design: covers frameworks, benchmarks, paper reproduction, and AI research workflows. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/ai-ml) |
+| `deep-research-skills` | core | 13 deep research & systematic reviews skills. Trigger: systematic reviews, multi-source synthesis, comprehensive literature surveys. Design: multi-step research protocols with quality assessment and evidence grading. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/deep-research) |
+| `a5` | core | Agent A5 - Paradigm & Worldview Advisor - Philosophical foundations for research design. Covers ontology, epistemology, axiology, and methodology alignment. Use when: establishing philosophical foundations, justifying methodological … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/25-HosungYou-Diverga/skills/a5) |
+| `action-research-guide` | core | Design and conduct action research and participatory studies | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/methodology/action-research-guide) |
+
+## Source: claude-world/director-mode-lite
+
+- Repository: [https://github.com/claude-world/director-mode-lite](https://github.com/claude-world/director-mode-lite) (commit `9d0c333`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `handoff-gemini` | core | Delegate long-context analysis, research, and large-document summarization to Google Gemini CLI (1M-token context) via non-interactive `gemini -p`, preserving Claude context. Use when the user says 'use gemini'/'hand off to gemini' or a … | [source](https://github.com/claude-world/director-mode-lite/tree/9d0c333/skills/handoff-gemini) |
+
+## Source: davepoon/buildwithclaude
+
+- Repository: [https://github.com/davepoon/buildwithclaude](https://github.com/davepoon/buildwithclaude) (commit `3c94e0c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `docx` | core | Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new … | [source](https://github.com/davepoon/buildwithclaude/tree/3c94e0c/plugins/all-skills/skills/docx) |
+
+## 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) |
+| `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) |
+| `statistical-analysis` | core | Statistical analysis toolkit. Hypothesis tests (t-test, ANOVA, chi-square), regression, correlation, Bayesian stats, power analysis, assumption checks, APA reporting, for academic research. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/statistical-analysis) |
+| `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) |
+| `denario` | core | Multiagent AI system for scientific research assistance that automates research workflows from data analysis to publication. This skill should be used when generating research ideas from datasets, developing research methodologies, … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/denario) |
+| `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) |
+| `brenda-database` | core | Access BRENDA enzyme database via SOAP API. Retrieve kinetic parameters (Km, kcat), reaction equations, organism data, and substrate-specific enzyme information for biochemical research and metabolic pathway analysis. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/brenda-database) |
+| `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) |
+| `biomni` | core | Autonomous biomedical AI agent framework for executing complex research tasks across genomics, drug discovery, molecular biology, and clinical analysis. Use this skill when conducting multi-step biomedical research including CRISPR … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/biomni) |
+| `ensembl-database` | core | Query Ensembl genome database REST API for 250+ species. Gene lookups, sequence retrieval, variant analysis, comparative genomics, orthologs, VEP predictions, for genomic research. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/ensembl-database) |
+| `fda-database` | core | Query openFDA API for drugs, devices, adverse events, recalls, regulatory submissions (510k, PMA), substance identification (UNII), for FDA regulatory data analysis and safety research. | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/fda-database) |
+
+## Source: dotnet/skills
+
+- Repository: [https://github.com/dotnet/skills](https://github.com/dotnet/skills) (commit `79a2ada`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `exp-mock-usage-analysis` | core | Audits .NET test mock usage by tracing each mock setup through the production code's execution path to find dead, unreachable, redundant, or replaceable mocks. Use when the user asks to audit mock usage, find unused or unnecessary mock … | [source](https://github.com/dotnet/skills/tree/79a2ada/plugins/dotnet-experimental/skills/exp-mock-usage-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 |
+|---|---|---|---|
+| `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-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) |
+| `statistical-analysis` | core | Statistical analysis toolkit. Hypothesis tests (t-test, ANOVA, chi-square), regression, correlation, Bayesian stats, power analysis, assumption checks, APA reporting, for academic research. | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/statistical-analysis) |
+| `denario` | core | Multiagent AI system for scientific research assistance that automates research workflows from data analysis to publication. This skill should be used when generating research ideas from datasets, developing research methodologies, … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/denario) |
+| `geomaster` | core | Comprehensive geospatial science skill covering remote sensing, GIS, spatial analysis, machine learning for earth observation, and 30+ scientific domains. Supports satellite imagery processing (Sentinel, Landsat, MODIS, SAR, … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/geomaster) |
+| `scholar-evaluation` | core | Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and writing with quantitative scoring and … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scholar-evaluation) |
+| `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) |
+| `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) |
+
+## 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) |
+
+## 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 |
+|---|---|---|---|
+| `lumen-abtest` | core | A/B test design — produce an experiment spec with hypothesis, primary metric, MDE, sample size, run time, and decision rule. Also determines when NOT to A/B test and what to do instead. Use when asked to "design an A/B test", "should we … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-agency/tonone/skills/lumen-abtest) |
+
+## 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 |
+|---|---|---|---|
+| `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) |
+| `statistical-analysis` | core | Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting. Use whenever a user wants to compare groups, test a hypothesis, analyze … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/statistical-analysis) |
+| `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) |
+| `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) |
+| `geomaster` | core | Comprehensive geospatial science skill covering remote sensing, GIS, spatial analysis, machine learning for earth observation, and 30+ scientific domains. Supports satellite imagery processing (Sentinel, Landsat, MODIS, SAR, … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/geomaster) |
+| `scholar-evaluation` | core | Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and writing with quantitative scoring and … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/scholar-evaluation) |
+| `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) |
+| `hypogenic` | core | Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/hypogenic) |
+| `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) |
+
+## 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 |
+|---|---|---|---|
+| `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) |
+| `statistical-analysis` | core | Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting. Use whenever a user wants to compare groups, test a hypothesis, analyze … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/statistical-analysis) |
+| `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) |
+| `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) |
+| `geomaster` | core | Comprehensive geospatial science skill covering remote sensing, GIS, spatial analysis, machine learning for earth observation, and 30+ scientific domains. Supports satellite imagery processing (Sentinel, Landsat, MODIS, SAR, … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/geomaster) |
+| `scholar-evaluation` | core | Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and writing with quantitative scoring and … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/scholar-evaluation) |
+| `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) |
+| `hypogenic` | core | Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/hypogenic) |
+| `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) |
+
+## 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 |
+|---|---|---|---|
+| `price-optimization-tool` | core | Evaluate ecommerce price candidates using unit economics, historical observations, elasticity analysis, scenario modeling, and controlled experiments. Use when a seller asks what price to test, how price changes could affect contribution … | [source](https://github.com/nexscope-ai/eCommerce-Skills/tree/56f3288/price-optimization-tool) |
+
+## 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: OpenSenseNova/SenseNova-Skills
+
+- Repository: [https://github.com/OpenSenseNova/SenseNova-Skills](https://github.com/OpenSenseNova/SenseNova-Skills) (commit `d8bb438`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `excel-data-analysis-and-report-generation` | core | 从Excel提取多类型数据，并生成包含可视化图表与下载链接的综合分析报告。 | [source](https://github.com/OpenSenseNova/SenseNova-Skills/tree/d8bb438/skills/sn-da-excel-workflow/capability/excel-result-export/report-generation-export) |
+
+## 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: 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 |
+|---|---|---|---|
+| `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) |
+| `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) |
+
+## 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 |
+|---|---|---|---|
+| `hypothesis-testing` | core | Applies the scientific method to debugging by helping users form specific, testable hypotheses, design targeted experiments, and systematically confirm or reject theories to find root causes. Use when a user says their code isn't working, … | [source](https://github.com/rohitg00/skillkit/tree/d2e5c34/packages/core/src/methodology/packs/debugging/hypothesis-testing) |
+
+## 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: snyk/agent-scan
+
+- Repository: [https://github.com/snyk/agent-scan](https://github.com/snyk/agent-scan) (commit `f3a4621`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `docx` | core | Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new … | [source](https://github.com/snyk/agent-scan/tree/f3a4621/tests/skills/docx) |
+
+## Source: ThinkInAIXYZ/deepchat
+
+- Repository: [https://github.com/ThinkInAIXYZ/deepchat](https://github.com/ThinkInAIXYZ/deepchat) (commit `f275c92`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `docx` | core | Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new … | [source](https://github.com/ThinkInAIXYZ/deepchat/tree/f275c92/resources/skills/docx) |
+
+## 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) |
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,152 @@
+# Market evidence report — optical-engineer
+
+Source: **57 real job ads** (JSearch API, countries: us 57), extracted into the MSSQL evidence store; as of 2026-07-18.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| mid | 32 | 56 % |
+| senior | 18 | 32 % |
+| n/a | 3 | 5 % |
+| junior | 2 | 4 % |
+| lead | 2 | 4 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | Zemax | 24 | 42 % |
+| 2 | Code V | 17 | 30 % |
+| 3 | MATLAB | 15 | 26 % |
+| 4 | Python | 15 | 26 % |
+| 5 | FRED | 10 | 18 % |
+| 6 | LightTools | 4 | 7 % |
+| 7 | COMSOL | 3 | 5 % |
+| 8 | Microsoft Excel | 3 | 5 % |
+| 9 | Solidworks | 3 | 5 % |
+| 10 | Zemax OpticStudio | 3 | 5 % |
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | data analysis | 22 | 39 % |
+| 2 | optical system design | 20 | 35 % |
+| 3 | optical design | 11 | 19 % |
+| 4 | stray light analysis | 7 | 12 % |
+| 5 | technical documentation | 6 | 11 % |
+| 6 | optical engineering | 5 | 9 % |
+| 7 | optical testing | 5 | 9 % |
+| 8 | system integration | 5 | 9 % |
+| 9 | tolerance analysis | 5 | 9 % |
+| 10 | fiber optics | 4 | 7 % |
+| 11 | troubleshooting | 4 | 7 % |
+| 12 | alignment | 3 | 5 % |
+| 13 | electro-optical design | 3 | 5 % |
+| 14 | lens design | 3 | 5 % |
+| 15 | manufacturing | 3 | 5 % |
+| 16 | optical alignment | 3 | 5 % |
+| 17 | optical analysis | 3 | 5 % |
+| 18 | optical modeling | 3 | 5 % |
+| 19 | problem solving | 3 | 5 % |
+| 20 | remote sensing | 3 | 5 % |
+| 21 | simulation | 3 | 5 % |
+| 22 | system modeling | 3 | 5 % |
+| 23 | system validation | 3 | 5 % |
+| 24 | technical analysis | 3 | 5 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | data analysis | 6 | 11 % |
+| 2 | system integration | 5 | 9 % |
+| 3 | optical system design | 4 | 7 % |
+| 4 | manufacturing support | 3 | 5 % |
+| 5 | product development | 3 | 5 % |
+| 6 | system testing | 3 | 5 % |
+
+## Regional breakdown
+
+> **Corpus note:** 57 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+57 ads.
+
+**Top hard skills:**
+
+- data analysis — 39 % (22 ads)
+- optical system design — 35 % (20 ads)
+- optical design — 19 % (11 ads)
+- stray light analysis — 12 % (7 ads)
+- technical documentation — 11 % (6 ads)
+- optical engineering — 9 % (5 ads)
+- optical testing — 9 % (5 ads)
+- system integration — 9 % (5 ads)
+- tolerance analysis — 9 % (5 ads)
+- fiber optics — 7 % (4 ads)
+
+**Top tools:**
+
+- Zemax — 42 % (24 ads)
+- Code V — 30 % (17 ads)
+- MATLAB — 26 % (15 ads)
+- Python — 26 % (15 ads)
+- FRED — 18 % (10 ads)
+- LightTools — 7 % (4 ads)
+- COMSOL — 5 % (3 ads)
+- Microsoft Excel — 5 % (3 ads)
+- Solidworks — 5 % (3 ads)
+- Zemax OpticStudio — 5 % (3 ads)
+
+**Seniority:** mid 56 % · senior 32 % · n/a 5 % · junior 4 % · lead 4 %
+
+### 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 |
+|---|---|
+| Optical Engineer | 6 |
+| Principal Optical Engineer | 6 |
+| Electro-Optical Engineer, Sr | 2 |
+| Optical Engineer (PIC Design & Analysis) | 2 |
+| Optical Engineer Senior | 2 |
+| Senior Optical Engineer | 2 |
+| (Open Application) Optical Metrology Engineer | 1 |
+| 2026 Graduate - Optics & Photonics Engineer/Scientist | 1 |
+| Associate Electronic and Optical Materials Device Fabrication Engineer | 1 |
+| Associate Staff - Straylight Analysis (Optical Engineering Group) | 1 |
+| Ciena Optical Engineer | 1 |
+| Electro-Optical Engineer (All levels) | 1 |
+| Electro-Optical Engineer Senior Stf - Directed Energy | 1 |
+| Electro-Optical Manufacturing Engineer | 1 |
+| Junior Space Optics Engineer (Metrology & Alignment) | 1 |
+| Optical Architect - AI Accelerators | 1 |
+| Optical Design Engineer | 1 |
+| Optical Engineer Level 2 | 1 |
+| Optical Engineer, Advanced Photonic IC Development | 1 |
+| Optical Engineer, Amazon Leo for Government, Optical and Opto-Mechanical Engineering | 1 |
+| Optical Engineer/Scientist (Ph.D.) | 1 |
+| Optical Systems Engineer | 1 |
+| Optical Test Development Engineer | 1 |
+| Optics Engineer | 1 |
+| Optics Engineer EO/IR Sensing & Systems | 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,28 @@
+# Occupation profile — optical engineer
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/ab3c4d3e-3189-47ad-82af-57cdae3cb589
+- **ESCO code:** 2149.12
+- **ISCO-08 group:** 2149 — Engineering professionals not elsewhere classified
+- **O*NET-SOC:** 17-2199.07 — Photonics Engineers (match: closeMatch)
+
+## Description (ESCO)
+
+Optical engineers design and develop different industrial applications with optics. They have knowledge of light, light transmission principles, and optics in order to design engineering specs of equipment such as microscopes, lenses, telescopes, and other optical devices.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- optics engineer
+- optical technology engineer
+- optical engineering specialist
+- optical engineering expert
+- optical technology engineering expert
+- optical technology engineering specialist
+- optical engineering adviser
+- optical engineering consultant
+- optic engineer
+- optical technology engineering adviser
+- optical technology engineering consultant
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,141 @@
+# Competences — optical engineer
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/ab3c4d3e-3189-47ad-82af-57cdae3cb589).
+
+## Essential
+
+- **adjust engineering designs** (skill/competence)
+- **analyse test data** (skill/competence)
+- **approve engineering design** (skill/competence)
+- **conduct literature research** (skill/competence)
+- **conduct quality control analysis** (skill/competence)
+- **demonstrate disciplinary expertise** (skill/competence)
+- **design drawings** (knowledge)
+- **design optical prototypes** (skill/competence)
+- **develop optical test procedures** (skill/competence)
+- **engineering principles** (knowledge)
+- **interact professionally in research and professional environments** (skill/competence)
+- **manage personal professional development** (skill/competence)
+- **manage research data** (skill/competence)
+- **mathematics** (knowledge)
+- **model optical systems** (skill/competence)
+- **operate open source software** (skill/competence)
+- **operate scientific measuring equipment** (skill/competence)
+- **optical components** (knowledge)
+- **optical engineering** (knowledge)
+- **optical equipment standards** (knowledge)
+- **optical glass characteristics** (knowledge)
+- **optical manufacturing process** (knowledge)
+- **optics** (knowledge)
+- **perform project management** (skill/competence)
+- **physics** (knowledge)
+- **prepare production prototypes** (skill/competence)
+- **record test data** (skill/competence)
+- **refractive power** (knowledge)
+- **report analysis results** (skill/competence)
+- **synthesise information** (skill/competence)
+- **test optical components** (skill/competence)
+- **think abstractly** (skill/competence)
+- **types of optical instruments** (knowledge)
+
+## Optional
+
+- acoustics (knowledge)
+- apply blended learning (skill/competence)
+- apply for research funding (skill/competence)
+- apply research ethics and scientific integrity principles in research activities (skill/competence)
+- apply technical communication skills (skill/competence)
+- build business relationships (skill/competence)
+- CAE software (knowledge)
+- cavity optomechanics (knowledge)
+- communicate with a non-scientific audience (skill/competence)
+- communicate with customers (skill/competence)
+- computer engineering (knowledge)
+- conduct research across disciplines (skill/competence)
+- control engineering (knowledge)
+- coordinate engineering teams (skill/competence)
+- create technical plans (skill/competence)
+- define manufacturing quality criteria (skill/competence)
+- design optical systems (skill/competence)
+- develop electronic test procedures (skill/competence)
+- develop product design (skill/competence)
+- develop professional network with researchers and scientists (skill/competence)
+- digital camera sensors (knowledge)
+- disseminate results to the scientific community (skill/competence)
+- draft bill of materials (skill/competence)
+- draft scientific or academic papers and technical documentation (skill/competence)
+- electromagnetic spectrum (knowledge)
+- electronic equipment standards (knowledge)
+- electronics (knowledge)
+- electrooptic devices (knowledge)
+- electrooptics (knowledge)
+- evaluate research activities (skill/competence)
+- fibre optics (knowledge)
+- increase the impact of science on policy and society (skill/competence)
+- integrate gender dimension in research (skill/competence)
+- interpret circuit diagrams (skill/competence)
+- lasers (knowledge)
+- maintain optical equipment (skill/competence)
+- maintain safe engineering watches (skill/competence)
+- manage findable accessible interoperable and reusable data (skill/competence)
+- manage intellectual property rights (skill/competence)
+- manage open publications (skill/competence)
+- mechanical engineering (knowledge)
+- medical imaging technology (knowledge)
+- mentor individuals (skill/competence)
+- microelectromechanical systems (knowledge)
+- microelectronics (knowledge)
+- microoptics (knowledge)
+- microprocessors (knowledge)
+- microsensors (knowledge)
+- microwave principles (knowledge)
+- MOEM (knowledge)
+- mount optical components on frames (skill/competence)
+- operate optical assembly equipment (skill/competence)
+- operate precision machinery (skill/competence)
+- operate precision measuring equipment (skill/competence)
+- optical instruments (knowledge)
+- optoelectronic devices (knowledge)
+- optoelectronics (knowledge)
+- optomechanical components (knowledge)
+- optomechanical engineering (knowledge)
+- perform data analysis (skill/competence)
+- perform resource planning (skill/competence)
+- perform scientific research (skill/competence)
+- perform test run (skill/competence)
+- photonics (knowledge)
+- precision mechanics (knowledge)
+- prepare assembly drawings (skill/competence)
+- promote open innovation in research (skill/competence)
+- promote the participation of citizens in scientific and research activities (skill/competence)
+- promote the transfer of knowledge (skill/competence)
+- publish academic research (skill/competence)
+- quality standards (knowledge)
+- quantum optics (knowledge)
+- radars (knowledge)
+- read engineering drawings (skill/competence)
+- resolve equipment malfunctions (skill/competence)
+- sell optical products (skill/competence)
+- semiconductors (knowledge)
+- sensors (knowledge)
+- speak different languages (skill/competence)
+- teach in academic or vocational contexts (skill/competence)
+- telecommunications engineering (knowledge)
+- train employees (skill/competence)
+- use CAD software (skill/competence)
+- use precision tools (skill/competence)
+- write scientific publications (skill/competence)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 57 ads, as of 2026-07-18)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- data analysis — **39 %**
+- optical system design — **35 %**
+- optical design — **19 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,56 @@
+# Tasks & work activities — optical engineer
+
+Source: O*NET 30.3, occupation 17-2199.07 (Photonics Engineers).
+
+## Task statements
+
+- **[Core]** Analyze, fabricate, or test fiber-optic links.
+- **[Core]** Design electro-optical sensing or imaging systems.
+- **[Core]** Determine commercial, industrial, scientific, or other uses for electro-optical applications or devices.
+- **[Core]** Conduct research on new photonics technologies.
+- **[Core]** Design, integrate, or test photonics systems or components.
+- **[Core]** Analyze system performance or operational requirements.
+- **[Core]** Conduct testing to determine functionality or optimization or to establish limits of photonics systems or components.
+- **[Core]** Design gas lasers, solid state lasers, infrared, or other light emitting or light sensitive devices.
+- **[Core]** Determine applications of photonics appropriate to meet product objectives or features.
+- **[Core]** Develop or test photonic prototypes or models.
+- **[Core]** Develop optical or imaging systems, such as optical imaging products, optical components, image processes, signal process technologies, or optical systems.
+- **[Core]** Assist in the transition of photonic prototypes to production.
+- **[Core]** Create or maintain photonic design histories.
+- **[Core]** Oversee or provide expertise on manufacturing, assembly, or fabrication processes.
+- **[Core]** Read current literature, talk with colleagues, continue education, or participate in professional organizations or conferences to keep abreast of developments in the field.
+- **[Core]** Train operators, engineers, or other personnel.
+- **[Core]** Design photonics products, such as light sources, displays, or photovoltaics, to achieve increased energy efficiency.
+- **[Core]** Write reports or proposals related to photonics research or development projects.
+- **[Core]** Document photonics system or component design processes, including objectives, issues, or outcomes.
+- **[Supplemental]** Select, purchase, set up, operate, or troubleshoot state-of-the-art laser cutting equipment.
+- **[Supplemental]** Design laser machining equipment for purposes such as high-speed ablation.
+- **[Supplemental]** Develop laser-processed designs, such as laser-cut medical devices.
+- **[Supplemental]** Design or develop new crystals for photonics applications.
+- **[Supplemental]** Design or redesign optical fibers to minimize energy loss.
+- **[Supplemental]** Design solar energy photonics or other materials or devices to generate energy.
+- **[Supplemental]** Develop photonics sensing or manufacturing technologies to improve the efficiency of manufacturing or related processes.
+
+## Detailed work activities
+
+- Analyze operational data to evaluate operations, processes or products.
+- Create physical models or prototypes.
+- Design electronic or computer equipment or instrumentation.
+- Design energy production or management equipment or systems.
+- Design industrial processing systems.
+- Direct industrial production activities.
+- Document technical design details.
+- Fabricate devices or components.
+- Identify new applications for existing technologies.
+- Maintain operational records or records systems.
+- Operate industrial equipment.
+- Prepare detailed work plans.
+- Prepare proposal documents.
+- Prepare research or technical reports.
+- Purchase materials, equipment, or other resources.
+- Research advanced engineering designs or applications.
+- Select tools, equipment, or technologies for use in operations or projects.
+- Test performance of electrical, electronic, mechanical, or integrated systems or equipment.
+- Train personnel on proper operational procedures.
+- Update technical knowledge.
+- Write reports or evaluations.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,73 @@
+# Tools & technology — optical engineer
+
+Source: O*NET 30.3 'Software Skills' for 17-2199.07.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| SAS | Analytical or scientific software | yes |
+| The MathWorks MATLAB | Analytical or scientific software | yes |
+| Autodesk AutoCAD | Computer aided design CAD software | yes |
+| Dassault Systemes SolidWorks | Computer aided design CAD software | yes |
+| C | Development environment software | yes |
+| Go | Development environment software | yes |
+| Microsoft .NET Framework | Development environment software | yes |
+| Microsoft Visual Basic | Development environment software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| ESRI ArcGIS software | Geographic information system | yes |
+| C# | Object or component oriented development software | yes |
+| C++ | Object or component oriented development software | yes |
+| Oracle Java | Object or component oriented development software | yes |
+| Perl | 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 |
+| Linux | Operating system software | yes |
+| Shell script | Operating system software | yes |
+| UNIX | Operating system software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Visio | Process mapping and design software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Facebook | Web page creation and editing software | yes |
+| Microsoft Word | Word processing software | yes |
+| Adept Scientific GRAMS | Analytical or scientific software |  |
+| BPM_CAD | Analytical or scientific software |  |
+| Finite element analysis FEA software | Analytical or scientific software |  |
+| Mathsoft Mathcad | Analytical or scientific software |  |
+| Pattern recognition software | Analytical or scientific software |  |
+| Photon Design FIMMPROP | Analytical or scientific software |  |
+| Photon Design PICWave | Analytical or scientific software |  |
+| Spectroscopy software | Analytical or scientific software |  |
+| Wolfram Research Mathematica | Analytical or scientific software |  |
+| Apollo Photonics APSS | Computer aided design CAD software |  |
+| Computer-aided drafting or design software | Computer aided design CAD software |  |
+| Dassault Systemes CATIA | Computer aided design CAD software |  |
+| Optical Research Associates LightTools | Computer aided design CAD software |  |
+| Optiwave OptiBPM | Computer aided design CAD software |  |
+| Optiwave OptiFDTD | Computer aided design CAD software |  |
+| Optiwave OptiSPICE | Computer aided design CAD software |  |
+| Photon Design CrystalWave | Computer aided design CAD software |  |
+| Photon Design FIMMWAVE | Computer aided design CAD software |  |
+| Photon Design OmniSim | Computer aided design CAD software |  |
+| Zemax | Computer aided design CAD software |  |
+| Structure query language SQL | Data base user interface and query software |  |
+| Formula translation/translator FORTRAN | Development environment software |  |
+| National Instruments LabVIEW | Development environment software |  |
+| ESRI software | Geographic information system |  |
+| QGIS | Geographic information system |  |
+| Mapping software | Map creation software |  |
+| Debugging software | Program testing software |  |
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 57 ads, as of 2026-07-18)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Tools
+
+- Zemax — **42 %**
+- Code V — **30 %**
+- MATLAB — **26 %**
+- Python — **26 %**
+
+<!-- market-evidence -->