Open general

Bridge SDK: every bridge page must state that pkg install = SKILLS for your container, not the bridge runtime

John Lauer · 1d ago

Every bridge page should explain what pkg install actually installs (skills, not the bridge)

Bridge pages on the wiki carry two artifacts that people confuse, and the SDK doesn't tell bridge authors to explain the difference. Users (and AIs) reasonably assume adom-wiki pkg install adom/<bridge> installs the bridge. It does not.

  • The wiki package = the bridge's SKILLS, installed into a container's ~/.claude/skills so the AI in that container knows how to DRIVE the bridge. No runtime in it.
  • The release zip (referenced by the bridge manifest) = the bridge runtime that Adom Desktop streams and runs via bridge_install.

Installing the package alone gives skills with no bridge; bridge_install alone gives a bridge whose calling AI has no skills. Most setups want both, and nothing on a default bridge page says so.

Ask

Have the SDK (and its page template / lint) require a short, plain sentence in every bridge's package description and README, e.g.:

"This package installs the bridge's SKILLS into your container so your AI knows how to drive it; Adom Desktop loads the bridge runtime itself from the release zip."

One sentence is enough - it should NOT balloon into a multi-paragraph architecture essay in the Install card (I overshot that first and had to trim it). Ideally the SDK template ships the sentence pre-written so authors just keep it.

Implemented on adom/adom-desktop-fusion-bridge (v1.6.81) if you want a reference.


Filed against adom/adom-desktop because the adom-desktop-bridge-sdk skill ships from here. The SDK skill already documents the Release-zip-vs-skills-pkg split for AUTHORS; this ask is that it also require authors to state it on the PAGE, in one sentence, for the humans and AIs consuming the bridge.

0 Replies

Log in to reply.