Overview Files Skills Discover Packages Releases Dependencies Issues1 Breadcrumbs Pull Requests Activity

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:

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.
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.
Publish — wiki component package (adom-wiki pkg publish + repo push) carrying the GLB + board + footprint + symbol, so imports never regenerate anything.
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

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

# 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