feat: photonics-engineer skill package v0.1.0

2026-08-14 16:55:42 +02:00
commit 0f5d1ff357
9 changed files with 1038 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — photonics-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 — photonics-engineer
+    "ESCO (occupation & competences)" : 106
+    "O*NET (tasks & tools)" : 65
+    "Job boards (market evidence)" : 102
+    "Anthropic official Claude skills" : 5
+    "External AI skill packs (mapped)" : 150
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 106 | 24.8 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 65 | 15.2 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 102 | 23.8 % | references/market.md (full report) + "Market evidence" headline sections |
+| Wikipedia & AI expert curation | 0 | 0.0 % | glossary, literature, usecases, intake, quality, evals/ |
+| Anthropic official Claude skills | 5 | 1.2 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 150 | 35.0 % | 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: photonics-engineer
+description: "Occupational skill for the role 'photonics engineer' (also: engineer specialised in photonic systems, photonic technology engineering consultant, photonic technology engineering specialist, photonics engineering expert, photonics systems engineer, photonic technology engineer). Use when the user asks for typical photonics engineer work such as: Monitor inventory levels and order supplies as necessary.; Maintain clean working environments, according to clean room standards.; Test or perform failure analysis for optomechanical or optoelectrical products, according to test plans."
+---
+
+# Photonics Engineer
+
+Photonics engineers are concerned with the generation, transmission, transformation, and detection of light. They conduct research, design, assemble, test and deploy photonic components or systems in multiple application fields, from optical communications to medical instrumentation, material processing or sensing technology.
+
+## Core workflow
+
+1. Monitor inventory levels and order supplies as necessary.
+2. Maintain clean working environments, according to clean room standards.
+3. Test or perform failure analysis for optomechanical or optoelectrical products, according to test plans.
+4. Assist scientists or engineers in the conduct of photonic experiments.
+5. Assist engineers in the development of new products, fixtures, tools, or processes.
+6. Set up or operate prototype or test apparatus, such as control consoles, collimators, recording equipment, or cables.
+7. Set up or operate assembly or processing equipment, such as lasers, cameras, die bonders, wire bonders, dispensers, reflow ovens, soldering irons, die shears, wire pull testers, temperature or humidity chambers, or optical spectrum analyzers.
+8. Adjust or maintain equipment, such as lasers, laser systems, microscopes, oscilloscopes, pulse generators, power meters, beam analyzers, or energy measurement 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
+- design optical systems
+- develop optical test procedures
+- digital twin technology
+- electronics
+- engineering principles
+- holography
+- interact professionally in research and professional environments
+
+## Hot technologies
+
+- The MathWorks MATLAB
+- Autodesk AutoCAD
+- Dassault Systemes SolidWorks
+- Microsoft Access
+- SAP software
+- Microsoft Office software
+- Microsoft PowerPoint
+- Microsoft Excel
+- Facebook
+- Microsoft Word
+
+
+<!-- hot-tech -->
+
+## Hot technologies
+
+Top tools from 57 gated job ads (see references/market.md, as of 2026-07-18):
+
+- Python — 37 %
+- Matlab — 23 %
+- Lumerical — 21 %
+- KLayout — 11 %
+- COMSOL — 9 %
+- GDSfactory — 7 %
+- HFSS — 7 %
+- JMP — 7 %
+- Labview — 7 %
+- Tidy3D — 7 %
+
+<!-- hot-tech -->
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/778c1d37-69f2-4184-ac98-03b7dbfba332), O*NET 30.3 (17-3029.08). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,220 @@
+{
+  "name": "photonics-engineer",
+  "title": "photonics engineer",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/778c1d37-69f2-4184-ac98-03b7dbfba332",
+    "esco_code": "2149.12.1",
+    "isco_group": "2149",
+    "onet_soc": "17-3029.08",
+    "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": 24,
+    "dwas": 23,
+    "skills_essential": 41,
+    "skills_optional": 64,
+    "software": 17
+  },
+  "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": 2
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 10
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 8
+      },
+      "foryourhealth111-pixel/Vibe-Skills": {
+        "repo": "https://github.com/foryourhealth111-pixel/Vibe-Skills",
+        "commit": "34429a8",
+        "license": "Apache-2.0",
+        "skills": 6
+      },
+      "AgriciDaniel/claude-ads": {
+        "repo": "https://github.com/AgriciDaniel/claude-ads",
+        "commit": "669c760",
+        "license": "MIT",
+        "skills": 1
+      },
+      "ferdinandobons/startup-skill": {
+        "repo": "https://github.com/ferdinandobons/startup-skill",
+        "commit": "a5f97c3",
+        "license": "MIT",
+        "skills": 1
+      },
+      "HeshamFS/materials-simulation-skills": {
+        "repo": "https://github.com/HeshamFS/materials-simulation-skills",
+        "commit": "fa1ce8d",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "brycewang-stanford/Auto-Empirical-Research-Skills": {
+        "repo": "https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills",
+        "commit": "85bf545",
+        "license": "CC-BY-4.0",
+        "skills": 12
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 6
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 6
+      },
+      "AgriciDaniel/claude-blog": {
+        "repo": "https://github.com/AgriciDaniel/claude-blog",
+        "commit": "49842ea",
+        "license": "MIT",
+        "skills": 1
+      },
+      "infrasity-labs/dev-gtm-claude-skills": {
+        "repo": "https://github.com/infrasity-labs/dev-gtm-claude-skills",
+        "commit": "02cfefb",
+        "license": "MIT",
+        "skills": 2
+      },
+      "basicmachines-co/basic-memory": {
+        "repo": "https://github.com/basicmachines-co/basic-memory",
+        "commit": "53da71c",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "indranilbanerjee/digital-marketing-pro": {
+        "repo": "https://github.com/indranilbanerjee/digital-marketing-pro",
+        "commit": "a3d119c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "nexu-io/open-design": {
+        "repo": "https://github.com/nexu-io/open-design",
+        "commit": "4b66023",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "aaron-he-zhu/aaron-marketing-skills": {
+        "repo": "https://github.com/aaron-he-zhu/aaron-marketing-skills",
+        "commit": "b7b0b9f",
+        "license": "Apache-2.0",
+        "skills": 3
+      },
+      "mohitagw15856/pm-claude-skills": {
+        "repo": "https://github.com/mohitagw15856/pm-claude-skills",
+        "commit": "876fa30",
+        "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
+      },
+      "alirezarezvani/claude-skills": {
+        "repo": "https://github.com/alirezarezvani/claude-skills",
+        "commit": "0241f43",
+        "license": "MIT",
+        "skills": 2
+      },
+      "wondelai/skills": {
+        "repo": "https://github.com/wondelai/skills",
+        "commit": "326b380",
+        "license": "MIT",
+        "skills": 2
+      },
+      "wanshuiyin/Anti-Autoresearch": {
+        "repo": "https://github.com/wanshuiyin/Anti-Autoresearch",
+        "commit": "c7f7f0d",
+        "license": "MIT",
+        "skills": 1
+      },
+      "wanshuiyin/Auto-claude-code-research-in-sleep": {
+        "repo": "https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep",
+        "commit": "eb5c9d7",
+        "license": "MIT",
+        "skills": 1
+      },
+      "rohitg00/skillkit": {
+        "repo": "https://github.com/rohitg00/skillkit",
+        "commit": "d2e5c34",
+        "license": "Apache-2.0",
+        "skills": 2
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 78,
+      "adjacent": 2
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 106,
+      "onet": 65,
+      "jobads": 102,
+      "wiki_ai": 0,
+      "anthropic": 5,
+      "ai_skills": 150,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 24.8,
+      "onet": 15.2,
+      "jobads": 23.8,
+      "wiki_ai": 0.0,
+      "anthropic": 1.2,
+      "ai_skills": 35.0,
+      "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,298 @@
+# External AI agent skills — photonics-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) |
+| `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) |
+| `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) |
+| `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) |
+| `thought-experiment-design` | core | Construct, analyze, and evaluate philosophical thought experiments to test intuitions, reveal conceptual commitments, and probe theoretical implications | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/social-sciences-humanities/philosophy/skills/thought-experiment-design) |
+| `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: aaron-he-zhu/aaron-marketing-skills
+
+- Repository: [https://github.com/aaron-he-zhu/aaron-marketing-skills](https://github.com/aaron-he-zhu/aaron-marketing-skills) (commit `b7b0b9f`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ad-test-designer` | core | Use when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"; produces a hypothesis, variant matrix, sample-size/duration/power … | [source](https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/b7b0b9f/ad/orchestrate/ad-test-designer) |
+| `message-test-designer` | core | Use when the user asks to "test our messaging before we scale it", "design a message-market-fit panel", or "run a 5-second comprehension test on our new tagline"; produces a message-test design spec — hypothesis, panel and recruit … | [source](https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/b7b0b9f/narrative/evaluate/message-test-designer) |
+| `send-experiment-designer` | core | Use when the user asks to "design an email A/B test", "set up a multivariate subject/CTA test", "run a send-time test", "build a hold-out group", or "is this email result statistically and practically material?"; produces a falsifiable … | [source](https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/b7b0b9f/email/deliver/send-experiment-designer) |
+
+## 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: 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 |
+|---|---|---|---|
+| `ab-test-setup` | core | When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/marketing-skill/skills/ab-test-setup) |
+| `senior-data-scientist` | core | World-class senior data scientist skill specialising in statistical modeling, experiment design, causal inference, and predictive analytics. Covers A/B testing (sample sizing, two-proportion z-tests, Bonferroni correction), … | [source](https://github.com/alirezarezvani/claude-skills/tree/0241f43/engineering-team/skills/senior-data-scientist) |
+
+## 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 |
+|---|---|---|---|
+| `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) |
+| `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) |
+| `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) |
+| `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) |
+| `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) |
+| `c1` | core | VS-Enhanced Quantitative Design Consultant with Materials & Sampling Enhanced VS 3-Phase process: Avoids obvious experimental designs, proposes context-optimal quantitative strategies Absorbed C4 (Experimental Materials Developer) and D1 … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/25-HosungYou-Diverga/skills/c1) |
+| `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) |
+| `automation-skills` | core | 10 research automation skills. Trigger: automating experiments, tracking results, reproducible pipelines. Design: ML experiment management, workflow orchestration, and lab automation tools. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/automation) |
+| `physics-skills` | core | 5 physics & astrophysics skills. Trigger: physics simulations, astronomical data, computational physics. Design: domain databases (NASA ADS, arXiv) and simulation tool guides. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/physics) |
+| `qualitative-research-guide` | core | Design and conduct qualitative research using grounded theory and case studies | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/research/methodology/qualitative-research-guide) |
+
+## 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) |
+| `crewai` | core | Expert in CrewAI - the leading role-based multi-agent framework used by 60% of Fortune 500 companies. Covers agent design with roles and goals, task definition, crew orchestration, process types (sequential, hierarchical, parallel), memory … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/ai-research/crewai) |
+| `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) |
+| `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) |
+| `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) |
+| `ab-test-setup` | core | When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," or "hypothesis." For tracking … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/business-marketing/ab-test-setup) |
+| `cirq` | core | Quantum computing framework for building, simulating, optimizing, and executing quantum circuits. Use this skill when working with quantum algorithms, quantum circuit design, quantum simulation (noiseless or noisy), running on quantum … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/cirq) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/scientific-slides) |
+| `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) |
+
+## 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) |
+| `hypothesis-generation` | core | Structured hypothesis formulation from observations. Use when you have experimental observations or data and need to formulate testable hypotheses with predictions, propose mechanisms, and design experiments to test them. Also owns … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/hypothesis-generation) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-slides) |
+| `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) |
+
+## 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: 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 |
+|---|---|---|---|
+| `ab-test-plan` | core | Design A/B and multivariate tests. Use when: sample size calculation, testing hypothesis, CRO experimentation. | [source](https://github.com/indranilbanerjee/digital-marketing-pro/tree/a3d119c/skills/ab-test-plan) |
+
+## 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) |
+| `ab-testing` | core | When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," … | [source](https://github.com/infrasity-labs/dev-gtm-claude-skills/tree/02cfefb/.claude/skills/ab-testing) |
+
+## 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 |
+|---|---|---|---|
+| `hypothesis-tester` | core | Structured hypothesis formulation, experiment design, and results interpretation for Product Managers. Use when the user needs to validate an assumption, design an A/B test, evaluate experiment results, or decide whether to ship based on … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/productivity/pm-ai-partner/skills/hypothesis-tester) |
+| `cro-methodology` | core | Audit websites and landing pages for conversion issues and design evidence-based A/B tests. Use when the user mentions "landing page isnt converting", "conversion rate", "A/B test", "why visitors leave", "objection handling", "bounce … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/business-tools/wondelai-cro-methodology) |
+| `lean-startup` | core | Design MVPs, validated learning experiments, and pivot-or-persevere decisions using Build-Measure-Learn. Use when the user mentions "MVP scope", "validated learning", "pivot or persevere", "vanity metrics", "test assumptions", "innovation … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/productivity/wondelai-lean-startup) |
+| `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) |
+| `surge-experiment` | core | Growth experiment design — structure a growth hypothesis, define metric, baseline, expected lift, and kill condition for a single experiment. Use when asked to "design a growth experiment", "test this growth idea", "experiment framework", … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/ai-agency/tonone/bundle/revenue-team/skills/surge-experiment) |
+
+## 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) |
+| `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) |
+| `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) |
+| `hypothesis-generation` | core | Structured hypothesis formulation from observations. Use when you have experimental observations or data and need to formulate testable hypotheses with predictions, propose mechanisms, and design experiments to test them. Follows … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/hypothesis-generation) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/scientific-slides) |
+
+## 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) |
+| `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) |
+| `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) |
+| `hypothesis-generation` | core | Structured hypothesis formulation from observations. Use when you have experimental observations or data and need to formulate testable hypotheses with predictions, propose mechanisms, and design experiments to test them. Follows … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/hypothesis-generation) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/scientific-slides) |
+
+## Source: mohitagw15856/pm-claude-skills
+
+- Repository: [https://github.com/mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) (commit `876fa30`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `experiment-designer` | core | Design statistically rigorous A/B tests and interpret experiment results. Use when asked to design an experiment, run an A/B test, calculate sample size, interpret test results, or assess whether an experiment was successful. Produces a … | [source](https://github.com/mohitagw15856/pm-claude-skills/tree/876fa30/plugins/pm-advanced/skills/experiment-designer) |
+
+## Source: nexu-io/open-design
+
+- Repository: [https://github.com/nexu-io/open-design](https://github.com/nexu-io/open-design) (commit `4b66023`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `kami-deck` | core | A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Built as a decision-grade academic research deck for lab group, PI. | [source](https://github.com/nexu-io/open-design/tree/4b66023/design-templates/kami-deck) |
+
+## 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) |
+| `nw-bdd-methodology` | core | BDD patterns for acceptance test design - Given-When-Then structure, scenario writing rules, pytest-bdd implementation, anti-patterns, and living documentation | [source](https://github.com/nWave-ai/nWave/tree/1d0f13c/nWave/skills/nw-bdd-methodology) |
+
+## 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 |
+|---|---|---|---|
+| `design-first` | core | Guides the creation of technical design documents before writing code, producing architecture diagrams, data models, API interface definitions, implementation plans, and multi-option trade-off analyses. Use when the user asks to plan a … | [source](https://github.com/rohitg00/skillkit/tree/d2e5c34/packages/core/src/methodology/packs/planning/design-first) |
+| `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: wanshuiyin/Anti-Autoresearch
+
+- Repository: [https://github.com/wanshuiyin/Anti-Autoresearch](https://github.com/wanshuiyin/Anti-Autoresearch) (commit `c7f7f0d`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `eval-design-forensics` | core | Audit whether a paper's EVALUATION DESIGN actually measures what it claims and whether its reporting is complete — the validity layer family D (experiment-forensics) cannot reach. Three patterns: train/test leakage means the reported score … | [source](https://github.com/wanshuiyin/Anti-Autoresearch/tree/c7f7f0d/skills/eval-design-forensics) |
+
+## Source: wanshuiyin/Auto-claude-code-research-in-sleep
+
+- Repository: [https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep](https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep) (commit `eb5c9d7`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `system-profile` | core | Profile a target (script, process, GPU, memory, interconnect) for performance analysis. Use when user says \"profile\", \"benchmark\", \"bottleneck\", or wants performance analysis. | [source](https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep/tree/eb5c9d7/skills/skills-codex/system-profile) |
+
+## Source: wondelai/skills
+
+- Repository: [https://github.com/wondelai/skills](https://github.com/wondelai/skills) (commit `326b380`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `cro-methodology` | core | Audit websites and landing pages for conversion issues and design evidence-based A/B tests. Use when the user mentions "landing page isnt converting", "conversion rate", "A/B test", "why visitors leave", "objection handling", "bounce … | [source](https://github.com/wondelai/skills/tree/326b380/cro-methodology) |
+| `lean-startup` | core | Design MVPs, validated learning experiments, and pivot-or-persevere decisions using Build-Measure-Learn. Use when the user mentions "MVP scope", "validated learning", "pivot or persevere", "vanity metrics", "test assumptions", "innovation … | [source](https://github.com/wondelai/skills/tree/326b380/lean-startup) |
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,154 @@
+# Market evidence report — photonics-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 | 31 | 54 % |
+| senior | 12 | 21 % |
+| junior | 7 | 12 % |
+| lead | 6 | 11 % |
+| n/a | 1 | 2 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | Python | 21 | 37 % |
+| 2 | Matlab | 13 | 23 % |
+| 3 | Lumerical | 12 | 21 % |
+| 4 | KLayout | 6 | 11 % |
+| 5 | COMSOL | 5 | 9 % |
+| 6 | GDSfactory | 4 | 7 % |
+| 7 | HFSS | 4 | 7 % |
+| 8 | JMP | 4 | 7 % |
+| 9 | Labview | 4 | 7 % |
+| 10 | Tidy3D | 4 | 7 % |
+| 11 | tunable lasers | 4 | 7 % |
+| 12 | Cadence Virtuoso | 3 | 5 % |
+| 13 | SolidWorks | 3 | 5 % |
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | data analysis | 24 | 42 % |
+| 2 | simulation | 6 | 11 % |
+| 3 | technical support | 6 | 11 % |
+| 4 | failure analysis | 5 | 9 % |
+| 5 | optical simulation | 5 | 9 % |
+| 6 | photonic integrated circuit design | 5 | 9 % |
+| 7 | system testing | 5 | 9 % |
+| 8 | optical system design | 4 | 7 % |
+| 9 | optical testing | 4 | 7 % |
+| 10 | process optimization | 4 | 7 % |
+| 11 | requirements definition | 4 | 7 % |
+| 12 | rf design | 4 | 7 % |
+| 13 | troubleshooting | 4 | 7 % |
+| 14 | electromagnetic simulation | 3 | 5 % |
+| 15 | manufacturing process design | 3 | 5 % |
+| 16 | quality control implementation | 3 | 5 % |
+| 17 | signal processing | 3 | 5 % |
+| 18 | silicon photonics device design | 3 | 5 % |
+| 19 | system integration | 3 | 5 % |
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | statistical data analysis | 3 | 5 % |
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+| 1 | data analysis | 6 | 11 % |
+| 2 | device design | 5 | 9 % |
+| 3 | pic design | 4 | 7 % |
+| 4 | device characterization | 3 | 5 % |
+| 5 | documentation development | 3 | 5 % |
+| 6 | process optimization | 3 | 5 % |
+| 7 | simulation | 3 | 5 % |
+| 8 | testing | 3 | 5 % |
+| 9 | yield improvement | 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 — 42 % (24 ads)
+- simulation — 11 % (6 ads)
+- technical support — 11 % (6 ads)
+- failure analysis — 9 % (5 ads)
+- optical simulation — 9 % (5 ads)
+- photonic integrated circuit design — 9 % (5 ads)
+- system testing — 9 % (5 ads)
+- optical system design — 7 % (4 ads)
+- optical testing — 7 % (4 ads)
+- process optimization — 7 % (4 ads)
+
+**Top tools:**
+
+- Python — 37 % (21 ads)
+- Matlab — 23 % (13 ads)
+- Lumerical — 21 % (12 ads)
+- KLayout — 11 % (6 ads)
+- COMSOL — 9 % (5 ads)
+- GDSfactory — 7 % (4 ads)
+- HFSS — 7 % (4 ads)
+- JMP — 7 % (4 ads)
+- Labview — 7 % (4 ads)
+- Tidy3D — 7 % (4 ads)
+
+**Seniority:** mid 54 % · senior 21 % · junior 12 % · lead 11 % · n/a 2 %
+
+### 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 |
+|---|---|
+| Photonics Engineer | 4 |
+| Lead Photonics System Engineer | 2 |
+| Optical Engineer | 2 |
+| Senior Photonics Engineer | 2 |
+| Senior Silicon Photonics Design Engineer | 2 |
+| Entry-Level Photonics Test Engineer (RF/Optical) | 1 |
+| Integrated Photonic Test Engineer | 1 |
+| Integrated Photonics Engineer | 1 |
+| Laser Engineer | 1 |
+| Lead Custom Design Engineer – Photonics Systems | 1 |
+| Lead MEMS & Silicon Photonics Engineer | 1 |
+| Lead Photonic Product/Packaging Design Engineer | 1 |
+| Lead Photonic Test & Measurement Engineer | 1 |
+| Lead Silicon Photonics Design Engineer | 1 |
+| On-Site Integrated Photonics Engineer | 1 |
+| Optical Lens Design Engineer | 1 |
+| Photonic Integrated Circuit Engineer | 1 |
+| Photonic Systems & Applications Engineer | 1 |
+| Photonics Characterization Systems Engineer | 1 |
+| Photonics Engineer - Laser & Fiber Systems | 1 |
+| Photonics Engineer I | 1 |
+| Photonics Engineer I: Design, Test & Improve Optical Systems | 1 |
+| Photonics Engineer: Advanced EW & RF Payloads | 1 |
+| Photonics manufacturing engineer-Budd Lake,New Jersey | 1 |
+| Photonics Research Engineer III | 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,35 @@
+# Occupation profile — photonics engineer
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/778c1d37-69f2-4184-ac98-03b7dbfba332
+- **ESCO code:** 2149.12.1
+- **ISCO-08 group:** 2149 — Engineering professionals not elsewhere classified
+- **O*NET-SOC:** 17-3029.08 — Photonics Technicians (match: closeMatch)
+
+## Description (ESCO)
+
+Photonics engineers are concerned with the generation, transmission, transformation, and detection of light. They conduct research, design, assemble, test and deploy photonic components or systems in multiple application fields, from optical communications to medical instrumentation, material processing or sensing technology.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- engineer specialised in photonic systems
+- photonic technology engineering consultant
+- photonic technology engineering specialist
+- photonics engineering expert
+- photonics systems engineer
+- photonic technology engineer
+- engineer in photonic systems
+- photonic engineer
+- electro-optical engineer
+- photonic technology engineering expert
+- engineer in photonics
+- optical systems engineer
+- photonics engineering specialist
+- photonics engineering consultant
+- laser engineer
+- photonics engineering adviser
+- photonic systems test engineer
+- photonic technology engineering adviser
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,126 @@
+# Competences — photonics engineer
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/778c1d37-69f2-4184-ac98-03b7dbfba332).
+
+## 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)
+- **design optical systems** (skill/competence)
+- **develop optical test procedures** (skill/competence)
+- **digital twin technology** (knowledge)
+- **electronics** (knowledge)
+- **engineering principles** (knowledge)
+- **holography** (knowledge)
+- **interact professionally in research and professional environments** (skill/competence)
+- **lasers** (knowledge)
+- **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 data analysis** (skill/competence)
+- **perform project management** (skill/competence)
+- **photonics** (knowledge)
+- **physics** (knowledge)
+- **prepare production prototypes** (skill/competence)
+- **read engineering drawings** (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
+
+- apply blended learning (skill/competence)
+- apply for research funding (skill/competence)
+- apply research ethics and scientific integrity principles in research activities (skill/competence)
+- build business relationships (skill/competence)
+- CAE software (knowledge)
+- communicate with a non-scientific audience (skill/competence)
+- communicate with customers (skill/competence)
+- computational mechanics (knowledge)
+- computational physics (knowledge)
+- conduct research across disciplines (skill/competence)
+- continuum mechanics (knowledge)
+- coordinate engineering teams (skill/competence)
+- create technical plans (skill/competence)
+- define manufacturing quality criteria (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)
+- 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)
+- LED lighting components (knowledge)
+- 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)
+- mathematical modelling (knowledge)
+- medical imaging technology (knowledge)
+- mentor individuals (skill/competence)
+- microoptics (knowledge)
+- MOEM (knowledge)
+- mount optical components on frames (skill/competence)
+- operate optical assembly equipment (skill/competence)
+- optoelectronic devices (knowledge)
+- optoelectronics (knowledge)
+- optomechanical components (knowledge)
+- optomechanical engineering (knowledge)
+- perform resource planning (skill/competence)
+- perform scientific research (skill/competence)
+- perform test run (skill/competence)
+- 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 computing (knowledge)
+- quantum optics (knowledge)
+- quantum technology (knowledge)
+- resolve equipment malfunctions (skill/competence)
+- speak different languages (skill/competence)
+- supercomputing (knowledge)
+- teach in academic or vocational contexts (skill/competence)
+- 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 — **42 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,56 @@
+# Tasks & work activities — photonics engineer
+
+Source: O*NET 30.3, occupation 17-3029.08 (Photonics Technicians).
+
+## Task statements
+
+- **[Core]** Monitor inventory levels and order supplies as necessary.
+- **[Core]** Maintain clean working environments, according to clean room standards.
+- **[Core]** Test or perform failure analysis for optomechanical or optoelectrical products, according to test plans.
+- **[Core]** Assist scientists or engineers in the conduct of photonic experiments.
+- **[Core]** Assist engineers in the development of new products, fixtures, tools, or processes.
+- **[Core]** Set up or operate prototype or test apparatus, such as control consoles, collimators, recording equipment, or cables.
+- **[Core]** Set up or operate assembly or processing equipment, such as lasers, cameras, die bonders, wire bonders, dispensers, reflow ovens, soldering irons, die shears, wire pull testers, temperature or humidity chambers, or optical spectrum analyzers.
+- **[Core]** Adjust or maintain equipment, such as lasers, laser systems, microscopes, oscilloscopes, pulse generators, power meters, beam analyzers, or energy measurement devices.
+- **[Core]** Compute or record photonic test data.
+- **[Core]** Document procedures, such as calibration of optical or fiber optic equipment.
+- **[Core]** Recommend optical or optic equipment design or material changes to reduce costs or processing times.
+- **[Supplemental]** Perform diagnostic analyses of processing steps, using analytical or metrological tools, such as microscopy, profilometry, or ellipsometry devices.
+- **[Supplemental]** Mix, pour, or use processing chemicals or gases according to safety standards or established operating procedures.
+- **[Supplemental]** Design, build, or modify fixtures used to assemble parts.
+- **[Supplemental]** Lay out cutting lines for machining, using drafting tools.
+- **[Supplemental]** Assemble or adjust parts or related electrical units of prototypes to prepare for testing.
+- **[Supplemental]** Splice fibers, using fusion splicing or other techniques.
+- **[Supplemental]** Terminate, cure, polish, or test fiber cables with mechanical connectors.
+- **[Supplemental]** Repair or calibrate products, such as surgical lasers.
+- **[Supplemental]** Fabricate devices, such as optoelectronic or semiconductor devices.
+- **[Supplemental]** Build prototype optomechanical devices for use in equipment such as aerial cameras, gun sights, or telescopes.
+- **[Supplemental]** Assemble fiber optical, optoelectronic, or free-space optics components, subcomponents, assemblies, or subassemblies.
+- **[Supplemental]** Assemble components of energy-efficient optical communications systems involving photonic switches, optical backplanes, or optoelectronic interfaces.
+- **[Supplemental]** Optimize photonic process parameters by making prototype or production devices.
+
+## Detailed work activities
+
+- Analyze operational data to evaluate operations, processes or products.
+- Analyze test or validation data.
+- Assemble equipment or components.
+- Assemble precision electronics or optical equipment.
+- Assist engineers or scientists with research.
+- Calibrate scientific or technical equipment.
+- Conduct quantitative failure analyses of operational data.
+- Create physical models or prototypes.
+- Create schematic drawings for electronics.
+- Design electronic or computer equipment or instrumentation.
+- Develop technical methods or processes.
+- Document design or operational test results.
+- Fabricate devices or components.
+- Install instrumentation or electronic equipment or systems.
+- Maintain clean work areas.
+- Maintain electronic equipment.
+- Maintain inventories of materials, equipment, or products.
+- Operate industrial equipment.
+- Prepare materials for processing.
+- Prepare procedural documents.
+- Purchase materials, equipment, or other resources.
+- Recommend technical design or process changes to improve efficiency, quality, or performance.
+- Test performance of electrical, electronic, mechanical, or integrated systems or equipment.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,37 @@
+# Tools & technology — photonics engineer
+
+Source: O*NET 30.3 'Software Skills' for 17-3029.08.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| 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 |
+| Microsoft Access | Data base user interface and query software | yes |
+| SAP software | Enterprise resource planning ERP software | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Facebook | Web page creation and editing software | yes |
+| Microsoft Word | Word processing software | yes |
+| Data acquisition software | Analytical or scientific software |  |
+| Statistical analysis software | Analytical or scientific software |  |
+| ZEMAX Optical Design Program | Computer aided design CAD software |  |
+| Database software | Data base user interface and query software |  |
+| National Instruments LabVIEW | Development environment software |  |
+| Image processing software | Graphics or photo imaging software |  |
+| Web browser software | Internet browser 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
+
+- Python — **37 %**
+- Matlab — **23 %**
+- Lumerical — **21 %**
+
+<!-- market-evidence -->