Open general

SDK should require every bridge to explain: the pkg install is SKILLS for your container, the release zip is the runtime AD loads

John Lauer · 1d ago

Every bridge ships two artifacts on its wiki page, and users (and AIs) conflate them constantly:

  • the release zip — the bridge RUNTIME, which Adom Desktop downloads and runs via the bridge manifest
  • the pkg (adom-wiki pkg install adom/<bridge>) — skills for your container, so your AI knows how to drive the bridge

Nothing in the SDK currently tells a bridge author to explain this, so pages don't, and the Install card reads like it installs the bridge. It doesn't.

Ask: make the SDK require (and template) a one-line statement of this on every bridge page + in package.json.description. Keep it to one line — a paragraph in the Install card is worse than nothing.

Suggested canonical wording bridge authors can copy:

Skills for your container so your AI knows how to drive the bridge. The bridge runtime itself is the release zip — Adom Desktop loads that.

Reference: adom/adom-desktop-kicad-bridge now does this (pkg 1.0.15).

0 Replies

Log in to reply.