Convert a 2D optical schematic into a physically explainable, independently auditable Blender scene.
Load the relevant references
Read physical-gates.md before geometry, CAD placement, or mechanical review.
Read evidence-contract.md before declaring any PASS or preparing a release.
Read history-derived-rules.md when revising an existing scene or when old fixes may have regressed.
Read project-case-study.md for the complete G1/G2 2D-to-3D example.
Authority and revision rules
Apply system constraints first, then the newest explicit user wording or annotated screenshot, then active project rules, then this general skill, and only then older artifacts or PASS labels.
Freeze an accepted package. Start a new revision for every correction; never overwrite the prior evidence package.
Keep one writer for the shared Blender generator. Use helpers as read-only optical, mechanical, CAD, evidence, and visual reviewers unless an isolated write scope is explicit.
Translate every correction into object families, world-space geometry, a measurable gate, and required evidence before editing.
Use BLOCKED or UNVERIFIED when real geometry or evidence is missing. File existence, imported CAD, process success, labels, AABB contact, and self-reported text are not proof.
Core workflow
Build a machine-readable map: schematic node -> experimental role -> real asset -> optical/fiber/electrical ports -> support path.
Inventory every branch, component, beam segment, beam height, aperture, connector, and required detector endpoint.
Acquire official CAD when licensing permits. Record part number, source URL, SHA-256, unit scale, bbox, local optical axis, surface normal, aperture, and provenance. Mark modeled or surrogate parts explicitly.
Solve mechanics post-first from verified table holes through real fasteners, clamps, holders, posts, mount faces, and device interfaces.
Fix the shared placement or transform root cause. Prove one representative repeated assembly before propagation, then reopen and recheck every copy.
Render bright audit views before beauty views. Use cutaways or transparency only to expose hidden, already-measured interfaces.
Complete the saved-scene, visual, export, document, hash, and rule-compliance gates in the evidence contract.
Required semantic separation
Treat free-space optical rays, guided fiber, and electrical/coaxial cables as different object families, materials, ports, and audit records.
Terminate free-space light at the physical coupling surface; continue only the guided fiber from the ferrule/FC interface.
Use open geometry for apertures and slits. A centered ray through an opaque disk is a collision, not a PASS.
Remove duplicate surrogates and unexplained placeholders after the real or declared modeled assembly exists.
Publication rendering
After physical gates pass, produce a clean editorial scene with restrained metals, readable black-anodized edges, physically modest glass, thin emissive beam cores, soft halos, and uncluttered labels. Preserve topology and geometry while changing camera, lighting, materials, or presentation. Nature-style appearance never replaces mechanical evidence.
Completion language
PASS: every applicable active gate has fresh evidence.
PARTIAL/SCOPED: only a declared subset was audited.
UNVERIFIED: required evidence is missing or cannot distinguish the claim.
BLOCKED: a known requirement fails.
Never promote PARTIAL/SCOPED to whole-system PASS.
How to use it
Copy the folder
Take k-telux/thorlabs-blender-optical-path from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
Check the name does not clash
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.