!
Not installable via adompkg
This skill has no published release. adompkg install kyle/definitions
will not work until a maintainer publishes a tarball with install.sh and uninstall.sh.
See the publishing docs for the package.json schema and
tarball layout required to ship this skill.
Adom Definitions
Canonical glossary of Adom platform terms. Use these definitions consistently in conversation, code, documentation, and wiki content.
Core Platform
| Term |
Definition |
| Adom |
The platform and company. Never say "Gallia" or "Hydrogen" to users — those are internal codenames. |
| Adom App (aka Workspace) |
The full web app: toolbar, panels, VS Code, profile, workcell picker. Internal codename "Hydrogen". "Workspace" emphasizes the persistent panel layout stored in Docker container layout files. |
| Adom Viewer (AV) |
The AI GUI panel inside the Adom App. Internal codename was "Gallia Viewer (GV)". This is where Views live. A single AV server (port 8770) can serve multiple independent AV panels — each is an AV instance with its own tabs, state, and content. |
| AV Instance |
A single AV panel running inside a Web View panel. Each instance has a unique ID passed via URL param (?instance=<id>). Instances are independent — their own tabs, nav history, and dropdown state. The default instance (no param) is the general-purpose AV. |
| Panel |
A rectangular area in the Adom App (Workspace) layout — like a window pane. Each panel has a tab with a name and icon. Panels can be split, resized, moved, and closed. Types include VS Code, Web View, 3D Viewer, Schematic Editor, cameras, sensors, etc. AV runs inside a Web View panel. |
| AV2 |
DEPRECATED — was a second AV on separate ports (8790/8791/8792). Replaced by AV instances: just open another Web View panel pointed at ?instance=<id>. |
Views
| Term |
Definition |
| View |
A mini-app/tab inside AV. Each View has a View ID (e.g., SymView, FpView). Views are like apps on a desktop OS — each has its own icon, author, and real interactive content. |
| View ID |
The short identifier for a View (e.g., SymView, Fp3dView, DkSearch). Used in code and the dropdown. |
| real-view |
A keyword and enforcement rule meaning: always use the ACTUAL running view/app, never a fake mockup, placeholder, or approximation. This applies everywhere — dropdown landing pages, wiki submissions, demos, screenshots. If you're about to create an HTML page that looks like a view but isn't the real app, STOP — that's a fake. Use the real app with sample data instead. See av-creator skill Rule #2. |
| fake-view |
Any static SVG/HTML/screenshot that approximates a real view but doesn't run the actual app code. Fake-views are BANNED. Examples: a hand-drawn SVG of a symbol instead of loading the real symbol viewer; a placeholder with "Ask Claude to..." text; a generated mockup that looks similar to the real thing. |
View IDs Reference
| View ID |
Name |
What it does |
| SymView |
Symbol Creator |
Interactive KiCad schematic symbol viewer with hover tooltips |
| FpView |
Footprint Creator |
2D KiCad footprint viewer |
| Fp3dView |
Footprint 3D |
3D Babylon.js pad geometry viewer (from fp-to-3d.js) |
| 3dView |
3D Component |
STEP/GLB 3D model viewer with pad overlays and camera tours |
| Basic3dView |
Basic 3D |
Minimal GLB viewer — renders exactly as-is, no fixups |
| LibView |
Library Review |
Three-pane view: symbol + footprint + 3D side by side |
| SchView |
Schematic Creator |
Interactive schematic visualization with net highlighting |
| BoardView |
Board Creator |
Interactive board layout (2D SVG or 3D GLB) |
| DkSearch |
DigiKey Search |
Component search against DigiKey API |
| MsrSearch |
Mouser Search |
Component search against Mouser API |
| JlcSearch |
JLCPCB Search |
Component search against JLCPCB catalog |
| DeskConduit |
Desktop Conduit |
Bridge to user's local desktop (KiCad, Fusion 360, file transfer) |
| ContConduit |
Container Conduit |
Manage satellite containers (shell, files, monitoring) |
| GChat |
Google Chat |
Send/receive Google Chat messages as Kel |
| Instruments |
Instrument Viewer |
Live oscilloscope/DAQ waveform display |
| InstaPCB |
InstaPCB |
PCB fabrication quotes and DFM checks |
| PcbDesign |
PCB Design |
tscircuit-based PCB design |
| MovieMaker |
Movie Maker |
Record narrated video walkthroughs |
| SkillsMap |
Skills Map |
Visual map of all available skills |
| Prefs |
Preferences |
User preferences for symbol creator etc. |
Creators and Services
| Term |
Definition |
| Creator |
A service or skill that generates artifacts (symbols, footprints, 3D models, schematics, boards). |
| symbol-creator |
Service at port 8781 that generates .kicad_sym files, metadata, SVG, branded viewer HTML. |
| footprint-creator |
Skill that generates .kicad_mod files and viewer HTML. |
| fp-to-3d.js |
CLI script that generates Babylon.js 3D pad viewer HTML from .kicad_mod files. |
| 3dcomponent-creator |
Generates STEP/GLB 3D component models. |
| library-creator |
Creates all three artifacts (symbol + footprint + 3D) and shows them in LibView. |
CLI Tools
| Term |
Definition |
| adom-cli |
Rust CLI for the Adom platform API — containers, repos, users, workspaces, SSH keys, orgs. Binary at /usr/local/bin/adom-cli. Repo: adom-inc/adom-cli. |
| adom-vscode |
Rust CLI + VS Code extension for controlling code-server from Docker processes. Opens files, reveals in explorer, searches/installs extensions, starts Claude Code chats, switches UI modes. Extension runs HTTP server on port 8821. Binary at /usr/local/bin/adom-vscode. Repo: adom-inc/adom-vscode. |
| shotlog |
Rust CLI + HTTP server for chronological screenshot logging. Supports multiple named channels, clipboard paste with auto-resize, real-time WebSocket updates. Server on port 8820. Binary at /usr/local/bin/shotlog. |
| pup |
Puppeteer browser control via Desktop Conduit. Opens/closes Chrome windows, reloads pages, takes screenshots, evaluates JS, flashes taskbar alerts. Commands run via adom-desktop browser_*. Always lowercase. |
URLs
| URL Pattern |
What it is |
https://hydrogen.adom.inc/{owner}/{repo} |
Repo page — shows repo info, container status, README. Not the editor. |
https://hydrogen.adom.inc/{owner}/{repo}/edit |
Editor — the full Adom App (Workspace) with panels, VS Code, AV, toolbar. This is what users open to work in their container. Always add /edit to get into the editor. |
https://hydrogen.adom.inc/{owner}/{repo}/tree/latest/{path} |
File browser — browse project files in the repo. |
https://hydrogen.adom.inc/{owner}/{repo}/blob/latest/{path} |
File viewer — view a single file in the repo. |
https://coder.{owner}-{repo}-{hash}.containers.adom.inc/ |
Direct container URL — raw VS Code in browser, bypasses the Adom App. The hash is assigned by the platform. |
Key distinction: /{owner}/{repo} is the repo page. /{owner}/{repo}/edit is the editor (Adom App / Workspace). Always use /edit when you want users to actually work in the container.
Infrastructure
| Term |
Definition |
| Skill |
A Markdown document (SKILL.md) that teaches Claude Code how to perform a specialized task. Lives in gallia repo, deployed to ~/.claude/skills/. |
| Conduit |
WebSocket bridge between containers or between container and desktop. Two types: Desktop Conduit (DeskConduit) and Container Conduit (ContConduit). |
| MCP |
Model Context Protocol — the tool interface that connects Claude to services (viewer, DigiKey, Mouser, etc.). |
| Sample data |
Pre-generated real view HTML files in viewer/samples/ used for dropdown landing pages. Ensures real-view compliance when no user data is available. |
Coordinate System
| Term |
Definition |
| Z-up |
Adom 3D convention: Z is always up. Ground plane is XY at z=0. Babylon.js scenes use zUp: true. |
| KiCad Y flip |
KiCad Y points down; negate Y when converting to Adom 3D coordinates. |
| GLB 1000x scale |
glTF uses meters, Adom uses mm. GLB models are scaled 1000x. Overlay meshes need positions multiplied by 1000. |
Tools & Brand Names
Use these names consistently in conversation, docs, CLI output, and skill files.
| Name |
What it is |
Notes |
| Adom Editor |
The full Hydrogen web app (panels, toolbar, layout) |
"Editor" always means this. Never call VS Code "the editor". |
| VS Code |
The code IDE running inside the Docker container, powered by Coder's code-server |
Primary name. Embedded as an iframe panel in the Adom Editor, or accessed directly via https://<slug>.adom.cloud/?folder=.... Synonyms to avoid in user-facing contexts: "code-server", "coder", "Coder.com". Use those only when discussing internals or infrastructure. Never call it "the editor" (that's Hydrogen). |
| AV |
Adom Viewer — the AI GUI panel |
Short form is fine in conversation and code. |
| pup |
Puppeteer browser control via Desktop Conduit |
Always lowercase. "Open in pup", "pup screenshot", "pup reload". |
| shotlog |
Screenshot log viewer and injector |
Always lowercase. CLI binary name = shotlog. |
| adom-vscode |
VS Code extension + CLI for controlling code-server |
Hyphenated. CLI binary name = adom-vscode. |
| adom-cli |
Adom platform CLI (containers, repos, users, workspaces) |
Hyphenated. Binary = adom-cli. |
| SB |
Sandbox panel |
User shorthand. "Show in sb" = show in the sandbox panel. |
Internal Names
The following names are used internally in code, repos, and infrastructure. Always use the public name in conversation, documentation, wiki, and anything user-facing.
| Internal Name |
Public Name |
Where you'll see the internal name |
| Hydrogen |
Adom Editor (or just "Editor") |
Repo paths (hydrogen.adom.inc), API endpoints, workspace control skill |
| Gallia |
Adom |
GitHub repo (adom-inc/gallia), skill/service source paths |
| GV |
Adom Viewer (AV) |
Old code comments, some variable names |
| Carbon |
(no public name — backend only) |
Container registry API (carbon.adom.inc), adom-cli carbon commands |
| code-server / Coder |
VS Code |
Docker infrastructure, server processes, port configs |
| conduit |
Desktop Conduit or Container Conduit |
Relay server code, WebSocket bridge internals |