Adom Hydrogen (platform base)

@@ -0,0 +1,110 @@+---+name: hydrogen-skill-catalog+description: The catalog of skills available to your Claude inside this Hydrogen workspace. Lists every public `hd-*` skill that ships with Hydrogen and explains what each one is for, so you can pick the right skill before doing anything Hydrogen-related. READ THIS FIRST when you're in a fresh Hydrogen workspace and want to know what Claude knows. Trigger words — hd skills, what skills do I have, hd catalog, skill index, skill list, what can claude do in hd, hd-* skills, browser picker, hd setup, hd container info, hd networking, hd volume, hd ports.+---++# Hydrogen Skill Catalog++You're running inside a Hydrogen workspace: the **WSL2 Ubuntu distro+`Adom-Workspace`**. Hydrogen ships a curated catalog of public skills (all+named `hd-*`) so your Claude knows about Hydrogen's own interface, networking, setup+flow, and gotchas. They are BUNDLED into the Hydrogen bootstraps (adom/hydrogen-bootstrap ships the shared/ set, adom/hydrogen-windows-bootstrap the wsl2/ set) and deployed **flat into+`~/.claude/skills/<name>/SKILL.md`** automatically.++## How the catalog is bucketed (and what you actually have)++The public skills live in two buckets in the Hydrogen repo under+`skills/public-facing/`:++- **`shared/`** — topics that do not depend on the workspace's internals.+- **`wsl2/`** — the topics that are specific to the `Adom-Workspace` distro.++The bootstraps deploy both buckets: `shared/` rides adom/hydrogen-bootstrap and the+`wsl2/` set rides adom/hydrogen-windows-bootstrap. You get the whole catalog.++## Shared skills (always present)++| Skill | What it covers |+|-------|----------------|+| `hydrogen-skill-catalog` | This file — read first to know what's available. |+| `hydrogen-golden-image` | Your workspace starts from a PRE-BAKED golden image (v27-full): the Adom toolchain (skills, CLIs, editor extensions) ships INSIDE the tarball; setup converges it to the latest published versions rather than installing from scratch. Read it before claiming what is or is not in the image. |+| `hydrogen-skill-loop` | (Maintainers) The loop to fix a wrong/stale Hydrogen skill: verify vs the live Hydrogen, fix it live, write it back to the repo, bake it into the next image. |+| `hydrogen-who-am-i` | Answer "who am I / what can I do here" — the auto-question Hydrogen injects on first launch. |+| `hydrogen-adom-auth` | Adom login/logout, auth intent flow, session token, profile menu. |+| `hydrogen-claude-auth` | How Claude Code signs in: OAuth via Browser Picker, credential backup, the `claude-auth` step. |+| `hydrogen-api` | Control API reference (`127.0.0.1:47084`). |+| `hydrogen-desktop-sse` | Hydrogen's local workspace API + SSE — adom-cli inside the workspace talks to Hydrogen, not cloud Hydrogen. |+| `hydrogen-monitor` | Watch the workspace in real-time via SSE; composes with Claude's Monitor tool. |+| `hydrogen-ui` | Hydrogen's menus, dialogs, panels, programmatic UI control via CDP, CSS selectors. |+| `hydrogen-open-url` | The decision guide for "open a website": the six ways to open a URL (webview tab, Hydrogen window, Pup, native browser, picker, headless curl) and when to pick each. |+| `hydrogen-browser-picker` | Every URL Hydrogen opens routes through a 5-layer interception into a picker dialog (AI-friendly 5s countdown). |+| `hydrogen-wiki-review` | After editing any wiki.adom.inc page, load it in pup so the user can review the rendered result (don't just report the commit). |+| `hydrogen-claude-management` | First-class API for the Claude conversation tabs: list/open/close/switch, read per-conversation state + on-disk session GUID, type into a SPECIFIC conversation (instant/animated) + submit, and turn on Remote Control for a claude.ai/mobile cloud URL. Address by stable context id. |+| `hydrogen-permissions` | Why mic/camera/clipboard/notifications "just work" — Hydrogen auto-grants WebView2 permissions, so webview apps see no Allow prompts. |+| `hydrogen-adom-bridge` | What Hydrogen and Adom Bridge (ab) are + how they work together — ab is your reach onto the user's real OS (create files/folders, run shell, OS screenshots, launch apps, browsers, KiCad/Fusion). |+| `hydrogen-bridges` | Built-in KiCad/Fusion/Puppeteer bridges + extensible wiki catalog (e.g. Blender) + full ab capability list (usb, caption, record…). |+| `hydrogen-eval` | Inject JS into ANY Hydrogen surface (shell/workbench/wiki/Claude) via POST /eval-in; build add-ons, overlays, highlights. |+| `hydrogen-adom-menu` | The upper-left Adom logo menu: Settings, Ports, API Explorer, Doctor, Run Wake Check, DevTools, Setup Steps, Virgin Reset, About dialog, version readout. |+| `hydrogen-doctor` | The Doctor (Adom menu + GET/POST /doctor): 18 end-to-end health checks with plain-English hover explanations, a safe one-click fix, and a confirm-gated workspace restart. |+| `hydrogen-key-values` | The user's cloud KV store (hydrogen.* / bridge.* keys): read/write API, conventions (no secrets, scalar values), runtime-discovery entries, and the profile-menu viewer. |+| `hydrogen-settings` | Hydrogen's Settings dialog + the full preferences tree (theme, vim mode, 3D control style, launch-on-boot, ab window behavior). |+| `hydrogen-dock` | The app launcher rail: the adom-curated global list + user-added wiki apps, the dock block apps declare so Hydrogen can launch them, and the free orbital loading screen. |+| `hydrogen-file-transfer` | Move files BOTH ways between the WSL2 workspace and the Windows PC (/mnt/c, \\wsl$, adom-bridge relay). |+| `hydrogen-tab-icons` | Webview tab icon customization (displayIcon API, brand colors, MDI/SVG). |+| `hydrogen-profile-menu` | The avatar dropdown: profile/repos/molecules links and logout. |+| `hydrogen-embedded-ad` | Hydrogen ↔ Adom Bridge embedded mode: tray, hidden ab, footer pill. |+| `hydrogen-self-screenshot` | How Claude screenshots Hydrogen panels + any host window (window control, multi-monitor), ralph loops, resize-before-Read rule. |+| `hydrogen-capture-share` | The screen-share + "AI wants access" approval + countdown the AI triggers to capture the editor; tab/screen scopes, Webview/Pup window mode. |+| `hydrogen-recording` | Record screen/window — Hydrogen's NATIVE WGC/DXGI recorder (h264/h265 mp4 → `recordings/`, no picker/banner, "record kicad"/"record whole screen", max-duration cap), plus ab desktop recording + the tab-vs-desktop footgun. |+| `hydrogen-screen-lock` | Hydrogen screen capture and the display wake-lock: Hydrogen's native screenshots (CDP) + recording (WGC/DXGI) hold NO wake-lock, so Hydrogen has no burn-in leak; the cap + "● Recording" indicator; `powercfg /requests` to diagnose. |+| `hydrogen-notifications` | Reach the user — OS Windows toasts + emergency taskbar flash via `notify_user`, AND the in-app `POST /ui/toast` (toast inside the Hydrogen window). |+| `hydrogen-captions` | Paint labeled text on the user's screen — a Win32 always-on-top caption overlay for demos / step callouts. |+| `hydrogen-welcome` | The static welcome page shown after setup completes. |+| `hydrogen-overview` | Master skill index, grouped by category. |++## Workspace skills (the `wsl2/` bucket)++| Skill | What it covers |+|-------|----------------|+| `hydrogen-container` | This workspace's spec — Ubuntu 24.04, code-server 4.112.0, what's pre-installed, env vars. |+| `hydrogen-topology` | The three layers and how commands route to reach the workspace. |+| `hydrogen-networking` | Port architecture, hostnames, code-server proxy, host access, NEVER-do-these rules. |+| `hydrogen-ports` | Forwarding workspace services to Windows. |+| `hydrogen-port-watcher` | The dynamic port-forward daemon for extension OAuth callbacks. |+| `hydrogen-volume` | Where your code lives, what persists, what a reset wipes, how to copy files out. |+| `hydrogen-container-stats` | The title-bar CPU/RAM indicator and how its stats are gathered. |+| `hydrogen-setup` | The setup panel UI — Run All, Rollback, Virgin Reset toggles. |+| `hydrogen-setup-steps` | What each setup step did to tool your workspace. |+| `hydrogen-workspace-lifecycle` | Starting, stopping, restarting and repairing the `Adom-Workspace` distro. |+| `hydrogen-workspace-monitoring` | Frontend monitoring of the workspace distro's health. |+| `hydrogen-wake-repair` | Recovering the workspace after the laptop sleeps or wakes. |++## What's NOT in your workspace — internal dev skills++The Hydrogen repo also has skills under `skills/dev-internal-facing/` (hydrogen-debug, hydrogen-dev,+hydrogen-pitfalls, hydrogen-settings, an internal hydrogen-setup-steps deep-dive,+hydrogen-vm-test, and more). These are **Adom-employee-only development skills** — Hydrogen+build pipeline, debugging the Tauri/WebView2 source, internal architecture,+postmortems. They live in the Hydrogen repo but are **NEVER** deployed to user+workspaces.++The split is enforced by the bootstrap bundling, which only ships+`skills/public-facing/{shared,wsl2}/hd-*/` — never `dev-internal-facing/`.++| Folder | Audience | Deployed to user workspaces? |+|--------|----------|------------------------------|+| `public-facing/shared/` | End users of Hydrogen | **Yes** |+| `public-facing/wsl2/` | End users of Hydrogen | **Yes** |+| `dev-internal-facing/` | Adom employees who develop Hydrogen | **No** (repo-only) |++## How to use this catalog++1. In a fresh Hydrogen workspace, scan this table for the most relevant `hd-*` skill+   before answering an Hydrogen-related question.+2. Skill descriptions are loaded automatically by skill-pilot at session start.+3. If a topic seems missing, it may be a dev-internal-facing skill (repo-only) —+   ask the user to check the Hydrogen repo.++## When skills get refreshed++Skills are deployed by the bootstrap postinstall at install/bake time. To refresh after a skills change, the workspace picks up new bootstrap versions via `adom-wiki pkg update` (the `adom/hook` prompt hook) — or a fresh golden image. There is no `install-hd-skills` setup step (removed).