# kicad-export-molecule

Agent skill: ship a molecule from the user's **local KiCad** to the Adom wiki
and into their Hydrogen account, in four verified stages:

1. **Export** — KiCad 10 `kicad-cli pcb export step --subst-models` on the
   laptop via the adom-desktop KiCad bridge (3D models only resolve there),
   plus optional white silkscreen PNGs; pulled to the container.
2. **Convert** — OCCT molecule mode (`service-occt` / step2glb service):
   MP-marker anchoring, gold machine pins, silk overlay, and the
   footprint + symbol JSON with per-pad wire-attach Z.
3. **Publish** — wiki component package (`adom-wiki pkg publish` +
   `repo push`) carrying the GLB + board + footprint + symbol, so imports
   never regenerate anything.
4. **Import** — handoff to the `adom-molecule-import` skill
   (`adom-molecule create --glb ... --no-optimize`).

The skill is gate-driven: preflight checks (bridge up, KiCad 10, MP1-MP4
markers, locally-resolving 3D models) and a post-conversion stats table
(`anchored`, `footprint_applied`, `contact_z`, `warnings[]`) that stop a
degraded run before it pollutes the wiki.

## Install

```bash
adom-wiki pkg install adom/kicad-export-molecule
```

Pulls `adom/adom-desktop` and `adom/adom-molecule` as dependencies.

## Siblings

- `fusion-export-molecule` — same job from Fusion 360
- `altium-export-molecule` — same job from Altium (via KiCad's importer)
- `adom-molecule-import` — the import half (ships with adom-molecule)
- `kicad-to-molecule` — make a plain PCB molecule-ready first