skill
molecule-publish
Public Made by Adomby adom
Publish molecules AND generic boards to the Adom wiki - one publisher, two shapes: OCCT conversion (molecule mode with stats gates, or plain for boards), component packaging, adom-wiki publish, APM render assets + component dependencies. Companion to adom-molecule-import.
← Commit history
SKILL.md+25@@ -235,6 +235,31 @@ board included so Hydrogen generates and attaches the footprint at create: `adom-molecule create --owner <o> --name <n> --glb <slug>.glb --pcb <board> --no-optimize` (use `--brd` for EAGLE/Fusion boards). +## Page polish rules (field-tested — molecule-pipeline #190)++Hard-won from ~10 real imports; each one cost a debugging detour:++- **Heroes on board/component pages are static images** — `page hero --image`,+ never `--screenshot`/billboard (billboard composes an app-style browser+ frame around the render: "images within images").+- **Browse-card thumbnails bake at publish time** — a repo-only hero push+ does NOT refresh the card. Republish with a version bump, then verify the+ served card PNG actually changed (sha256 the blob).+- **Keep board pages PDF-free.** Any PDF in the repo becomes an unwanted+ auto-scanned "Datasheet" section with no manifest opt-out — ship docs on a+ dedicated docs page or as release assets instead.+- **Draco-compress big scene GLBs only.** Multi-MB workcell/scene models:+ `gltf-transform optimize --compress draco` (35 MB → ~1.3 MB, <3 s load).+ Chip/molecule-sized GLBs: do NOT draco — it comes out ~40% BIGGER than+ quantized and the wiki readme sandbox can't decode it (adom-step2glb #3).+ Your published molecule GLB is already optimized by OCCT — leave it alone.+- **Plain components (no MP markers) skip axis normalization** — molecule+ mode anchors Z-up, but a plain `step2glb convert` preserves the source+ STEP's axes; check orientation per board and bake a ±90° X root rotation+ only when the source needs it.+- **Wiki page animations are baked glTF animations** in the viewer GLB —+ GIFs only work inside README sections.+ ## Related - `adom-molecule-import` — the wiki → Hydrogen companion
package.json+1−1@@ -1,6 +1,6 @@ { "slug": "molecule-publish",- "version": "2.1.1",+ "version": "2.1.2", "type": "skill", "description": "Publish molecules AND generic boards to the Adom wiki - one publisher, two shapes: OCCT conversion (molecule mode with stats gates, or plain for boards), component packaging, adom-wiki publish, APM render assets + component dependencies. Companion to adom-molecule-import.", "tags": [
page.json+1−1@@ -1,6 +1,6 @@ { "slug": "molecule-publish",- "version": "2.1.1",+ "version": "2.1.2", "type": "skill", "description": "Publish molecules AND generic boards to the Adom wiki - one publisher, two shapes: OCCT conversion (molecule mode with stats gates, or plain for boards), component packaging, adom-wiki publish, APM render assets + component dependencies. Companion to adom-molecule-import.", "tags": [