← Commit history

Initial commit: skill/adom-hardware-component-publish

AravK ·8d3f0e7e52 ·
2 files changed +101
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]"+  }+}\ No newline at end of file