← Commit history

hydrogen-dock skill: dockbar.json hard cutover + point at the Dock Bar guide

John Lauer ·46fb4ebd1f ·2mo ago ·parent cb52021
dock.json support is removed from Hydrogen (1.0.121+); the skill now teaches dockbar.json only, and the full publisher contract moved from the deprecated adom/hydrogen-dock-sdk page to docs/dockbar.md on the adom/hydrogen page.
1 file changed +5−5
skills/hydrogen-dock/SKILL.md+5−5
@@ -1,6 +1,6 @@ --- name: hydrogen-dock-description: The Hydrogen dock bar (the app launcher rail on the right edge of the workspace) and how ANY wiki app, including a third party's, becomes a card in it. Covers the dock.json/dockbar.json manifest, the two rules that break every first attempt (a serve verb must self-background, and steps must set PATH for ~/.local/bin), the container_command step contract (--print-url, skip_if, await url, timeouts), the ai block (per-app named threads, staged vs auto), re-click behavior, the free orbital loading screen, testing a draft manifest, and troubleshooting by symptom. Read this when a user says - add an app to the dock, add my app to the dock, put this wiki page in the dock, make my app dock-ready, dock settings, dock.json, dockbar.json, dock manifest, launch steps, AI thread on launch, auto submit prompt, staged prompt, draft manifest, how do dock apps launch, why does my dock card not work, command not found in my dock launch, my dock app never answers, app launcher, featured apps, pin an app, hover zoom, alt-pin.+description: The Hydrogen dock bar (the app launcher rail on the right edge of the workspace) and how ANY wiki app, including a third party's, becomes a card in it. Covers the dockbar.json manifest (dockbar.json support REMOVED: hard cutover, rename or your card falls back to the wiki page), the two rules that break every first attempt (a serve verb must self-background, and steps must set PATH for ~/.local/bin), the container_command step contract (--print-url, skip_if, await url, timeouts), the ai block (per-app named threads, staged vs auto), re-click behavior, the free orbital loading screen, testing a draft manifest, and troubleshooting by symptom. Read this when a user says - add an app to the dock, add my app to the dock, put this wiki page in the dock, make my app dock-ready, dock settings, dockbar.json, dockbar.json, dock manifest, launch steps, AI thread on launch, auto submit prompt, staged prompt, draft manifest, how do dock apps launch, why does my dock card not work, command not found in my dock launch, my dock app never answers, app launcher, featured apps, pin an app, hover zoom, alt-pin. ---  # hydrogen-dock: the Hydrogen app launcher@@ -10,12 +10,12 @@ card in it is a wiki app page. **Any public wiki app can be a dock card**, and users can add one themselves without anybody's permission.  The dock resolves what to SHOW (name, brief, hero) from the page itself, and how-to LAUNCH from a `dock.json` manifest at the root of the app's wiki page repo.+to LAUNCH from a `dockbar.json` manifest at the root of the app's wiki page repo. Display is never duplicated into the manifest; the page is the single source of truth.  **THE FULL PUBLISHER CONTRACT IS THE SDK PAGE:**-https://wiki.adom.inc/adom/hydrogen-dock-sdk+https://wiki.adom.inc/adom/hydrogen/files/docs/dockbar.md  This skill is the working summary plus the traps. Send anyone writing a manifest to the SDK page.@@ -25,7 +25,7 @@ to the SDK page. 1. Confirm the page exists and is public (`adom-wiki discover search -q <term>`). 2. Dock settings (the gear at the top of the rail) → Add app → `owner/slug`. 3. If the page has no manifest, the card still works: it opens the wiki page.-   Tell the user that launch steps need a `dock.json` and point the publisher at+   Tell the user that launch steps need a `dockbar.json` and point the publisher at    the SDK page.  ## The manifest, in one screen@@ -58,7 +58,7 @@ to the SDK page. } ``` -Discovery order, first match wins: root `dock.json`, root `dockbar.json`, then+Discovery order, first match wins: root `dockbar.json` only (dockbar.json support removed), then either name in a sub-folder (depth 2 max, never `node_modules` or dot-folders).  `mode` is `container_command` (run steps, then show a URL), `webview` (load