by adom
The one-stop-shop for publishing a hardware component (or molecule/board) to the Adom Wiki. The whole lifecycle: page anatomy, the clone→edit→preview→push loop and its hard rules, making a great hero image (Hero Component Studio — 16:10, overlay-safe, datasheet-backed), the animated 3D composite, the interactive 3D viewer, ct thumbnails, the datasheet-accuracy audit, and every wiki push/pull gotcha we've hit. Now includes the worked Path B (board) pipeline: STEP-to-GLB, refdes tagging, layer de-
← Commit history
README.mdadded+32@@ -0,0 +1,32 @@+# Publish a Hardware Component to the Adom Wiki++**Private / Adom-only.** The one-stop-shop for putting a **hardware component** — a discrete part+(resistor, MLCC, LED, inductor, connector, IC), a **molecule** (an assembled sub-board), or a full+**board** — on `wiki.adom.inc` and having it look right. It exists so a new session (or a new+teammate) doesn't re-derive the same things from scratch:++- what a component page is **made of** (page.json, README, characterization page, 3D model, symbol,+ footprint, ct thumbnails, hero) and the **clone → edit → snapshot → preview → approve → push** loop+ with `adom-wiki` — as a runnable, documented module (`scripts/publish_wiki_page.py`), not just prose,+- how to make a **great hero image** with **Hero Component Studio** — 16:10, overlay-safe framing,+ visual-mass centring, a part on a procedural PCB or a molecule on a shadow ground, all+ datasheet-backed (this is the part to get right — it's the first thing anyone sees),+- the **animated 3D composite** recipe (`<MPN>.glb` / `.insertion.glb`),+- the **interactive 3D viewer** (⚠️ under active development — Arav is reworking the viewer),+- the **datasheet-accuracy audit** (every value and chart traceable to a datasheet figure),+- and every **wiki push/pull gotcha** that cost time the first time (owner ≠ `adom`, the hero cache,+ `page hero` wants a repo-relative path, blob `.js` won't run as `<script src>`, README.html ++ srcdoc embedding, etc.).++## How to use++Read `SKILL.md` — it's the whole playbook, organized as numbered sections you can jump to. Start at+**The lifecycle at a glance**, then §0 (hard rules) and §3 (the hero image). For the **publish+mechanics specifically**, `scripts/publish_wiki_page.py` is the programmatic reference. Other worked+builder scripts are in `scripts/` (adapt per part).++## Contributing++This is a **living document**. When you hit a new wiki issue or find a better recipe, add it to the+right section (usually §8 gotchas, §3 hero, or §4 composite), bump the version, and open a PR against+`adom/adom-hardware-component-publish`. Keep findings specific and cited.
page.jsonadded+69@@ -0,0 +1,69 @@+{+ "slug": "adom-hardware-component-publish",+ "title": "Publish a Hardware Component to the Adom Wiki",+ "type": "skill",+ "version": "0.8.0",+ "description": "The one-stop-shop for publishing a hardware component (or molecule/board) to the Adom Wiki. The whole lifecycle: page anatomy, the clone→edit→preview→push loop and its hard rules, making a great hero image (Hero Component Studio — 16:10, overlay-safe, datasheet-backed), the animated 3D composite, the interactive 3D viewer, ct thumbnails, the datasheet-accuracy audit, and every wiki push/pull gotcha we've hit. Now includes the worked Path B (board) pipeline: STEP-to-GLB, refdes tagging, layer de-fighting, two-mode board viewer (Assembly merged with explanation + free-camera Static) template, board maps, preview harness. A living, refinable skill — add gotchas via PR. Private, Adom-only.",+ "tags": [+ "skill",+ "wiki",+ "publish",+ "hardware",+ "component",+ "molecule",+ "hero-image",+ "3d-composite",+ "interactive-viewer",+ "datasheet",+ "adom",+ "reference"+ ],+ "dependencies": {},+ "scripts": {+ "install": "./install.sh",+ "uninstall": "./uninstall.sh"+ },+ "hero": {+ "type": "image",+ "path": "docs/hero.png"+ },+ "visibility": "private",+ "org": "adom",+ "sample_prompts": [+ "Publish a hardware component|Publish the wiki page for <MPN> (a <category>) end-to-end using adom-hardware-component-publish",+ "Make a great hero image|Render an overlay-safe 16:10 hero for <MPN>/<molecule> in Hero Component Studio and set it as the page hero",+ "Update an existing component page|Clone <owner>/<slug> fresh, fix <thing>, preview, snapshot, and push with a real changelog",+ "Build the 3D composite|Build the animated insertion.glb for <MPN> (part drops onto its footprint, Layers toggle)",+ "Audit a page against its datasheet|Compare the <MPN> characterization page to its datasheet and list discrepancies with page citations",+ "Add ct thumbnails|Generate the ct/ bundle (3D icons + symbol + footprint) for <MPN>"+ ],+ "discovery_triggers": [+ "publish component",+ "publish hardware",+ "publish to wiki",+ "component page",+ "molecule page",+ "board page",+ "wiki page",+ "hero image",+ "component thumbnail",+ "card art",+ "3d composite",+ "insertion.glb",+ "interactive viewer",+ "ct thumbnails",+ "datasheet audit",+ "wiki push",+ "wiki clone",+ "page hero",+ "set hero",+ "land pattern",+ "footprint viewer",+ "adom-hardware-component-publish"+ ],+ "discovery_pitch": "The one-stop-shop for putting a hardware component on the Adom Wiki and having it look right — the push loop, a great hero image, the 3D composite/viewer, and every gotcha, in one place.",+ "author": {+ "name": "AravK",+ "email": "[email protected]"+ }+}