feat: gemmologist skill package v0.1.0

2026-08-14 18:25:51 +02:00
commit b4c7a0bfbd
9 changed files with 792 additions and 0 deletions
--- a/PROVENANCE.md
+++ b/PROVENANCE.md
@@ -0,0 +1,31 @@
+# Data provenance — gemmologist
+
+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 — gemmologist
+    "ESCO (occupation & competences)" : 23
+    "O*NET (tasks & tools)" : 50
+    "Job boards (market evidence)" : 59
+    "Anthropic official Claude skills" : 6
+    "External AI skill packs (mapped)" : 131
+```
+
+| Source | Items | Share | Files |
+|---|---|---|---|
+| ESCO (occupation & competences) | 23 | 8.6 % | references/profile.md, references/skills.md |
+| O*NET (tasks & tools) | 50 | 18.6 % | references/tasks.md, references/tools.md |
+| Job boards (market evidence) | 59 | 21.9 % | references/market.md (full report) + "Market evidence" headline sections |
+| Wikipedia & AI expert curation | 0 | 0.0 % | glossary, literature, usecases, intake, quality, evals/ |
+| Anthropic official Claude skills | 6 | 2.2 % | references/ai-skills.md, section "anthropics/skills" (official Claude Code skills) |
+| External AI skill packs (mapped) | 131 | 48.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,55 @@
+---
+name: gemmologist
+description: "Occupational skill for the role 'gemmologist' (also: jewellery gemologist, gemmology researcher, consultant gemologist, consultant gemmologist, gem stone appraiser, gem stone valuer). Use when the user asks for typical gemmologist work such as: Calculate the value of property based on comparisons to recent sales, estimated cost to reproduce, and anticipated property income streams.; Create and maintain a database of completed appraisals.; Determine the appropriate type of valuation to make, such as fair market, replacement, or liquidation, based on the needs of the property owner."
+---
+
+# Gemmologist
+
+Gemmologists value precious stones by analysing their characteristics, cut, and provenience either for trading or for further polishing efforts. They assess stones and gems to give them a market value.
+
+## Core workflow
+
+1. Calculate the value of property based on comparisons to recent sales, estimated cost to reproduce, and anticipated property income streams.
+2. Create and maintain a database of completed appraisals.
+3. Determine the appropriate type of valuation to make, such as fair market, replacement, or liquidation, based on the needs of the property owner.
+4. Document physical characteristics of property such as measurements, quality, and design.
+5. Forecast the value of property.
+6. Inspect personal or business property.
+7. Locate and record data on sales of comparable property using specialized software, internet searches, or personal records.
+8. Take photographs of property.
+
+## 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)
+
+- appraise gemstones
+- calculate value of gems
+- examine gems
+- gemology
+- gemstone grading systems
+- gemstones
+- immerse gemstones in chemical liquid
+- operate microscope
+- recognise fake goods
+- use gemstone identification equipment
+- write gemstone grading report
+
+## Hot technologies
+
+- Microsoft Access
+- Yardi software
+- Microsoft Outlook
+- Microsoft Office software
+- Microsoft Windows
+- Microsoft PowerPoint
+- Microsoft Excel
+- Microsoft Word
+
+---
+*Sources: ESCO v1.2.1 (http://data.europa.eu/esco/occupation/f87779ae-7389-44e7-b155-16e87904857e), O*NET 30.3 (13-2022.00). See manifest.json for licensing/attribution.*
--- a/manifest.json
+++ b/manifest.json
@@ -0,0 +1,184 @@
+{
+  "name": "gemmologist",
+  "title": "gemmologist",
+  "version": "0.1.0",
+  "layer": "core",
+  "language": "en",
+  "generated": "2026-07-07",
+  "ids": {
+    "esco_uri": "http://data.europa.eu/esco/occupation/f87779ae-7389-44e7-b155-16e87904857e",
+    "esco_code": "3315.2",
+    "isco_group": "3315",
+    "onet_soc": "13-2022.00",
+    "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": 14,
+    "dwas": 16,
+    "skills_essential": 11,
+    "skills_optional": 11,
+    "software": 19
+  },
+  "enrichment_ai_skills": {
+    "generated": "2026-07-14",
+    "method": "deterministic mapping (ISCO prefix + title/competence keywords)",
+    "sources": {
+      "anthropics/skills": {
+        "repo": "https://github.com/anthropics/skills",
+        "commit": "f6656c1",
+        "license": "Apache-2.0; the document skills (docx/pdf/pptx/xlsx) are source-available \u2014 see the LICENSE.txt in the upstream skill folder",
+        "skills": 3
+      },
+      "NVIDIA/skills": {
+        "repo": "https://github.com/NVIDIA/skills",
+        "commit": "153b14b",
+        "license": "CC-BY-4.0 (skills/docs), Apache-2.0 (code)",
+        "skills": 12
+      },
+      "google/skills": {
+        "repo": "https://github.com/google/skills",
+        "commit": "b15f327",
+        "license": "Apache-2.0",
+        "skills": 12
+      },
+      "phuryn/pm-skills": {
+        "repo": "https://github.com/phuryn/pm-skills",
+        "commit": "18468a9",
+        "license": "MIT",
+        "skills": 9
+      },
+      "nWave-ai/nWave": {
+        "repo": "https://github.com/nWave-ai/nWave",
+        "commit": "1d0f13c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "foryourhealth111-pixel/Vibe-Skills": {
+        "repo": "https://github.com/foryourhealth111-pixel/Vibe-Skills",
+        "commit": "34429a8",
+        "license": "Apache-2.0",
+        "skills": 8
+      },
+      "davila7/claude-code-templates": {
+        "repo": "https://github.com/davila7/claude-code-templates",
+        "commit": "fa79251",
+        "license": "MIT",
+        "skills": 5
+      },
+      "K-Dense-AI/claude-scientific-skills": {
+        "repo": "https://github.com/K-Dense-AI/claude-scientific-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 5
+      },
+      "K-Dense-AI/scientific-agent-skills": {
+        "repo": "https://github.com/K-Dense-AI/scientific-agent-skills",
+        "commit": "4d97e29",
+        "license": "MIT",
+        "skills": 5
+      },
+      "brycewang-stanford/Auto-Empirical-Research-Skills": {
+        "repo": "https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills",
+        "commit": "85bf545",
+        "license": "CC-BY-4.0",
+        "skills": 9
+      },
+      "FlorianBruniaux/claude-code-ultimate-guide": {
+        "repo": "https://github.com/FlorianBruniaux/claude-code-ultimate-guide",
+        "commit": "5395214",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "jeremylongshore/claude-code-plugins-plus-skills": {
+        "repo": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills",
+        "commit": "e112938a",
+        "license": "MIT",
+        "skills": 2
+      },
+      "alirezarezvani/claude-skills": {
+        "repo": "https://github.com/alirezarezvani/claude-skills",
+        "commit": "0241f43",
+        "license": "MIT",
+        "skills": 1
+      },
+      "ognjengt/founder-skills": {
+        "repo": "https://github.com/ognjengt/founder-skills",
+        "commit": "a45931c",
+        "license": "MIT",
+        "skills": 1
+      },
+      "sanjay3290/ai-skills": {
+        "repo": "https://github.com/sanjay3290/ai-skills",
+        "commit": "3619692",
+        "license": "Apache-2.0",
+        "skills": 1
+      },
+      "a5c-ai/babysitter": {
+        "repo": "https://github.com/a5c-ai/babysitter",
+        "commit": "44a5d58b",
+        "license": "MIT",
+        "skills": 2
+      },
+      "claude-world/director-mode-lite": {
+        "repo": "https://github.com/claude-world/director-mode-lite",
+        "commit": "9d0c333",
+        "license": "MIT",
+        "skills": 1
+      },
+      "basicmachines-co/basic-memory": {
+        "repo": "https://github.com/basicmachines-co/basic-memory",
+        "commit": "53da71c",
+        "license": "custom (see upstream LICENSE)",
+        "skills": 1
+      },
+      "affaan-m/everything-claude-code": {
+        "repo": "https://github.com/affaan-m/everything-claude-code",
+        "commit": "ed38744",
+        "license": "MIT",
+        "skills": 1
+      }
+    },
+    "total_skills": 80,
+    "tiers": {
+      "core": 53,
+      "adjacent": 27
+    }
+  },
+  "provenance": {
+    "items": {
+      "esco": 23,
+      "onet": 50,
+      "jobads": 59,
+      "wiki_ai": 0,
+      "anthropic": 6,
+      "ai_skills": 131,
+      "stackx": 0
+    },
+    "share_percent": {
+      "esco": 8.6,
+      "onet": 18.6,
+      "jobads": 21.9,
+      "wiki_ai": 0.0,
+      "anthropic": 2.2,
+      "ai_skills": 48.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,250 @@
+# External AI agent skills — gemmologist
+
+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 |
+|---|---|---|---|
+| `xlsx` | adjacent | Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, … | [source](https://github.com/anthropics/skills/tree/main/skills/xlsx) |
+| `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 |
+|---|---|---|---|
+| `extractables-leachables-analyzer` | core | E&L study design and data analysis skill for chemical characterization of medical devices | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/biomedical-engineering/skills/extractables-leachables-analyzer) |
+| `queuing-analyzer` | core | Queuing theory analysis skill for analytical evaluation of waiting line systems. | [source](https://github.com/a5c-ai/babysitter/tree/44a5d58b/library/specializations/domains/science/industrial-engineering/skills/queuing-analyzer) |
+
+## Source: affaan-m/everything-claude-code
+
+- Repository: [https://github.com/affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) (commit `ed38744`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `prediction-market-oracle-research` | core | Research prediction markets as data sources or oracle signals for products, agents, dashboards, and corporate decision intelligence. Use for source-grounded analysis of market-implied probabilities, caveats, and integration patterns … | [source](https://github.com/affaan-m/everything-claude-code/tree/ed38744/skills/prediction-market-oracle-research) |
+
+## Source: alirezarezvani/claude-skills
+
+- Repository: [https://github.com/alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills) (commit `0241f43`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `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 |
+|---|---|---|---|
+| `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) |
+| `hud` | core | Diverga HUD (Heads-Up Display) management skill. Configure and manage the research project statusline display. Supports multiple presets: research, checkpoint, memory, minimal. Triggers: "hud", "statusline", "display settings | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/25-HosungYou-Diverga/skills/hud) |
+| `seismology-data-guide` | core | Earthquake data analysis, seismogram processing, and seismic research | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/geoscience/seismology-data-guide) |
+| `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) |
+| `climate-science-guide` | core | Climate data analysis, modeling workflows, and carbon neutrality research met... | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/geoscience/climate-science-guide) |
+| `data-scientist` | core | Data science methodology for Python research: EDA, validation, causal inference (IV, DiD, RD, synthetic control), clustering/PCA/UMAP, supervised ML, geospatial, visualization. Method selection guidance. For syntax, load tool-specific … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/17-DAAF-Contribution-Community-daaf/dot-claude/skills/data-scientist) |
+| `econometrics-r` | core | R-based econometric analysis for academic research. Use when writing R code for panel data, difference-in-differences, instrumental variables, spatial econometrics, or regression analysis. Covers data.table, fixest, sf, modelsummary, and … | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/14-luischanci-claude-code-research-starter/dot-claude/skills/econometrics-r) |
+| `econometrics-skills` | core | 12 econometrics skills. Trigger: causal analysis, regression models, treatment effects, panel data. Design: method-centric guides with R/Python code and diagnostic tests. | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/analysis/econometrics) |
+| `linear-algebra-applications` | core | Apply linear algebra concepts to research computing and data analysis | [source](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/85bf545/skills/43-wentorai-research-plugins/skills/domains/math/linear-algebra-applications) |
+
+## 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: 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 |
+|---|---|---|---|
+| `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) |
+| `latex-posters` | core | Create professional research posters in LaTeX using beamerposter, tikzposter, or baposter. Support for conference presentations, academic posters, and scientific communication. Includes layout design, color schemes, multi-column formats, … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/latex-posters) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/scientific/scientific-slides) |
+| `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) |
+| `senior-data-scientist` | core | World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics. Expertise in Python (NumPy, Pandas, Scikit-learn), R, SQL, statistical methods, A/B testing, time series, and business … | [source](https://github.com/davila7/claude-code-templates/tree/fa79251/cli-tool/components/skills/development/senior-data-scientist) |
+
+## Source: FlorianBruniaux/claude-code-ultimate-guide
+
+- Repository: [https://github.com/FlorianBruniaux/claude-code-ultimate-guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide) (commit `5395214`, retrieved 2026-07-14)
+- License: custom (see upstream LICENSE)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `plan-pipeline-start` | core | 5-phase planning: PRD analysis, design review, technical decisions, dynamic research team, metrics. Produces a complete implementation plan + ADRs before any code is written. | [source](https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/5395214/examples/skills/plan-pipeline/start) |
+
+## Source: 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 |
+|---|---|---|---|
+| `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/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/fda-database) |
+| `scientific-reporting` | core | Write research/technical reports with strong structure + figure standards. Supports Markdown/HTML/PDF outputs (Quarto optional), executive summary, methods, results, discussion, and reproducibility appendix. | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-reporting) |
+| `scientific-slides` | core | Build slide decks and presentations for research talks. Use this for making PowerPoint slides, conference presentations, seminar talks, research presentations, thesis defense slides, or any scientific talk. Provides slide structure, design … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/scientific-slides) |
+| `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) |
+| `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) |
+| `matlab` | core | MATLAB and GNU Octave numerical computing for matrix operations, data analysis, visualization, and scientific computing. Use when writing MATLAB/Octave scripts for linear algebra, signal processing, image processing, differential … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/matlab) |
+| `senior-data-scientist` | core | World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics. Expertise in Python (NumPy, Pandas, Scikit-learn), R, SQL, statistical methods, A/B testing, time series, and business … | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/senior-data-scientist) |
+| `slides-as-code` | core | Build research slides with text-first source (Slidev/Marp/Reveal/Quarto) and reproducible export (PDF). Includes structure, figure reuse rules, and quality checklist for top-tier scientific presentations. | [source](https://github.com/foryourhealth111-pixel/Vibe-Skills/tree/34429a8/bundled/skills/slides-as-code) |
+
+## 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) |
+| `profiling-application-performance` | core | Execute this skill enables AI assistant to profile application performance, analyzing cpu usage, memory consumption, and execution time. it is triggered when the user requests performance analysis, bottleneck identification, or … | [source](https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/e112938a/plugins/performance/application-profiler/skills/profiling-application-performance) |
+
+## 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 |
+|---|---|---|---|
+| `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) |
+| `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) |
+| `astropy` | core | Core Python library for astronomy and astrophysics workflows that need Astropy APIs, including units/quantities, coordinates, FITS I/O, tables, time systems, WCS, and cosmology. Use when implementing or debugging astronomical data analysis … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/astropy) |
+| `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) |
+| `matlab` | core | MATLAB and GNU Octave numerical computing for matrix operations, data analysis, visualization, and scientific computing. Use when writing MATLAB/Octave scripts for linear algebra, signal processing, image processing, differential … | [source](https://github.com/K-Dense-AI/claude-scientific-skills/tree/4d97e29/skills/matlab) |
+
+## 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 |
+|---|---|---|---|
+| `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) |
+| `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) |
+| `astropy` | core | Core Python library for astronomy and astrophysics workflows that need Astropy APIs, including units/quantities, coordinates, FITS I/O, tables, time systems, WCS, and cosmology. Use when implementing or debugging astronomical data analysis … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/astropy) |
+| `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) |
+| `matlab` | core | MATLAB and GNU Octave numerical computing for matrix operations, data analysis, visualization, and scientific computing. Use when writing MATLAB/Octave scripts for linear algebra, signal processing, image processing, differential … | [source](https://github.com/K-Dense-AI/scientific-agent-skills/tree/4d97e29/skills/matlab) |
+
+## 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-diverge` | core | Generates 3-5 divergent design directions through JTBD analysis, competitive research, structured brainstorming, and taste evaluation before convergence. Use when the team has a validated problem but hasn't chosen a solution approach. | [source](https://github.com/nWave-ai/nWave/tree/1d0f13c/nWave/skills/nw-diverge) |
+
+## Source: ognjengt/founder-skills
+
+- Repository: [https://github.com/ognjengt/founder-skills](https://github.com/ognjengt/founder-skills) (commit `a45931c`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `competitor-intel` | core | Analyzes competitors using web research to provide verified business metrics, actionable leverage strategies, and predicted next moves. Use when user needs competitive intelligence, competitor analysis, market positioning insights, or … | [source](https://github.com/ognjengt/founder-skills/tree/a45931c/skills/competitor-intel) |
+
+## Source: 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: google/skills
+
+- Repository: [https://github.com/google/skills](https://github.com/google/skills) (commit `b15f327`, retrieved 2026-07-14)
+- License: Apache-2.0
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `bigquery-basics` | core | Manages datasets, tables, and jobs in BigQuery. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resources (datasets, tables, views), or perform basic data ingestion and analysis. | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigquery-basics) |
+| `bigtable-basics` | core | Assists in provisioning instances/tables, designing performant schemas, and querying data in Bigtable. Use when designing Bigtable row keys, configuring column families, writing SQL queries or client library code (Java, Go, Python) for … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigtable-basics) |
+| `datalineage-bigquery-asset-impact-analysis` | core | Analyzes the downstream impact (blast radius) when a BigQuery table or view is broken, stale, or modified. Identifies all downstream tables, dashboards, and processes that will be affected. Use when: - Performing a blast radius or impact … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/datalineage-bigquery-asset-impact-analysis) |
+| `gke-observability` | core | Configures GKE observability, including Cloud Logging, Cloud Monitoring, and managed Prometheus. Use when configuring GKE monitoring, setting up GKE logging, or configuring Prometheus metrics collection. Don't use to configure local … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/gke-observability) |
+| `bigquery-ai-ml` | adjacent | Leverages BigQuery's built-in machine learning and GenAI capabilities for advanced data analytics. Use when you need to write SQL queries that perform time-series forecasting, detect outliers, find key drivers, or leverage generative AI … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/bigquery-ai-ml) |
+| `agent-platform-alert-configuration` | adjacent | Configures best-practice alerting policies for Google Cloud Vertex AI / Agent Platform agents on Agent Runtime. Use when analyzing, writing, or deploying alerting policies to monitor agent latency, error rates, and quality metrics … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/agent-platform-alert-configuration) |
+| `agent-platform-eval-flywheel` | adjacent | Measures and improves the quality of AI models and agents on Google Cloud using the Eval Quality Flywheel methodology. Use when evaluating an agent or model, building an eval dataset, picking or writing evaluation metrics, analyzing … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/agent-platform-eval-flywheel) |
+| `alloydb-basics` | adjacent | Manages clusters, instances, and backups for AlloyDB for PostgreSQL, and integrates with AlloyDB model context protocol (MCP) tools for automated database operations. | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/alloydb-basics) |
+| `cloud-sql-basics` | adjacent | This file generates or explains Cloud SQL resources. Use this file when the user asks to create a Cloud SQL instance or database for MySQL, PostgreSQL, or SQL Server. Cloud SQL manages third-party MySQL, PostgreSQL, and SQL Server … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/cloud-sql-basics) |
+| `google-analytics-admin-api-basics` | adjacent | Manages Google Analytics account and property settings, enables the Analytics Admin API via the Cloud CLI, lists accounts and properties, and manages data streams, custom dimensions, conversion events, and integrations. Use when you need … | [source](https://github.com/google/skills/tree/b15f327/skills/analytics/google-analytics-admin-api-basics) |
+| `google-analytics-data-api-basics` | adjacent | Manages Google Analytics reporting data, enables the Analytics Data API via the Cloud CLI, and creates reports using the Google Analytics Data API (v1beta). Use when you need to interact with Google Analytics properties, run customized … | [source](https://github.com/google/skills/tree/b15f327/skills/analytics/google-analytics-data-api-basics) |
+| `google-cloud-networking-observability` | adjacent | Investigates Google Cloud networking issues by analyzing logs, metrics, and diagnostics. Use when investigating VPC Flow Logs (including cost estimation), NAT, firewall, or threat logs, querying latency and throughput metrics, or running … | [source](https://github.com/google/skills/tree/b15f327/skills/cloud/google-cloud-networking-observability) |
+
+## Source: NVIDIA/skills
+
+- Repository: [https://github.com/NVIDIA/skills](https://github.com/NVIDIA/skills) (commit `153b14b`, retrieved 2026-07-14)
+- License: CC-BY-4.0 (skills/docs), Apache-2.0 (code)
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `vss-generate-video-report` | core | Use this skill when producing a VSS analysis report — Mode A per-clip VLM, Mode B incident-range via video-analytics. Not for standalone video summarization, real-time alerts or ad-hoc Q&A. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-generate-video-report) |
+| `deepstream-dev` | core | NVIDIA DeepStream SDK 9.0 development with Python pyservicemaker API. Use when building video analytics pipelines, GStreamer-based video processing, TensorRT inference integration, object detection/tracking, or Kafka/message broker … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/deepstream-dev) |
+| `tao-train-reid` | adjacent | Person re-identification (ReID). Learns discriminative embeddings to match the same person across different camera views, based on metric learning. Use when training, evaluating, exporting, or running inference for a TAO person … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-reid) |
+| `vss-generate-video-calibration` | adjacent | Use to run AutoMagicCalib on local MP4s, RTSP, or the bundled sample dataset, and to deploy vss-auto-calibration when needed. Do not use for non-AMC calibration or runtime analytics. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-generate-video-calibration) |
+| `vss-manage-alerts` | adjacent | Use for VSS alert workflows — real-time monitoring, Alert-Bridge subscriptions, Slack notifications, incident queries, camera onboarding. Not for non-alert analytics. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-manage-alerts) |
+| `nemo-evaluator-plugin` | adjacent | Use when working on the Evaluator plugin CLI, jobs, SDK-backed specs, metric types, or plugin-owned Evaluator skills. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/nemo-evaluator-plugin) |
+| `nv-reason-cxr` | adjacent | Used for command-shape or live NV-Reason-CXR chest X-ray reasoning smoke tests. Not for diagnosis or clinical reporting. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/nv-reason-cxr) |
+| `tao-train-depth-anything-v2` | adjacent | Monocular depth estimation using Metric Depth Anything v2 or Relative Depth Anything architectures. Predicts per-pixel depth from single RGB images. Use when training, evaluating, exporting, or running inference for a TAO monocular depth … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-depth-anything-v2) |
+| `tao-train-metric-learning-recognition` | adjacent | Metric-learning recognition (ml-recog) for fine-grained visual recognition. Learns embeddings for retrieval-based matching (e.g., retail product recognition) using triplet / contrastive losses. Use when training, evaluating, exporting, or … | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/tao-train-metric-learning-recognition) |
+| `vss-query-analytics` | adjacent | Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-query-analytics) |
+| `vss-setup-behavior-analytics` | adjacent | Use to deploy the vss-behavior-analytics service standalone (entrypoint, config-source, optional calibration). Not for the full warehouse deploy. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-setup-behavior-analytics) |
+| `vss-setup-video-analytics-api` | adjacent | Use to deploy the vss-video-analytics-api REST service standalone (config-source, data-log bind, Elasticsearch, optional Kafka). Not for full warehouse deploy. | [source](https://github.com/NVIDIA/skills/tree/153b14b/skills/vss-setup-video-analytics-api) |
+
+## Source: phuryn/pm-skills
+
+- Repository: [https://github.com/phuryn/pm-skills](https://github.com/phuryn/pm-skills) (commit `18468a9`, retrieved 2026-07-14)
+- License: MIT
+
+| Skill | Tier | What it adds | Upstream |
+|---|---|---|---|
+| `ab-test-analysis` | core | Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/ab-test-analysis) |
+| `dummy-dataset` | core | Generate realistic dummy datasets for testing with customizable columns, constraints, and output formats (CSV, JSON, SQL, Python script). Use when creating test data, building mock datasets, or generating sample data for development and … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-execution/skills/dummy-dataset) |
+| `cohort-analysis` | core | Perform cohort analysis on user engagement data — retention curves, feature adoption trends, and segment-level insights. Use when analyzing user retention by cohort, studying feature adoption over time, investigating churn patterns, or … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/cohort-analysis) |
+| `lean-canvas` | adjacent | Generate a Lean Canvas with problem, solution, metrics, cost structure, UVP, unfair advantage, channels, segments, and revenue. Use when exploring a lean startup canvas, testing a business hypothesis, or modeling a new venture. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-strategy/skills/lean-canvas) |
+| `metrics-dashboard` | adjacent | Define and design a product metrics dashboard with key metrics, data sources, visualization types, and alert thresholds. Use when creating a metrics dashboard, defining KPIs, setting up product analytics, or building a data monitoring plan. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-discovery/skills/metrics-dashboard) |
+| `product-strategy` | adjacent | Create a comprehensive product strategy using the 9-section Product Strategy Canvas — vision, segments, costs, value propositions, trade-offs, metrics, growth, capabilities, and defensibility. Use when building a product strategy, creating … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-product-strategy/skills/product-strategy) |
+| `gtm-strategy` | adjacent | Create a go-to-market strategy covering marketing channels, messaging, success metrics, and launch timeline. Use when planning a product launch, creating a GTM plan from scratch, or defining a launch strategy for a new market. | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-go-to-market/skills/gtm-strategy) |
+| `north-star-metric` | adjacent | Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation. Classify the business game (Attention, Transaction, Productivity) and validate against 7 criteria for an effective North Star. Use when choosing … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-marketing-growth/skills/north-star-metric) |
+| `sql-queries` | adjacent | Generate SQL queries from natural language descriptions. Supports BigQuery, PostgreSQL, MySQL, and other dialects. Reads database schemas from uploaded diagrams or documentation. Use when writing SQL, building data reports, exploring … | [source](https://github.com/phuryn/pm-skills/tree/18468a9/pm-data-analytics/skills/sql-queries) |
--- a/references/market.md
+++ b/references/market.md
@@ -0,0 +1,62 @@
+# Market evidence report — gemmologist
+
+Source: **5 real job ads** (JSearch API, countries: us 5), extracted into the MSSQL evidence store; as of 2026-07-12.
+This report contains extracted, aggregated facts only — no ad text is
+reproduced (copyright / platform terms).
+
+## Seniority distribution
+
+| Seniority | Ads | Share |
+|---|---|---|
+| junior | 2 | 40 % |
+| mid | 2 | 40 % |
+| n/a | 1 | 20 % |
+
+## Tools — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Hard skills — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Methods — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Responsibilities — full market ranking
+
+| # | Item | Ads | Share |
+|---|---|---|---|
+
+## Regional breakdown
+
+> **Corpus note:** 5 relevant ads in total — below the 100-ad target for a fully reliable ranking. Percentages above should be read as indicative.
+
+### US (us)
+
+**Insufficient evidence** — 5 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### UK (gb)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+### EU/DACH (de, at, ch, nl)
+
+**Insufficient evidence** — 0 ads (minimum for a regional ranking: 30). No ranking is reported for this region.
+
+
+## Job title variants in the market
+
+| Title | Ads |
+|---|---|
+| Gemology Postdoctoral Research Fellow | 1 |
+| Gemology Research Intern - Hands-On Lab & Data | 1 |
+| Gemology Research Intern: Hands-On Lab & Data | 1 |
+| Research Scientist at Gemological Institute of America Secaucus, NJ | 1 |
+| Staff Gemologist (Colored Diamonds) | 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,42 @@
+# Occupation profile — gemmologist
+
+- **ESCO URI:** http://data.europa.eu/esco/occupation/f87779ae-7389-44e7-b155-16e87904857e
+- **ESCO code:** 3315.2
+- **ISCO-08 group:** 3315 — Valuers and loss assessors
+- **O*NET-SOC:** 13-2022.00 — Appraisers of Personal and Business Property (match: closeMatch)
+
+## Description (ESCO)
+
+Gemmologists value precious stones by analysing their characteristics, cut, and provenience either for trading or for further polishing efforts. They assess stones and gems to give them a market value.
+
+## Definition
+
+nan
+
+## Alternative labels
+
+- jewellery gemologist
+- gemmology researcher
+- consultant gemologist
+- consultant gemmologist
+- gem stone appraiser
+- gem stone valuer
+- jewellery gemmologist
+- mining gemologist
+- gemmology scientist
+- gemstone appraiser
+- mineral gemmologist
+- stone buyer
+- gemmology research analyst
+- gemologist
+- gemstone buyer
+- mining gemmologist
+- gemmology science researcher
+- mineral gemologist
+- gemmology scholar
+- gemstone assessor
+- gemmology research scientist
+- gem stone assessor
+- gem stone buyer
+- gemstone valuer
+- gemmology analyst
--- a/references/skills.md
+++ b/references/skills.md
@@ -0,0 +1,88 @@
+# Competences — gemmologist
+
+Source: ESCO v1.2.1 occupation-skill relations (http://data.europa.eu/esco/occupation/f87779ae-7389-44e7-b155-16e87904857e).
+
+## Essential
+
+- **appraise gemstones** (skill/competence)
+- **calculate value of gems** (skill/competence)
+- **examine gems** (skill/competence)
+- **gemology** (knowledge)
+- **gemstone grading systems** (knowledge)
+- **gemstones** (knowledge)
+- **immerse gemstones in chemical liquid** (skill/competence)
+- **operate microscope** (skill/competence)
+- **recognise fake goods** (skill/competence)
+- **use gemstone identification equipment** (skill/competence)
+- **write gemstone grading report** (skill/competence)
+
+## Optional
+
+- advise customers on jewellery and watches (skill/competence)
+- alloys of precious metals (knowledge)
+- chemistry (knowledge)
+- conduct jewellery market research (skill/competence)
+- cut gem stones (skill/competence)
+- determine origin of gemstones (skill/competence)
+- develop jewellery designs (skill/competence)
+- model mineral deposits (skill/competence)
+- polish gemstones (skill/competence)
+- precious metals (knowledge)
+- trade in jewellery (skill/competence)
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 5 ads, as of 2026-07-12)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Hard skills
+
+- data analysis — **40 %**
+- data collection — **40 %**
+- analytical chemistry — **20 %**
+- experiment design — **20 %**
+- gem identification — **20 %**
+- gemological investigation — **20 %**
+- gemological research — **20 %**
+- gemological testing — **20 %**
+- gemstone geology — **20 %**
+- laboratory research — **20 %**
+- laser processing — **20 %**
+- laser technology — **20 %**
+- optical instrumentation design — **20 %**
+- problem solving — **20 %**
+- project management — **20 %**
+- sample preparation — **20 %**
+- scientific research — **20 %**
+- solid state physics — **20 %**
+- spectroscopy — **20 %**
+
+### Methods
+
+- time-resolved optical methods — **20 %**
+- adaptive optics — **20 %**
+
+### Responsibilities
+
+- data collection — **40 %**
+- data entry — **20 %**
+- gem characteristic documentation — **20 %**
+- assisting researchers — **20 %**
+- independent research — **20 %**
+- instrument development — **20 %**
+- instrument prototyping — **20 %**
+- measurement technique validation — **20 %**
+- patent filing — **20 %**
+- presentation support — **20 %**
+- project oversight — **20 %**
+- report generation — **20 %**
+- report support — **20 %**
+- research experimentation — **20 %**
+- research on colored gemstones — **20 %**
+- research project execution — **20 %**
+- research proposal development — **20 %**
+- training new staff — **20 %**
+- technical support — **20 %**
+
+<!-- market-evidence -->
--- a/references/tasks.md
+++ b/references/tasks.md
@@ -0,0 +1,39 @@
+# Tasks & work activities — gemmologist
+
+Source: O*NET 30.3, occupation 13-2022.00 (Appraisers of Personal and Business Property).
+
+## Task statements
+
+- **[Core]** Calculate the value of property based on comparisons to recent sales, estimated cost to reproduce, and anticipated property income streams.
+- **[Core]** Create and maintain a database of completed appraisals.
+- **[Core]** Determine the appropriate type of valuation to make, such as fair market, replacement, or liquidation, based on the needs of the property owner.
+- **[Core]** Document physical characteristics of property such as measurements, quality, and design.
+- **[Core]** Forecast the value of property.
+- **[Core]** Inspect personal or business property.
+- **[Core]** Locate and record data on sales of comparable property using specialized software, internet searches, or personal records.
+- **[Core]** Take photographs of property.
+- **[Core]** Testify in court as to the value of a piece of tangible property.
+- **[Core]** Update appraisals when property has been improved, damaged, or has otherwise changed.
+- **[Core]** Verify that property matches legal descriptions or certifications.
+- **[Core]** Write and submit appraisal reports for property, such as jewelry, art, antiques, collectibles, and equipment.
+- **[Core]** Write descriptions of the property being appraised.
+- **[Supplemental]** Recommend loan amounts based on the value of property being used as collateral.
+
+## Detailed work activities
+
+- Appraise property values.
+- Compile data or documentation.
+- Create databases to store electronic data.
+- Determine operational procedures.
+- Enter information into databases or software programs.
+- Forecast economic, political, or social trends.
+- Gather information in order to provide services to clients.
+- Implement financial decisions.
+- Inspect items for damage or defects.
+- Maintain data in information systems or databases.
+- Record images needed to address work issues.
+- Testify at legal or legislative proceedings.
+- Update computer database information.
+- Verify information or specifications.
+- Write informational material.
+- Write reports or evaluations.
--- a/references/tools.md
+++ b/references/tools.md
@@ -0,0 +1,41 @@
+# Tools & technology — gemmologist
+
+Source: O*NET 30.3 'Software Skills' for 13-2022.00.
+
+| Software | Category | Hot technology |
+|---|---|---|
+| Microsoft Access | Data base user interface and query software | yes |
+| Yardi software | Data base user interface and query software | yes |
+| Microsoft Outlook | Electronic mail software | yes |
+| Microsoft Office software | Office suite software | yes |
+| Microsoft Windows | Operating system software | yes |
+| Microsoft PowerPoint | Presentation software | yes |
+| Microsoft Excel | Spreadsheet software | yes |
+| Microsoft Word | Word processing software | yes |
+| Computer assisted mass appraisal CAMA software | Analytical or scientific software |  |
+| Mass appraisal records system MARS | Analytical or scientific software |  |
+| Wilson's Computer Applications RealEasy Appraisals | Analytical or scientific software |  |
+| WinEstimator WinEst | Analytical or scientific software |  |
+| WinGap | Analytical or scientific software |  |
+| Ascend Property Assessment | Data base user interface and query software |  |
+| Bruno Realty eNeighboorhoods | Data base user interface and query software |  |
+| Cost estimating software | Financial analysis software |  |
+| CPR Visual Estimator | Financial analysis software |  |
+| HP 49G+ Appraiser Fee Calculator | Financial analysis software |  |
+| Web browser software | Internet browser software |  |
+
+<!-- market-evidence -->
+
+## Market evidence (job-ad analysis, 5 ads, as of 2026-07-12)
+
+Share of analyzed job ads mentioning the item (threshold ≥ 20 %). Source: JSearch/Adzuna APIs.
+
+### Tools
+
+- ultrafast laser systems — **20 %**
+- Python — **20 %**
+- Mathematica — **20 %**
+- MATLAB — **20 %**
+- C++ — **20 %**
+
+<!-- market-evidence -->