Export KiCad Gerbers and provenance on every molecule publish - kicad-export-molecule

by adom

Ship a KiCad molecule to the Adom wiki: local KiCad STEP, board, schematic and fabrication export (<slug>-fab.zip, export.json) through the Adom Bridge, handoff to molecule-publish (the wiki's model registry builds the GLB, footprint and symbol from the sources), and import of the built molecule into Hydrogen with adom-wiki model import.

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

← All Pull Requests

Export KiCad Gerbers and provenance on every molecule publish #1

Merged opened by AdityaAngajala 2026-10-19

Make the KiCad export handoff include both sides' copper/mask/silk, board outline, split metric drill files, the canonical fab zip and an export record. Preserve the native STEP command with --subst-models, and check the final bundle using molecule-publish 2.11.0.

Validation: the shared checker accepts all 44 saved KiCad/import archives and its seven regression tests pass. Package lint reports no errors. These instructions were checked against the existing backfill commands; a fresh designer-machine STEP export was not run.

Diff Skip to comments

--- a/package.json+++ b/package.json@@ -1,51 +1,52 @@ {   "slug": "kicad-export-molecule",-  "version": "1.1.2",+  "version": "1.2.0",   "type": "skill",   "description": "Ship a KiCad molecule to the Adom wiki: local KiCad STEP export via the adom-desktop bridge, OCCT molecule conversion (anchored GLB + footprint + symbol), wiki component publish, and handoff to adom-molecule-import for Hydrogen registration.",   "tags": [⋯ 5 unchanged lines ⋯   ],   "dependencies": {     "adom/adom-molecule": "^1.1.3",-    "adom/molecule-publish": "^2.0.0",+    "adom/molecule-publish": "^2.11.0",     "adom/adom-bridge": "^2.0.0"   },   "scripts": {⋯ 30 unchanged lines ⋯     }   ] }+--- a/page.json+++ b/page.json@@ -1,60 +1,60 @@ {   "slug": "kicad-export-molecule",-  "version": "1.1.2",+  "version": "1.2.0",   "type": "skill",   "description": "Ship a KiCad molecule to the Adom wiki: local KiCad STEP export via the adom-desktop bridge, OCCT molecule conversion (anchored GLB + footprint + symbol), wiki component publish, and handoff to adom-molecule-import for Hydrogen registration.",   "tags": [⋯ 5 unchanged lines ⋯   ],   "dependencies": {     "adom/adom-molecule": "^1.1.3",-    "adom/molecule-publish": "^2.0.0",+    "adom/molecule-publish": "^2.11.0",     "adom/adom-bridge": "^2.0.0"   },   "scripts": {⋯ 42 unchanged lines ⋯--- a/README.md+++ b/README.md@@ -1,36 +1,39 @@ # kicad-export-molecule +Every molecule export includes `<slug>-fab.zip` (both sides' fabrication layers and drill) and `export.json` (producer versions and source hashes). The exporter hands both to molecule-publish, which checks them before and after the page push. See [SKILL.md](SKILL.md) for the tool-specific steps.+ Agent skill: ship a molecule from the user's **local KiCad** to the Adom wiki and into their Hydrogen account, in four verified stages: ⋯ 28 unchanged lines ⋯ - `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+--- a/SKILL.md+++ b/SKILL.md@@ -1,116 +1,134 @@⋯ 45 unchanged lines ⋯ ```bash # via the bridge's run-command verb; use the laptop's real kicad-cli path kicad-cli pcb export step --subst-models -o ABC.step ABC.kicad_pcb+kicad-cli pcb export gerbers --layers F.Cu,B.Cu,F.Mask,B.Mask,F.Silkscreen,B.Silkscreen,Edge.Cuts --check-zones -o fab/ ABC.kicad_pcb+kicad-cli pcb export drill --format excellon --excellon-units mm --excellon-separate-th --drill-origin absolute -o fab/ ABC.kicad_pcb+kicad-cli version ``` +Use an empty `fab/` directory and the same saved board for all three exports.+Keep the STEP flags above even if a bridge's convenience export omits+`--subst-models`. Gerbers and drill are required on every molecule export.+Read the board's `(setup (stackup ...))` for known thickness, side colours+and finish; leave unknown values absent rather than inventing defaults.++Install `adom/molecule-publish` and use its+[fabrication handoff](https://wiki.adom.inc/adom/molecule-publish)+and `scripts/fab_bundle.py` to package `fab/` as `<slug>-fab.zip` and write+`export.json`. Record the actual KiCad version, this export skill's version,+and hashes of the STEP, saved board, every schematic sheet, project and other+exported sources. Run `fab_bundle.py check` before handing the bundle over.+ Optional but recommended — silkscreen overlays (top + bottom): - Export the silk layers to PNG (transparent background). - Artwork must be **white**; if the export bakes black silk, recolor opaque⋯ 10 unchanged lines ⋯ Pull the **full bare-minimum bundle** to the container with `adom-desktop pull_file`: `ABC.step`, `ABC.kicad_pcb`, **`ABC.kicad_sch`** (schematic is required — a molecule without it is not reproducible),-`ABC.kicad_pro`, and any silk PNGs.+`ABC.kicad_pro`, `<slug>-fab.zip`, `export.json`, and any silk PNGs.  ## Stage 2 — Hand off to molecule-publish ⋯ 2 unchanged lines ⋯ bundle from Stage 1:  - STEP + board (`.kicad_pcb`) + schematic (`.kicad_sch`) + silk PNGs+- `<slug>-fab.zip` + `export.json`, checked against the final source files - `pin` size (medium|large) and the target slug/org  It runs the OCCT molecule-mode conversion with the stats gates (`anchored`,⋯ 35 unchanged lines ⋯ - `fusion-export-molecule` / `altium-export-molecule` — same job, other EDAs - `kicad-to-molecule` — make a plain PCB molecule-ready first (wings + pins) - `adom-desktop-kicad-bridge` — the laptop KiCad verbs Stage 1 drives+

Comments

No comments yet.