Open general

Back-port today's skill cleanup into skills/public-facing (hydrogen-bootstrap 0.5.79, hydrogen-windows-bootstrap 0.3.31, adom-theme 2.3.9)

Colby Knox · 10h ago

adom-wiki 1.7.77 · adom/hook 1.4.2 · checked 2026-10-22

Back-port needed: skill text fixed directly on the wiki today, so the next ah publish has to merge it.

Context: a fresh Claude in an Adom workspace was "knocking into walls" (team feedback). Today's cleanup, approved by John and Kyle, fixed the skills on the wiki and published:

  • adom/hydrogen-bootstrap 0.5.77 → 0.5.79
  • adom/hydrogen-windows-bootstrap 0.3.29 → 0.3.31
  • adom/adom-theme 2.3.8 → 2.3.9 (its README cites this repo as a source)

What changed, in short:

  • Every description is now valid >- YAML of 300 chars or less. The skill listing budget is about 1% of context, so long descriptions were pushing most skills down to bare names.
  • Global "READ THIS FIRST / MUST READ / Master index" claims are gone. The ~/.claude/CLAUDE.md block from adom/hook is now the one front door, and hydrogen-overview is the one Hydrogen index.
  • hydrogen-skill-catalog is deleted (install.sh prunes it). It listed hd-* skills that no longer exist.
  • hydrogen-topology is true for both cases: Claude inside the local Adom-Workspace distro, or Claude in a cloud container.
  • [[hd-*]] links, adom-desktop CLI calls, HD/AD/hw/abe in prose and browser_* pup verbs all now use the current names. pup_* was checked against the puppeteer bridge 2.0.733 manifest.
  • The setup step id ensure-adom-bridge-cli was checked against setup_steps_wsl.rs and the live setup-steps-wsl.json.
  • Hidden from the model with disable-model-invocation: true: hydrogen-skill-loop(-windows), hydrogen-ai-agents-dev, hydrogen-golden-image.
  • 112 AppleDouble ._* files removed from both page repos. 30 of them were being installed as ~/.claude/skills/*/._SKILL.md.

Why it needs a merge, not just an apply. scripts/publish-skills-to-bootstrap.sh refuses to clobber wiki-only lines, so nothing is lost silently. But the next publish will stop until skills/public-facing/ takes these changes. The attached patches use the page-repo layout (skills/<name>/); the repo uses skills/public-facing/{shared,wsl2}/<name>/. The checkout I diffed against (Oct 1) already differed from the wiki on 23 skills. 15 Windows-layer skills (every -windows companion, plus runtime-mode and skill-loop-windows) have no public-facing copy at all, so for them the wiki is the only text.

Related: adom/hydrogen-windows-bootstrap#7 (hydrogen-api ships in both layers with different text).

hydrogen-bootstrap.patch

hydrogen-windows-bootstrap.patch

adom-theme.patch

0 Replies

Log in to reply.