Definitions

{
  "schema_version": 1,
  "type": "skill",
  "slug": "definitions",
  "title": "Definitions",
  "brief": "Use when the user asks \"what is [term]\", \"define [term]\", \"what does [term] mean\", \"glossary\", \"definitions\", or needs clarification on Adom platform terminology.",
  "version": "1.0.0",
  "tags": [],
  "license": "MIT",
  "source_path": "SKILL.md",
  "readme": "# Adom Definitions\n\nCanonical glossary of Adom platform terms. Use these definitions consistently in conversation, code, documentation, and wiki content.\n\n## Core Platform\n\n| Term | Definition |\n|------|-----------|\n| **Adom** | The platform and company. Never say \"Gallia\" or \"Hydrogen\" to users \u2014 those are internal codenames. |\n| **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. |\n| **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 \u2014 each is an AV instance with its own tabs, state, and content. |\n| **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 \u2014 their own tabs, nav history, and dropdown state. The default instance (no param) is the general-purpose AV. |\n| **Panel** | A rectangular area in the Adom App (Workspace) layout \u2014 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. |\n| **AV2** | **DEPRECATED** \u2014 was a second AV on separate ports (8790/8791/8792). Replaced by AV instances: just open another Web View panel pointed at `?instance=<id>`. |\n\n## Views\n\n| Term | Definition |\n|------|-----------|\n| **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 \u2014 each has its own icon, author, and real interactive content. |\n| **View ID** | The short identifier for a View (e.g., SymView, Fp3dView, DkSearch). Used in code and the dropdown. |\n| **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 \u2014 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 \u2014 that's a fake. Use the real app with sample data instead. See av-creator skill Rule #2. |\n| **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. |\n\n## View IDs Reference\n\n| View ID | Name | What it does |\n|---------|------|-------------|\n| SymView | Symbol Creator | Interactive KiCad schematic symbol viewer with hover tooltips |\n| FpView | Footprint Creator | 2D KiCad footprint viewer |\n| Fp3dView | Footprint 3D | 3D Babylon.js pad geometry viewer (from fp-to-3d.js) |\n| 3dView | 3D Component | STEP/GLB 3D model viewer with pad overlays and camera tours |\n| Basic3dView | Basic 3D | Minimal GLB viewer \u2014 renders exactly as-is, no fixups |\n| LibView | Library Review | Three-pane view: symbol + footprint + 3D side by side |\n| SchView | Schematic Creator | Interactive schematic visualization with net highlighting |\n| BoardView | Board Creator | Interactive board layout (2D SVG or 3D GLB) |\n| DkSearch | DigiKey Search | Component search against DigiKey API |\n| MsrSearch | Mouser Search | Component search against Mouser API |\n| JlcSearch | JLCPCB Search | Component search against JLCPCB catalog |\n| DeskConduit | Desktop Conduit | Bridge to user's local desktop (KiCad, Fusion 360, file transfer) |\n| ContConduit | Container Conduit | Manage satellite containers (shell, files, monitoring) |\n| GChat | Google Chat | Send/receive Google Chat messages as Kel |\n| Instruments | Instrument Viewer | Live oscilloscope/DAQ waveform display |\n| InstaPCB | InstaPCB | PCB fabrication quotes and DFM checks |\n| PcbDesign | PCB Design | tscircuit-based PCB design |\n| MovieMaker | Movie Maker | Record narrated video walkthroughs |\n| SkillsMap | Skills Map | Visual map of all available skills |\n| Prefs | Preferences | User preferences for symbol creator etc. |\n\n## Creators and Services\n\n| Term | Definition |\n|------|-----------|\n| **Creator** | A service or skill that generates artifacts (symbols, footprints, 3D models, schematics, boards). |\n| **symbol-creator** | Service at port 8781 that generates .kicad_sym files, metadata, SVG, branded viewer HTML. |\n| **footprint-creator** | Skill that generates .kicad_mod files and viewer HTML. |\n| **fp-to-3d.js** | CLI script that generates Babylon.js 3D pad viewer HTML from .kicad_mod files. |\n| **3dcomponent-creator** | Generates STEP/GLB 3D component models. |\n| **library-creator** | Creates all three artifacts (symbol + footprint + 3D) and shows them in LibView. |\n\n## CLI Tools\n\n| Term | Definition |\n|------|-----------|\n| **adom-cli** | Rust CLI for the Adom platform API \u2014 containers, repos, users, workspaces, SSH keys, orgs. Binary at `/usr/local/bin/adom-cli`. Repo: `adom-inc/adom-cli`. |\n| **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`. |\n| **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`. |\n| **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. |\n\n## URLs\n\n| URL Pattern | What it is |\n|-------------|-----------|\n| `https://hydrogen.adom.inc/{owner}/{repo}` | **Repo page** \u2014 shows repo info, container status, README. Not the editor. |\n| `https://hydrogen.adom.inc/{owner}/{repo}/edit` | **Editor** \u2014 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. |\n| `https://hydrogen.adom.inc/{owner}/{repo}/tree/latest/{path}` | **File browser** \u2014 browse project files in the repo. |\n| `https://hydrogen.adom.inc/{owner}/{repo}/blob/latest/{path}` | **File viewer** \u2014 view a single file in the repo. |\n| `https://coder.{owner}-{repo}-{hash}.containers.adom.inc/` | **Direct container URL** \u2014 raw VS Code in browser, bypasses the Adom App. The hash is assigned by the platform. |\n\n**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.\n\n## Infrastructure\n\n| Term | Definition |\n|------|-----------|\n| **Skill** | A Markdown document (SKILL.md) that teaches Claude Code how to perform a specialized task. Lives in gallia repo, deployed to ~/.claude/skills/. |\n| **Conduit** | WebSocket bridge between containers or between container and desktop. Two types: Desktop Conduit (DeskConduit) and Container Conduit (ContConduit). |\n| **MCP** | Model Context Protocol \u2014 the tool interface that connects Claude to services (viewer, DigiKey, Mouser, etc.). |\n| **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. |\n\n## Coordinate System\n\n| Term | Definition |\n|------|-----------|\n| **Z-up** | Adom 3D convention: Z is always up. Ground plane is XY at z=0. Babylon.js scenes use `zUp: true`. |\n| **KiCad Y flip** | KiCad Y points down; negate Y when converting to Adom 3D coordinates. |\n| **GLB 1000x scale** | glTF uses meters, Adom uses mm. GLB models are scaled 1000x. Overlay meshes need positions multiplied by 1000. |\n\n## Tools & Brand Names\n\nUse these names consistently in conversation, docs, CLI output, and skill files.\n\n| Name | What it is | Notes |\n|------|-----------|-------|\n| **Adom Editor** | The full Hydrogen web app (panels, toolbar, layout) | \"Editor\" always means this. Never call VS Code \"the editor\". |\n| **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). |\n| **AV** | Adom Viewer \u2014 the AI GUI panel | Short form is fine in conversation and code. |\n| **pup** | Puppeteer browser control via Desktop Conduit | Always lowercase. \"Open in pup\", \"pup screenshot\", \"pup reload\". |\n| **shotlog** | Screenshot log viewer and injector | Always lowercase. CLI binary name = `shotlog`. |\n| **adom-vscode** | VS Code extension + CLI for controlling code-server | Hyphenated. CLI binary name = `adom-vscode`. |\n| **adom-cli** | Adom platform CLI (containers, repos, users, workspaces) | Hyphenated. Binary = `adom-cli`. |\n| **SB** | Sandbox panel | User shorthand. \"Show in sb\" = show in the sandbox panel. |\n\n## Internal Names\n\n<!-- NOTE: Customers may see this file. These are listed here so the AI uses\n     the correct public name and avoids leaking internal codenames in\n     conversation, docs, or UI. Do not remove this section \u2014 it prevents\n     the AI from accidentally using internal terminology with users. -->\n\nThe following names are used internally in code, repos, and infrastructure. **Always use the public name** in conversation, documentation, wiki, and anything user-facing.\n\n| Internal Name | Public Name | Where you'll see the internal name |\n|---------------|-------------|-------------------------------------|\n| **Hydrogen** | **Adom Editor** (or just \"Editor\") | Repo paths (`hydrogen.adom.inc`), API endpoints, workspace control skill |\n| **Gallia** | **Adom** | GitHub repo (`adom-inc/gallia`), skill/service source paths |\n| **GV** | **Adom Viewer (AV)** | Old code comments, some variable names |\n| **Carbon** | (no public name \u2014 backend only) | Container registry API (`carbon.adom.inc`), `adom-cli carbon` commands |\n| **code-server** / **Coder** | **VS Code** | Docker infrastructure, server processes, port configs |\n| **conduit** | **Desktop Conduit** or **Container Conduit** | Relay server code, WebSocket bridge internals |",
  "author": {
    "name": "Kyle Bergstedt",
    "email": "[email protected]"
  },
  "visibility": {
    "public": true
  },
  "hero": {
    "type": "image",
    "path": "screenshots/hero-v2.png"
  },
  "sample_prompts": [],
  "discovery_triggers": [],
  "discovery_pitch": null,
  "metadata": {},
  "created_at": "2026-05-28T05:29:58.797Z",
  "updated_at": "2026-05-28T05:29:58.797Z",
  "sub_skills": [],
  "parent_app": null,
  "org": "adom"
}