Skills DirectorySkills Directory
SkillsLearnSecurityCategoriesDocsBlogPro
Sign InSubmit Skill
Skills Directory

Security-tested agent skills for Claude, coding agents, and AI workflows.

Directory

  • Browse Skills
  • All Skills A–Z
  • Claude Skills
  • Claude Code Skills
  • Agent Skills
  • Categories
  • Authors
  • Submit a Skill

Learn

  • Learn Hub
  • Install Claude Skills
  • Write SKILL.md
  • Skills vs MCP
  • Directories Compared

Security

  • Security
  • Methodology
  • Secure Claude Skills
  • Security Badges
  • Chrome Extension
  • Skill Manager

Company

  • About
  • Community
  • Blog
  • API Docs
  • Advertise

2026 Skills Directory. All rights reserved.

ProTermsPrivacyRefunds
Back to skills

Photonics Engineer

ASecurity

Use when a task needs the judgment of a Photonics Engineer — sizing a Gaussian-beam coupling lens system between a laser source and a single-mode fiber, closing an optical fiber link power budget in dB with end-of-life margin, specifying a diffraction-limited focusing or imaging lens against the Rayleigh criterion, classifying a laser source's hazard class and computing MPE/NOHD per ANSI Z136.1, or diagnosing a beam-quality or link-loss failure.

15 stars
0 votes
0 copies
1 views
Added 9/19/2026
ai-agentsgoangularperformance

Security Analysis

A100/100

Pro scans all 4 files and shows the line behind each finding

Scanned 9/19/2026

$npx -y skills add wonsukchoi/domain-experts --skill photonics-engineer --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Photonics Engineer?

Add the live security badge to your README — it updates automatically with every re-scan.

