Closed general

Deferred: publish the bootstrap package to ship the rewritten hydrogen-dock skill

John Lauer · ·closed by John Lauer

Deliberately deferred, not forgotten. John, 2026-08-20: "we need to get the dock bar working first, we're probably gonna modify the docs a whole bunch anyway over the next few days, so you don't need to publish that fleet wide until way later, but don't forget."

What is pending

The hydrogen-dock skill in this page's repo (skills/hydrogen-dock/SKILL.md) was rewritten for third-party adoption and pushed as SOURCE, at commit cb520215.

It has reached zero users. The repo pillar and the pkg pillar do not sync: containers install the bundled skills from the published package, so until this page is pkg published, every workspace still has the old skill text.

Why it is being held

The dock bar is under active development and the docs will churn for several days. Publishing now would push one snapshot to roughly 570 containers via the hook's automatic pkg update, and then push another, and another. Better to let the contract settle and publish once.

What to do when the dock work settles

  1. Confirm the repo has no other thread's in-flight work sitting in it, since a publish snapshots the whole repo, not just the dock skill.
  2. Re-read skills/hydrogen-dock/SKILL.md against the shipped behavior, especially anything added after this issue (health LEDs are in flight).
  3. Check it agrees with adom/hydrogen-dock-sdk, which is the publisher-facing contract.
  4. adom-wiki pkg publish this page.
  5. Verify a container picks it up after the hook's throttle (~30 min).
  • adom/hydrogen-dock-sdk: the publisher contract, already live and rewritten
  • adom/kicad-bridge#43, adom/fusion-bridge#37: the two bugs that produced most of the new documentation

Filed from the ah dock-bar build thread as a durable reminder.

1 Reply

John Lauer ·

Done. The package has been published many times since this was deferred (latest 0.5.70, Oct 5), and each publish snapshots the whole repo. Checked today: the hydrogen-dock skill installed in a workspace from the package is byte-identical to skills/hydrogen-dock/SKILL.md in the repo, so the rewrite reached users. Closing.

John Lauer closed this ·

Log in to reply.