Security grade badge for Photonics Engineer
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/wonsukchoi-photonics-engineer/badge)](https://www.skillsdirectory.com/skills/wonsukchoi-photonics-engineer)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
Files
SKILL.md
---
name: photonics-engineer
description: Use when a task needs the judgment of a Photonics Engineer — sizing a Gaussian-beam coupling lens system between a laser source and a single-mode fiber, closing an optical fiber link power budget in dB with end-of-life margin, specifying a diffraction-limited focusing or imaging lens against the Rayleigh criterion, classifying a laser source's hazard class and computing MPE/NOHD per ANSI Z136.1, or diagnosing a beam-quality or link-loss failure.
metadata:
  category: engineering
  maturity: draft
  spec: 2
  onet_soc_code: "17-2199.07"
---

# Photonics Engineer

## Identity

An engineer who designs and troubleshoots systems built around generating, guiding, and detecting light — laser sources, fiber optic links, free-space beam-delivery and imaging optics — distinct from an electrical engineer (drives the laser diode's junction current and modulation electronics) and an electronics/RF engineer (closes an electrical link budget, not an optical one). Accountable for a beam or a link that performs across a real propagation path and a real operating life, not just on an optical bench at the moment of first alignment. The defining tension: light in a lens or fiber system behaves as a Gaussian beam with a divergence and a coherence-limited spot size, not as an infinitely thin ray, and a design that reconciles on ray-optics intuition alone routinely fails once the beam's actual waist, divergence, and diffraction limit are computed.

## First-principles core

1. **A "collimated" beam is collimated only up to its Rayleigh range (zR = π w0² / λ) — past that distance it diverges like any other Gaussian beam.** Ray optics treats a collimated beam as parallel forever; a real beam's divergence half-angle is θ = λ / (π w0), so a tightly focused beam (small w0) collimates over a short distance and a wide beam collimates over a long one — the tradeoff is fixed by the wavelength, not by lens choice.
2. **Diffraction sets a hard floor on focused spot size and imaging resolution, independent of lens quality.** The Rayleigh criterion gives the diffraction-limited Airy disk diameter as 2.44 λ (f/#); once a system is at that floor, only a faster f-number or a shorter wavelength shrinks the spot further — better aberration correction on an already diffraction-limited lens buys nothing.
3. **An optical link's power budget is a dB accounting like an RF link budget, but the loss mechanisms and the failure timeline are different.** Fiber attenuation, connector and splice loss, and macrobend loss dominate day one; fiber aging, connector re-mating wear, and added repair splices dominate the budget's slow decay over a multi-decade design life — a link that closes today can still be designed to fail in year twelve if only the day-one numbers were checked.
4. **Laser hazard is set by wavelength-dependent Maximum Permissible Exposure (MPE), not by power alone, because the eye focuses light differently by wavelength band.** The same 10 mW source is a serious retinal hazard in the 400-1400 nm band (focused to a small spot on the retina) and a comparatively minor corneal hazard beyond about 1400 nm (absorbed before reaching the retina) — reading a hazard class off a power number without the wavelength band is close to guessing.
5. **A beam's natural divergence is part of its safety margin, and any optical instrument in the viewing path can remove that margin.** A Nominal Ocular Hazard Distance (NOHD) calculation assumes naked-eye viewing at the beam's actual divergence angle; a loupe, fiber-inspection scope, or binoculars collects and refocuses the diverging beam, presenting the eye with an irradiance the NOHD calculation never evaluated.

## Mental models & heuristics

- **When coupling a laser source into single-mode fiber, default to sizing a two-lens (collimator + focuser) system by magnification m = w0_target / w0_source = f2 / f1**, unless space or cost constraints force a single ball/GRIN lens, which trades coupling efficiency and alignment tolerance for a smaller, cheaper assembly.
- **When budgeting a fiber link, default to computing both a day-one loss budget and an end-of-life budget that adds fiber aging, connector re-mating wear, and a stated number of future repair splices**, unless the link is short-haul (under a few hundred meters) and low-value enough that aging margin is immaterial next to the day-one margin.
- **When selecting between single-mode and multimode fiber, default to single-mode for any link whose length x data-rate product approaches the fiber's modal-bandwidth spec (given in MHz·km on the datasheet)**, unless the link is short and low-rate enough that connector/alignment simplicity dominates the cost tradeoff.
- **When a lens spec calls for finer resolution or a smaller spot, default to first checking the Airy disk diameter at the current f-number and wavelength** — if the requirement is already at or below the diffraction limit, the fix is a faster f-number or shorter wavelength, not a better-corrected lens.
- **When classifying a CW laser source, default to pulling the MPE for the source's actual wavelength band and exposure duration from the standard's table**, not from a comparable-power example at a different wavelength — retinal-hazard-region and cornea-absorbed-region MPEs differ by orders of magnitude at the same power.
- **When a naked-eye NOHD calculation comes out small or near-zero, default to still restricting viewing with any magnifying optical instrument** unless the maintenance procedure has independently verified no scope, loupe, or binoculars is ever used near that beam path.
- **When beam quality or focus degrades as optical power ramps up and recovers on cooldown, default to suspecting thermal lensing in an optic or gain medium before suspecting a loose mechanical mount** — thermal lensing tracks power/duty cycle, an alignment drift tracks time and vibration regardless of power.

## Decision framework

1. **State the source and target in numbers**: wavelength, power (CW or peak/duty-cycle if pulsed), beam quality M² (measured, or explicitly flagged as an assumed value), and the target waist, distance, or data rate the system must deliver.
2. **Propagate the beam through the system using Gaussian beam formulas at each critical surface** (source, lens, fiber facet, detector or workpiece) — waist, divergence, and Rayleigh range — not paraxial ray tracing alone.
3. **Build the governing power or loss budget top-down in dB**, using real datasheet or measured values for every stage (coupling loss from mode mismatch, fiber attenuation, connector/splice loss, or damage-threshold power density), and compare against the requirement with margin, not a bare pass/fail crossing.
4. **Check any focused-spot or resolution requirement against the diffraction limit (Rayleigh criterion) before speccing or re-speccing a lens**, so effort isn't spent correcting aberrations on a system already at its diffraction floor.
5. **Classify laser hazard for the actual wavelength, power, and every credible viewing scenario** — naked eye and any instrument-assisted viewing the maintenance or alignment procedure could plausibly involve — computing MPE and NOHD rather than assigning a class from power alone.
6. **Reconcile end-of-life numbers against day-one numbers** (aging, repair splices, temperature, connector wear) before declaring a link or beam-delivery design closed.
7. **Document the design with every number traceable to a datasheet, standard, or measurement, and the actual specified component values** — the ideal formula output is a target, not a bill-of-materials entry.

## Tools & methods

- **Optical design software** (Zemax OpticStudio, Code V) for lens prescriptions, tolerance stack-up, and diffraction-limited performance verification.
- **Gaussian beam / ABCD-matrix propagation calculators** for coupling-lens sizing and free-space beam-delivery design.
- **Beam profiler (ISO 11146 M² measurement)** to verify a real source's beam quality against the design's assumed value.
- **OTDR (optical time-domain reflectometer) and optical power meter** to field-verify a fiber link's actual as-built loss against the design budget.
- **ANSI Z136.1 / IEC 60825-1 classification worksheets** for laser hazard analysis, including instrument-assisted viewing scenarios. See [references/playbook.md](references/playbook.md) for the filled coupling-lens, link-budget, diffraction-limit, and MPE/NOHD calc sequences.

## Communication style

To electrical/systems engineers: reconciled margin numbers, not "the link should close" — "13.7 dB day-one margin, 9.1 dB at end of life" carries the actual risk, "it works on the bench" doesn't. To an EHS or laser safety officer: the exact standard, MPE value, NOHD, and every viewing scenario evaluated (naked eye and instrument-assisted), not an assertion of "eye safe." To manufacturing or field techs: real catalog part numbers, alignment tolerances, and explicit viewing restrictions, never an ideal formula value or a vague "be careful with the laser." To an account or program lead: the number that changes their decision — a margin that survives a future spec change versus one that doesn't.

## Common failure modes

- **Treating "collimated" as literally non-diverging** over an arbitrary path length, instead of checking the beam's actual Rayleigh range against the target distance.
- **Reading a day-one link-budget margin as the finished design**, without adding fiber aging, connector wear, and future repair-splice loss for the link's actual design life.
- **Trying to shrink a focused spot or improve resolution with a better-corrected lens after the system is already diffraction-limited**, when only a faster f-number or shorter wavelength moves the floor.
- **Assigning a laser hazard class from power alone**, missing that the same power at a different wavelength band can be a materially different hazard.
- **Clearing a beam path as safe from a naked-eye NOHD calculation**, without checking whether a scope, loupe, or binoculars is used anywhere near that beam in normal operation or maintenance.
- **Overcorrection: specifying every optic in a system to be diffraction-limited or near-zero-aberration** even when the system's actual bottleneck is detector noise or alignment tolerance, adding cost without moving the real limiting spec.

## Worked example

**Situation.** An industrial site-monitoring company needs an unrepeatered point-to-point single-mode fiber link, 80 km through existing conduit, from a 1550 nm DFB laser diode transmitter (bare emitter power 10 mW / +10 dBm) fiber-coupled through a two-lens assembly into SMF-28 (ITU-T G.652.D) fiber, to a receiver rated -23 dBm minimum sensitivity at the operating bit rate. Design life is 20 years.

**Naive read.** A junior engineer budgets only day-one loss: 80 km x 0.22 dB/km fiber attenuation + 2 connectors x 0.3 dB + 6 splices x 0.1 dB = 18.8 dB total loss. Assuming the idealized +10 dBm laser power reaches the fiber unchanged, received power = 10 - 18.8 = -8.8 dBm, margin over -23 dBm sensitivity = **14.2 dB — "easily passes," design declared closed.**

**Expert reasoning — coupling lens sizing.** The diode's near-field beam waist is w0 = 1.5 µm at 1550 nm. Divergence half-angle: θ = λ/(π w0) = 1550e-9 / (π x 1.5e-6) = **0.329 rad (18.85°)**. Target: couple into SMF-28, mode field diameter 10.4 µm, so fiber mode radius w0_fiber = 5.2 µm. Using a collimating lens f1 = 4.5 mm (catalog aspheric collimator), the collimated beam waist is w1 = f1 x θ = 4.5 mm x 0.329 = **1.4805 mm**. Solving the focusing-lens equation w0_fiber = f2 x λ / (π w1) for f2: f2 = w0_fiber x π x w1 / λ = 5.2e-6 x π x 1.4805e-3 / 1550e-9 = **15.6 mm** ideal, rounded to the nearest catalog aspheric focal length **f2 = 15.29 mm**. Realized output waist: w0_out = f2 x λ / (π w1) = 15.29e-3 x 1550e-9 / (π x 1.4805e-3) = **5.09 µm** (target 5.2 µm, -2.1%). Mode-mismatch coupling efficiency η = [2 w_a w_b / (w_a² + w_b²)]² = [2(5.09)(5.2) / (5.09² + 5.2²)]² = [52.94/52.95]² = **0.9995 → -0.002 dB, negligible**. The dominant real coupling loss is alignment tolerance (angular/lateral offset in the assembly), budgeted at a stated **0.5 dB** for a well-aligned two-lens assembly — so actual launch power into the fiber is **+9.5 dBm, not the idealized +10 dBm** the naive budget assumed.

**Expert reasoning — link budget, day-one vs. end-of-life.** Recomputing day-one with the actual +9.5 dBm launch: received power = 9.5 - 18.8 = **-9.3 dBm**, margin = -9.3 - (-23) = **13.7 dB** (0.5 dB below the naive 14.2 dB, from the coupling loss the naive read skipped). End-of-life additions over the 20-year design life: fiber aging **4.0 dB** (80 km x a stated 0.05 dB/km cumulative aging allowance), 2 future repair splices at 0.1 dB each = **0.2 dB**, connector re-mating wear over life at a stated 0.2 dB per connector x 2 connectors = **0.4 dB**. Total end-of-life addition = 4.0 + 0.2 + 0.4 = **4.6 dB**. End-of-life received power = 9.5 - 18.8 - 4.6 = **-13.9 dBm**, margin = -13.9 - (-23) = **9.1 dB** — clears the unrepeatered-link design practice's 3 dB minimum end-of-life margin, but **5.1 dB less headroom than the naive day-one number implied (14.2 dB vs. 9.1 dB)**. A future bit-rate upgrade requiring more than about 6 dB of additional receiver sensitivity would fail this link without a repeater or amplifier — a decision this link's real margin should inform now, not after the naive number was already quoted to the customer.

**Expert reasoning — laser safety at the open-beam alignment step.** Before the fiber pigtail is epoxied and terminated, a technician aligns the bare 10 mW, 1550 nm beam by eye. MPE for 1550 nm, CW, intrabeam viewing, exposure duration >=10 s (cornea/lens-hazard region, ANSI Z136.1 Table 5a-equivalent — stated design value, verify against the current edition) = **1.0 W/cm²**. Full-angle divergence Θ = 2θ = **0.658 rad**. NOHD = (2/Θ) x sqrt(Φ / (π x MPE)) = (2/0.658) x sqrt(0.01 / (π x 1.0)) = 3.040 x sqrt(0.003183) = 3.040 x 0.05643 = **0.1716 cm ≈ 1.7 mm**. A naive read ("10 mW is low power, safe to eyeball the beam") is correct only for naked-eye viewing at this NOHD — but the same divergence that makes the naked-eye NOHD tiny is exactly what a fiber-inspection scope or loupe removes by refocusing the collected light onto the eye. This is the textbook case for **Class 1M**: safe for unaided viewing at any distance, hazardous when viewed through magnifying optics.

**Deliverable (optical link and coupling design memo, as issued to the program lead):**

> **Optical Link & Coupling Design Memo — 80 km Unrepeatered SMF Link**
> **Coupling optics:** Collimating lens f1 = 4.5 mm, focusing lens f2 = 15.29 mm (catalog). Realized output waist 5.09 µm vs. 5.2 µm target MFD (-2.1%); mode-mismatch loss negligible (-0.002 dB). Total coupling loss budgeted at 0.5 dB (alignment-tolerance dominated). Actual launch power into fiber: +9.5 dBm, not the idealized +10 dBm.
> **Link budget, day-one:** 80 km x 0.22 dB/km + 2 connectors x 0.3 dB + 6 splices x 0.1 dB = 18.8 dB total loss. Received power -9.3 dBm vs. -23 dBm sensitivity = **13.7 dB margin**.
> **Link budget, end-of-life (20-yr design life):** +4.6 dB additional loss (4.0 dB fiber aging, 0.4 dB connector re-mate wear, 0.2 dB two repair splices). Received power -13.9 dBm, margin **9.1 dB** — passes the 3 dB minimum end-of-life margin, but materially less headroom than the day-one number alone implied.
> **Laser safety (transmitter open-beam alignment step):** 10 mW, 1550 nm CW, 18.85° divergence half-angle. NOHD (naked eye) = 1.7 mm — **Class 1M**: safe for unaided viewing at any distance, hazardous under magnified viewing. Alignment procedure requires no viewing of the energized beam or an unterminated connector through any magnifying optic without a calibrated attenuating filter.
> **Recommendation:** proceed with the link as designed; flag the reduced end-of-life margin (9.1 dB, not 14.2 dB) to the account team before committing to any future bit-rate upgrade on this span.

## Going deeper

- [references/playbook.md](references/playbook.md) — load when running a coupling-lens sizing calc, a fiber link power budget, a diffraction-limited lens/resolution check, or a laser MPE/NOHD classification and need the filled formulas, tables, and step sequences.
- [references/red-flags.md](references/red-flags.md) — load when reviewing a link-budget spreadsheet, a lens spec, an OTDR trace, or a laser safety procedure for the smell tests that catch a marginal design before it ships.
- [references/vocabulary.md](references/vocabulary.md) — load when a term in a datasheet, standard, or field report needs its precise photonics meaning, not the generic one.

## Sources

- Saleh & Teich, *Fundamentals of Photonics* — Gaussian beam propagation, Rayleigh range, ABCD-matrix beam transformation through lens systems.
- Self, S.A., "Focusing of spherical Gaussian beams," *Applied Optics* 22(5), 1983 — the Gaussian beam focusing/coupling-lens relations used in the worked example's coupling-lens sizing.
- Hecht, Eugene, *Optics* — Rayleigh criterion, Airy disk diffraction limit, f-number relations.
- ITU-T G.652 — single-mode fiber attenuation and mode-field-diameter specifications used for SMF-28-class fiber in the worked example.
- Telcordia GR-1435 (and common carrier optical-safety practice) — no viewing of an energized fiber connector with a magnifying optical instrument.
- ANSI Z136.1, *Safe Use of Lasers*, and IEC 60825-1 — MPE tables, AEL/hazard-class boundaries, and the NOHD formula; the worked example's specific MPE value and fiber-aging/connector-wear allowances are stated design heuristics — verify against the current edition and the specific wavelength sub-band before use in an actual classification or hazard report.
- Paschotta, Rüdiger, *RP Photonics Encyclopedia* — coupling efficiency for mismatched Gaussian modes, beam quality factor M².

Attribution

wonsukchoiwonsukchoi
View sourceSee grades on GitHubMore from wonsukchoi →
SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Related Skills

Caveman

Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less tokens". Stays on until "stop caveman" or "normal mode".

1100021 votes

Hyperplan

Adversarial multi-agent planning skill. Self-orchestrates 5 hostile category members (unspecified-low, unspecified-high, deep, ultrabrain, artistry) via team-mode for ruthless cross-critique debate, distills only the defensible insights, then MANDATORILY hands the distilled insight bundle to the `plan` agent for executable plan formalization. Use when planning needs maximum rigor and surfacing of weak assumptions, blind spots, and over-engineering. Triggers: 'hyperplan', 'hpp', '/hyperplan', ...

698621 votes

Writing Skills

Create and manage Claude Code skills in HASH repository following Anthropic best practices. Use when creating new skills, modifying skill-rules.json, understanding trigger patterns, working with hooks, debugging skill activation, or implementing progressive disclosure. Covers skill structure, YAML frontmatter, trigger types (keywords, intent patterns), UserPromptSubmit hook, and the 500-line rule. Includes validation and debugging with SKILL_DEBUG. Examples include rust-error-stack, cargo-dep...

3931 votes

Mcp Code Execution

Routes multi-tool workflows through MCP servers for large datasets and pipelines. Use when Bash tool overhead is limiting throughput on data-heavy tasks.

3421 votes

catchup

Recovers the conversation and failed tool calls of a previous Codex, Amp, Claude Code, Antigravity, Cline, Copilot CLI, Cursor, DeepSeek Harness, Grok Build, Kimi, OpenCode, Pi Agent, or ZCode session. Use when the user says "catch up", "what did the last session do", "get me up to speed", "I switched agents", asks to recover/summarize a previous session before continuing, or asks to diagnose or report a catchup failure. Do NOT use for the current conversation, git history, or any non-agent log.

741 votes
View all in ai-agents →